Appearance
PSP Webhooks
Débitos Pendientes en CVU
Esta notificación es un aviso de que se recibió una solicitud de débito en una CVU de la PSP. Ante estas notificaciones, la PSP debe responder si acepta o rechaza el débito en la CVU a través del servicio POST /v1/cvu/operations/debit/confirm
En el detalle de esta notificación se encuentran los datos de las partes involucradas, el tipo de operación al que corresponde, la moneda y las fechas de la operación, entre otros (Para mas detalle acerca de los campos dirigirse a la definicion del schema del 'Request cuerpo' de la documentación del webook POST /v1/notifications/cvu/debit-pending).
Importante:
Estas notificaciones deben ser procesadas y respondidas mediante el endpoint POST /v1/cvu/operations/debit/confirm en un tiempo determinado dependiendo del tipo de operación. Se recomienda revisar los tiempos máximos de respuesta a esta notificación en la documentación especifica de cada tipo de operación.
Tipos de operaciones
A continuación se detallan todas las operaciones por las cuales se puede recibir un aviso de Débito Pendiente en una CVU.
- El tipo de operación se indica en el campo operation.type del cuerpo de la notificación.
- El sub-tipo de operación se indica en el campo operation.sub_type del cuerpo de la notificación.
| Tipo de operación | Sub-tipo de operación | Descripción |
|---|---|---|
TRANSFER_PULL | TACIT | Débito por Transferencia Pull ejecutada en una CVU de la PSP con consentimiento Tácito. |
TRANSFER_PULL | EXPLICIT | Débito por Transferencia Pull ejecutada en una CVU de la PSP con consentimiento Explícito. |
DEBIN | SPOT | Débito por Debin Spot en una CVU de la PSP. |
DEBIN | FCEM | Débito por Debin FCEM en una CVU de la PSP. |
DEBIN | SCHEDULED | Débito por Debin Programado en una CVU de la PSP. |
DEBIN | RECURRENT | Débito por Debin Recurrente en una CVU de la PSP. |
DEBIN | RECURRENT_FCEM | Débito por Debin Recurrente FCEM en una CVU de la PSP. |
DEBIN | RECURRENT_INMEDIATE_DIRECT_DEBIT | Débito por Debin Recurrente con debito inmediato directo en una CVU de la PSP. |
Notificación de débito pendiente en CVU
POST
/v1/notifications/cvu/debit-pending
Webhook donde la PSP recibirá todas las notificaciones sobre las solicitudes de débitos pendientes en sus CVUs. Los débitos pueden corresponder a distintos tipos de operaciones.
Autorizaciones
apiKeyAuth
Tipo
API Key (header: X-API-KEY)
Parámetros
Header Parameters
x-api-key*
ApiKey de autenticación para envío de notificaciones
Tipo
Requeridostring
Ejemplo
"093891f5512c"Cuerpo de la petición
application/json
Notificación de débito recibido en CVU por una operación desde otra CVU
JSON "notification_id": "52689bfd-1f62-4656-99d2-ac4e87901ef3", "notification_date": "2025-10-22T10:56:01.000-03:00", "operation": { "id": "V8D0Q619LZDW1OVN7JZ5RG", "type": "TRANSFER_PULL", "sub_type": "TACIT" }, "details": { "amount": 1500.75, "expiration_date": "2025-10-22T10:54:50.4101687-03:00", "operation_date": "2025-10-22T10:54:35.000-03:00", "currency_code": "ARS", "concept_code": "VAR", "description": "Débito por Transferencia Pull" }, "credit": { "account": { "owner": { "name": "Banco SRL", "cuit": "30707403205" }, "bank_id": "299", "cbu": "2990000000002045180006" }, "virtual_account": { "owner": { "name": "Juan Carlos", "cuit": "220346579879" }, "psp_id": "1774", "cvu": "0001774300600100000900" } }, "debit": { "account": { "owner": { "name": "Plataforma Virtual SRL", "cuit": "30724105394" }, "bank_id": "344", "cbu": "3440098709800057320004" }, "virtual_account": { "owner": { "name": "Sofia Gomez", "cuit": "23244825664" }, "psp_id": "548", "cvu": "0000548700333021021557" } }
{
}
Respuestas
Respuesta de confirmación de recepción de la notificación
application/json
JSON "message": "Notification received successfully"
{
}