Productos / Webhooks

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
Evento: transacción confirmadaIlustrativo · evento
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"
  }
}

Construye y opera tu PSP sobre Integra.

Cuéntanos qué operas hoy y qué rieles necesitas conectar. Te mostramos la plataforma sobre tu caso.