Skip to content

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

Rol Débito

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


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.type del cuerpo de la notificación:
Tipo de operaciónDescripción
TRANSFER_PULLCrédito por Transferencia Pull en una CVU de la PSP

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.type del cuerpo de la notificación:
Tipo de operaciónDescripción
TRANSFER_PULLDébito por Transferencia Pull ejecutada en una CVU de la PSP con consentimiento Tácito.

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.type del cuerpo de la notificación:
Tipo de operaciónDescripción
TRANSFER_PULL_CHARGEBACKContracargo 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.type del cuerpo de la notificación:
Tipo de operaciónDescripción
TRANSFER_PULL_CHARGEBACKAviso de Contracargo por Transferencia Pull


Procedimiento ​

  1. Entidad Débito: Solicita el Contracargo de una Transferencia Pull ejecutada por la PSP.
  2. Comafi Apibanking: Envía la notificación de Aviso de Contracargo a la PSP en el Webhook POST /v1/notifications/cvu/transfer-pull/chargeback.
  3. PSP: La PSP confirma la recepción de la notificación
  4. Comafi Apibanking: Ejecuta un débito por Contracargo en la cuenta recaudadora de la PSP
  5. 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


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.type y operation.sub_type del cuerpo de la notificación:
Tipo de operaciónSub-tipo de operaciónDescripción
TRANSFER_PULLTACITDébito por Transferencia Pull ejecutada en una CVU de la PSP con consentimiento Tácito.
TRANSFER_PULLEXPLICITDé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.type del cuerpo de la notificación:
Tipo de operaciónDescripción
TRANSFER_PULLDébito por Transferencia Pull ejecutada en una CVU de la PSP con consentimiento.

Procedimiento ​

  1. Entidad Crédito: Solicita fondos mediane una Transferencia Pull a una CVU de la PSP.
  2. Comafi Apibanking: Envía la notificación de un Débito pendiente a la PSP.
  3. PSP: Recibe la solicitud de un débito pendiente por una Transferencia Pull en su Webhook: POST /v1/notifications/cvu/debit-pending.
  4. 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.
  5. 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.
  6. Comafi Apibanking: Notifica la finalización de la operación a la PSP mediante el Webhook POST /v1/notifications/psp/operation-result
  7. 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


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.type del cuerpo de la notificación:
Tipo de operaciónDescripción
TRANSFER_PULL_CHARGEBACKCrédito en CVU por Contracargo de una 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.type del cuerpo de la notificación:
Tipo de operaciónDescripción
TRANSFER_PULL_CHARGEBACKAviso de Contracargo por Transferencia Pull

Procedimiento ​

  1. PSP: Solicita el Contracargo de una Transferencia Pull recibida mediante la API POST /v1/transfers/pull/chargeback indicando el ID de la Transferencia Recibida.
  2. Comafi Apibanking: Envía la solicitud de Contracargo a la Entidad Crédito.
  3. Entidad Crédito: Envía los fondos a la cuenta recaudadora de la PSP
  4. 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
  5. PSP: La PSP confirma la recepción de la notificación

Diagramas de Sequencia ​


Caso exitoso ​

Caso erróneo ​