Catálogo de eventos
Eventos que recibe el comercio
type | Cuándo | payment.status típico |
|---|---|---|
payment.approved | Pago aprobado | paid |
payment.rejected | Pago rechazado o fallido | failed |
payment.in_review | En revisión o pendiente | in_review |
payment.refunded | Reembolso | refunded |
payment.chargeback | Contracargo | in_review |
Estructura, cabeceras y reintentos: webhooks. Firma: verificar la firma.
Se filtran con events al registrar el webhook: lista vacía o "*" = todos, "payment.*" = por prefijo, valor exacto = solo ese.
Eventos entrantes a la pasarela (de los proveedores)
| Origen | Ruta | Autenticación |
|---|---|---|
| Akua (tarjeta, PSE) | POST /webhooks/akua/payments y variantes payment-approved, payment-rejected, payment-failed, payment-refund, payment-chargeback | Firma HMAC (akua-wh-id, akua-wh-timestamp, akua-wh-signature) |
| Crezcamos (Cuenta Crezcamos, Bre-B, PSE de Crezcamos) | POST /webhooks/crezcamos/pse-payments | Cabecera X-Crezcamos-Webhook-Secret |
Los eventos de Akua que entiende la pasarela son payment.purchase.pending, payment.purchase.succeeded, payment.purchase.rejected y payment.purchase.failed. El del proveedor Crezcamos se describe en webhook de confirmación.