Solicitudes de Pago
Las Solicitudes de Pago te permiten crear URLs únicas para recibir pagos de tus clientes mediante el External API.
¿Qué es una Solicitud de Pago?
Sección titulada «¿Qué es una Solicitud de Pago?»Una Solicitud de Pago es una URL única que puedes compartir con tus clientes para que realicen un pago. Cada enlace contiene:
- Monto a cobrar
- Moneda del pago
- Descripción del concepto
- Fecha de expiración automática
Casos de Uso
Sección titulada «Casos de Uso»- Facturas: Envía enlaces de pago junto con tus facturas
- Ventas por redes sociales: Comparte enlaces en WhatsApp, Instagram, etc.
- Integraciones: Genera enlaces desde tu sistema ERP o CRM
- E-commerce: Integra pagos sin checkout completo
Estados de la Solicitud de Pago
Sección titulada «Estados de la Solicitud de Pago»| Estado | Descripción |
|---|---|
active | El enlace está disponible para recibir pagos |
completed | El pago fue realizado exitosamente |
cancelled | El enlace fue cancelado manualmente |
expired | El enlace expiró sin recibir pago |
Permisos Requeridos (Abilities)
Sección titulada «Permisos Requeridos (Abilities)»Para trabajar con Solicitudes de Pago, tu API Key necesita los siguientes abilities:
| Operación | Ability |
|---|---|
| Crear | payment_links:create |
| Consultar | payment_links:read |
| Cancelar | payment_links:cancel |
URL Base
Sección titulada «URL Base»Todos los endpoints de Solicitudes de Pago utilizan la siguiente URL base:
https://api.aloha.co/api/external/v1/payment-linksEndpoints Disponibles
Sección titulada «Endpoints Disponibles»| Método | Endpoint | Descripción |
|---|---|---|
POST | /v1/payment-links | Crear una nueva solicitud de pago |
GET | /v1/payment-links/{id} | Obtener detalles de una solicitud de pago |
DELETE | /v1/payment-links/{id} | Cancelar una solicitud de pago activa |
Pruebas en Sandbox
Sección titulada «Pruebas en Sandbox»Chile (WebPay)
Sección titulada «Chile (WebPay)»Para pagar con WebPay en Sandbox usa estas tarjetas de prueba:
| Tarjeta | Número | CVV | Expiración | Resultado |
|---|---|---|---|---|
| VISA | 4051 8856 0044 6623 | 123 | Cualquiera | Aprobada |
| AMEX | 3700 0000 0002 032 | 1234 | Cualquiera | Aprobada |
| MASTERCARD | 5186 0595 5959 0568 | 123 | Cualquiera | Rechazada |
| Redcompra | 4051 8842 3993 7763 | — | — | Aprobada (operaciones que permiten débito Redcompra) |
| Redcompra | 4511 3466 6003 7060 | — | — | Aprobada (operaciones que permiten débito Redcompra) |
| Redcompra | 5186 0085 4123 3829 | — | — | Rechazada (operaciones que permiten débito Redcompra) |
| Prepago VISA | 4051 8860 0005 6590 | 123 | Cualquiera | Aprobada |
| Prepago MASTERCARD | 5186 1741 1062 9480 | 123 | Cualquiera | Rechazada |
Si aparece un formulario de autenticación con RUT y clave, usa el RUT 11.111.111-1 y la clave 123.
Colombia (Bancolombia)
Sección titulada «Colombia (Bancolombia)»Para pagar con Bancolombia en Sandbox no necesitas datos de prueba. Al elegir Bancolombia se abre una pantalla de pruebas de Bancolombia: haz clic en aprobar el pago y la transacción queda aprobada.
Próximos Pasos
Sección titulada «Próximos Pasos»- Crear Solicitud de Pago - Genera un nuevo enlace de pago
- Obtener Solicitud de Pago - Consulta los detalles de un enlace
- Cancelar Solicitud de Pago - Cancela un enlace activo