Appearance
Transferencia Pull - Flujos de Operación
A continuación se detallan los casos de uso para cada Flujo de Operación de Transferencias Pull segun el Rol de la PSP.
☰ Índice
Rol Crédito
Flujo de Generación de Transferencia Pull
Este servicio permite que las CVUs de la PSP soliciten fondos desde otras cuentas del mismo titular (CBU o CVU). Para operar, la PSP debe integrar los siguientes componentes:
APIs
Ejecutar de Transferencia Pull
- Endpoint: POST /v1/transfers/pull
- Función: Inicia la solicitud de fondos hacia la CVU.
- Más información: Ver documentación del servicio Generación de Transferencias Pull.
Webhooks
Notificación de Crédito por Transferencia Pull
- Webhook: POST /v1/notifications/cvu/credit-received
- Función: Informa que se acreditaron fondos en una CVU de la PSP para que la misma concilie el movimiento.
- Detalle: Incluye datos de las partes, tipo, moneda y fechas de la operación.
- Tipo de operación: Para Transferencias Pull se indican los siguientes tipos de operación en el campo
operation.typedel cuerpo de la notificación:
| Tipo de operación | Descripción |
|---|---|
TRANSFER_PULL | Crédito por Transferencia Pull en una CVU de la PSP |
- Más información: Ver documentación Créditos en CVU
Notificación de Finalización de Transferencia Pull (Crédito)
- Webhook: POST /v1/notifications/psp/operation-result
- Función: Indica el resultado final de la operación (éxito o error).
- Detalle: Incluye datos de las partes, tipo, moneda y fechas de la operación.
- Tipo de operación: Para Transferencias Pull se indican los siguientes tipos y sub-tipos de operación en el campo
operation.typedel cuerpo de la notificación:
| Tipo de operación | Descripción |
|---|---|
TRANSFER_PULL | Débito por Transferencia Pull ejecutada en una CVU de la PSP con consentimiento Tácito. |
- Más información: Ver documentación Resultado de Operación
Diagramas de Sequencia
Caso exitoso
Caso erróneo
Flujo de Contracargo recibido por Transferencia Pull
Esta notificación se recibe cuando el titular de una CVU de la PSP inicia el Contracargo, desde la cuenta de débito, de una Transferencia Pull previamente ejecutada. Esto implica que se ejecutará un débito en la cuenta recaudadora de la PSP y se debe conciliar ese movimiento dentro del saldo de la CVU. Para contemplar este flujo, la PSP debe integrar los siguientes componentes:
Webhooks
Notificación de Contracargo de Transferencia Pull
- Webhook: POST /v1/notifications/cvu/transfer/pull/chargeback
- Función: Informa que se solicitó el Contracargo de una Transferencia Pull previamente ejecutada.
- Detalle: Incluye datos de la operación original, partes, tipo, moneda y fechas de la operación.
- Tipo de operación: Para Contracargo de Transferencias Pull se indican los siguientes tipos de operación en el campo
operation.typedel cuerpo de la notificación:
| Tipo de operación | Descripción |
|---|---|
TRANSFER_PULL_CHARGEBACK | Contracargo por Transferencia Pull |
- Más información: Ver documentación Aviso Contracargo de Transferencia Pull
Notificación de Finalización de Contracargo de Transferencia Pull
- Webhook: POST /v1/notifications/psp/operation-result
- Función: Indica el resultado final de la operación de Contracargo por Transferencia Pull por un error ocurrido.
- Detalle: Incluye datos de las partes, tipo, moneda y fechas de la operación.
- Tipo de operación: Para Contracargo Transferencias Pull se indican los siguientes tipos y sub-tipos de operación en el campo
operation.typedel cuerpo de la notificación:
| Tipo de operación | Descripción |
|---|---|
TRANSFER_PULL_CHARGEBACK | Aviso de Contracargo por Transferencia Pull |
- Más información: Ver documentación Resultado de Operación
Procedimiento
- Entidad Débito: Solicita el Contracargo de una Transferencia Pull ejecutada por la PSP.
- Comafi Apibanking: Envía la notificación de Aviso de Contracargo a la PSP en el Webhook POST /v1/notifications/cvu/transfer-pull/chargeback.
- PSP: La PSP confirma la recepción de la notificación
- Comafi Apibanking: Ejecuta un débito por Contracargo en la cuenta recaudadora de la PSP
- Comafi Apibanking: Envía los fondos a la Entidad Débito
Diagramas de Sequencia
Caso exitoso
Caso erróneo
Rol Débito
Flujo de Recepción de Transferencia Pull
En esta operatoria, la PSP recibe solicitudes de Transferencia Pull en sus cuentas CVU. Estas solicitudes implican que otra entidad (Entidad Crédito) solicita fondos desde la CVU de la PSP. La PSP debe procesar la notificación y responder en tiempo real indicando si acepta o rechaza el débito.
La PSP debe integrar los siguientes componentes:
APIs
Confirmar débito en CVU
- Endpoint: POST /v1/cvu/operations/debit/confirm
- Función: Confirmar o rechazar la solicitud de débito recibida.
- Más información: Ver documentación del servicio Generación de Transferencias Pull.
- Tiempo máximo de respuesta: 3 segundos desde la recepción de la notificación de débito pendiente (POST /v1/notifications/cvu/debit-pending).
Webhooks
Notificación de Débito de Pendiente en CVU
- Webhook: POST /v1/notifications/cvu/debit-pending
- Función: Aviso de que se recibió una solicitud de débito en una CVU de la PSP
- Acción requerida: La PSP debe responder aceptando o rechazando la solicitud mediante el endpoint POST /v1/cvu/operations/debit/confirm.
- Tipo de operación: Para Débitos Pendientes por Transferencias Pull se indican los siguientes tipos y sub-tipos de operación en los campos
operation.typeyoperation.sub_typedel 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. |
- Más información: Ver documentación Aviso Débito de Pendiente en CVU
Notificación de Finalización de Transferencia Pull (Débito)
- Webhook: POST /v1/notifications/psp/operation-result
- Función: Indica el resultado final de la operación (éxito o error).
- Detalle: Incluye datos de las partes, tipo, moneda y fechas de la operación.
- Tipo de operación: Para Transferencias Pull se indican los siguientes tipos y sub-tipos de operación en el campo
operation.typedel cuerpo de la notificación:
| Tipo de operación | Descripción |
|---|---|
TRANSFER_PULL | Débito por Transferencia Pull ejecutada en una CVU de la PSP con consentimiento. |
- Más información: Ver documentación Resultado de Operación
Procedimiento
- Entidad Crédito: Solicita fondos mediane una Transferencia Pull a una CVU de la PSP.
- Comafi Apibanking: Envía la notificación de un Débito pendiente a la PSP.
- PSP: Recibe la solicitud de un débito pendiente por una Transferencia Pull en su Webhook: POST /v1/notifications/cvu/debit-pending.
- PSP: Envía la respuesta a la solicitud de débito, aceptando o rechazando el débito de la operación a través de la API POST /v1/cvu/operations/debit/confirm.
- Comafi Apibanking: Debita el monto de la Transferencia Pull de la cuenta recaudadora de la PSP (en caso de haber aceptado) y los envía a la Entidad Crédito.
- Comafi Apibanking: Notifica la finalización de la operación a la PSP mediante el Webhook POST /v1/notifications/psp/operation-result
- PSP: La PSP confirma la recepción de la notificación
⚠ Importante:
La PSP tiene hasta 3 segundos para responder la solicitud de débito por Transferencia Pull (ya sea aceptando o rechazando la misma) desde que recibe la notificacion de un Débito Pendiente.
Es decir, una vez recibida la notificación en el Webhook POST /v1/notifications/cvu/debit-pending, tiene 3 segundos para ejecutar la API POST /v1/cvu/operations/debit/confirm para la confirmación del debito. En caso de haber excedido ese plazo de tiempo, la operación quedará en estado VENCIDO y será anulada, no habiéndose realizado ningún movimiento de fondos.
Diagramas de Sequencia
Caso exitoso
Caso erróneo
Flujo de Generación de Contracargo a una Transferencia Pull
En caso de que la PSP haya recibido una solicitud de Transferencia Pull (Débito en una CVU) y que el titular de la cuenta desconozca ese movimiento, la PSP puede solicitar el contracargo de esa operación para realizar un reembolso de los fondos.
Todo cliente tendrá un plazo de 60 días para desconocer un débito en concepto de Transferencia Pull debitada y se le reintegrará la suma debitada dentro de los 3 días hábiles de realizado el desconocimiento, y se efectuará un contracargo automático contra la entidad originante. El contracargo permite desconocer por fraude un débito en su cuenta por operaciones de Transferencias Pull e iniciar el procedimiento de solicitud de devolución de los fondos.
Para este flujo la PSP debe integrar los siguientes componentes:
APIs
Solicitar contracargo de una Transferencia Pull
- Endpoint: POST /v1/transfers/pull/chargeback
- Función: Solicita el Contracargo de una Transferencia Pull Recibida
- Más información: Ver documentación del servicio para Solicitar contracargo de una Transferencia Pull.
Webhooks
Notificación de Crédito por Transferencia Pull
- Webhook: POST /v1/notifications/cvu/credit-received
- Función: Informa que se acreditaron fondos en una CVU de la PSP para que la misma concilie el movimiento.
- Detalle: Incluye datos de las partes, tipo, moneda y fechas de la operación.
- Tipo de operación: Para Contracargos de Transferencias Pull se indican los siguientes tipos de operación en el campo
operation.typedel cuerpo de la notificación:
| Tipo de operación | Descripción |
|---|---|
TRANSFER_PULL_CHARGEBACK | Crédito en CVU por Contracargo de una Transferencia Pull |
- Más información: Ver documentación Créditos en CVU
Notificación de Finalización de Contracargo de Transferencia Pull
- Webhook: POST /v1/notifications/psp/operation-result
- Función: Indica el resultado final de la operación de Contracargo por Transferencia Pull por un error ocurrido.
- Detalle: Incluye datos de las partes, tipo, moneda y fechas de la operación.
- Tipo de operación: Para Contracargo Transferencias Pull se indican los siguientes tipos y sub-tipos de operación en el campo
operation.typedel cuerpo de la notificación:
| Tipo de operación | Descripción |
|---|---|
TRANSFER_PULL_CHARGEBACK | Aviso de Contracargo por Transferencia Pull |
- Más información: Ver documentación Resultado de Operación
Procedimiento
- PSP: Solicita el Contracargo de una Transferencia Pull recibida mediante la API POST /v1/transfers/pull/chargeback indicando el ID de la Transferencia Recibida.
- Comafi Apibanking: Envía la solicitud de Contracargo a la Entidad Crédito.
- Entidad Crédito: Envía los fondos a la cuenta recaudadora de la PSP
- Comafi Apibanking: Notifica a la PSP sobre el crédito recibido en concepto de Contracargo, indicando la CVU correspondiente mediante el Webhook POST /v1/notifications/cvu/credit-received
- PSP: La PSP confirma la recepción de la notificación

