Visión general
La pasarela permite a un comercio cobrar con un link de pago. El pagador abre ese link en una página de pago hospedada por la pasarela y elige un medio de pago; el resultado llega a la pasarela y esta lo notifica al comercio por webhook firmado.
Medios de pago
| Medio | Valor (accepted_payment_methods) | Quién procesa | Cómo se confirma |
|---|---|---|---|
| Tarjeta de crédito/débito | card | Akua (checkout embebido) | Webhook de Akua |
| PSE | pse | Akua (el pagador es redirigido a su banco) | Webhook de Akua; el pagador vuelve a una página de resultado |
| Cuenta Crezcamos | cuentas_crezcamos | Mo$i (app) | Webhook entrante del proveedor |
| Bre-B | bre_b | App de Bre-B | Webhook entrante del proveedor |
Mo$i y Bre-B se integran como proveedores de medio de pago: son terceros que conectan su aplicación al checkout y confirman el pago. Ver Proveedores de medios de pago.
Qué puede hacer hoy un tercero
| Quiero… | ¿Existe? | Dónde |
|---|---|---|
| Crear, listar, consultar y revocar links de pago | Sí | Crear links |
| Recibir el resultado de cada pago | Sí, por webhook | Webhooks |
| Verificar que un webhook es auténtico | Sí | Verificar la firma |
| Rotar mis credenciales y gestionar IP permitidas | Sí | Autenticación |
| Crear o consultar un pago directamente por API | No (el pago nace en la página de pago) | Huecos conocidos |
Reintentar una creación sin duplicar (Idempotency-Key) | No en la API pública | Límites |
| Un sandbox hospedado para pruebas | No (hay un entorno local) | Entorno local |
Principios
- El resultado de un pago llega por webhook, no por el navegador. Que el pagador vuelva a una página no confirma nada.
- Entrega al menos una vez. Un mismo evento puede llegar repetido y fuera de orden; ver Webhooks.
- JSON:API. Las respuestas y los errores siguen
application/vnd.api+json.