Cada cambio de estado llega como un evento firmado. Nadie consulta en bucle.
Webhooks notifica a los sistemas del PSP y de sus clientes cuando algo relevante ocurre: una operación se aprobó, una transacción se confirmó o se rechazó, un archivo terminó de procesarse, un periodo quedó conciliado. Eventos firmados, con reintentos y registro de entrega.
Para el negocio
- Tus clientes se enteran de inmediato, sin llamar a tu operación.
- Procesos aguas abajo (contabilidad, ERP, notificaciones) se disparan solos.
- Menos soporte de "¿en qué va mi pago?".
Para tu equipo técnico
- Firma HMAC con marca de tiempo; verificación documentada.
- Reintentos con espera creciente y registro de cada intento; reenvío manual o por API.
- Suscripciones por tipo de evento, por cliente y por ambiente.
Capacidades
- Catálogo de eventos por módulo
- Suscripciones configurables
- Firma y verificación
- Reintentos y registro de entrega
- Reenvío
- Eventos hacia la capa de conectividad local
Puntos de integración
Lo que este módulo expone para que el PSP conecte sus sistemas y su capa de adaptación local.
- Eventos salientes a clientes del PSP
- Eventos internos hacia la adaptación local (por ejemplo, operación lista para ejecutar en un riel)
- Eventos entrantes: resultados reportados por la capa local
POST https://psp.example/webhooks/integra
X-Integra-Signature: t=1758037331,v1=6d1f…
{
"id": "evt_01J9K5",
"type": "transaction.confirmed",
"data": {
"transaction_id": "txn_01J9K4",
"operation_id": "op_01J9K3Q8X2",
"rail": "psp-local:bank-transfer",
"rail_reference": "…",
"amount": 1850000, "currency": "COP"
}
} Cómo encaja
Módulos con los que este trabaja directamente.
APIs
Integración, automatización y comunicación con los sistemas del PSP y de sus clientes.
Ver móduloOperaciones
Workflows, estados, aprobaciones y monitoreo de todo lo que el PSP ejecuta.
Ver móduloTransacciones
Creación, procesamiento, estados, trazabilidad e historial de cada transacción.
Ver móduloConstruye y opera tu PSP sobre Integra.
Cuéntanos qué operas hoy y qué rieles necesitas conectar. Te mostramos la plataforma sobre tu caso.