PSP Webhooks

Apibanking ofrece un conjunto de operaciones que las PSP pueden integrar para gestionar sus servicios. Todas las operatorias se procesan de forma asíncrona, lo que significa que la ejecución inicial del servicio solo confirma la aceptación de la solicitud. Una vez procesada la operación, Apibanking envía notificaciones vía Webhooks para informar el resultado y cualquier evento relacionado con cuentas CVU de la PSP.

Consideraciones importantes

• Las notificaciones pueden involucrar múltiples tipos de operaciones.
• Cada notificación incluye Tipo (campo operation.type) y Subtipo (campo operation.sub_type) de operación, que la PSP debe interpretar para determinar el contexto.
• Es obligatorio que la PSP exponga los Webhooks mencionados para recibir estas notificaciones.

Tipos de notificaciones

Créditos en CVU

• Webhook: POST /v1/notifications/cvu/credit-received
• Descripción: Notifica la acreditación de fondos en una CVU.

Débitos Pendientes en CVU

• Webhook: POST /v1/notifications/cvu/debit-pending
• Descripción: Informa débitos pendientes en una CVU (incluye Transferencias Pull).

Resultado de Operación

• Webhook: POST /v1/notifications/psp/operation-result
• Descripción: Comunica el resultado final de operaciones en las que participa la PSP.

Contracargo de Transferencia Pull

• Webhook: POST /v1/notifications/cvu/transfer/pull/chargeback
• Descripción: Notifica la ejecución de un contracargo sobre una Transferencia Pull.

Aviso Adhesión Recurrencia Programado

• Webhook: POST /v1/notifications/psp/adhesion/scheduled/debin
• Descripción: Aviso de solicitud de adhesion a debin programado, bajo una recurrencia (prestación) específica. En caso de no recibir la notificación, la PSP debe consultar el estado de adhesión a través del endpoint de contingencia.

Configuraciones necesarias

Cada webhook debe incluir:

• Headers: Autenticación con API Key para validar origen.
• Respuesta esperada: HTTP 200 OK para confirmar recepción.