Transferencia Pull

El servicio Transferencia Pull permite a una PSP solicitar acreditaciones de fondos (fondeo de cuenta CVU) desde cuentas CBU/CVU del mismo titular, así como aceptar solicitudes de débito por Transferencia Pull para fondear cuentas. Este mecanismo habilita a los clientes a realizar pedidos de fondos mediante el débito de su cuenta de origen, con acreditación inmediata en la cuenta del solicitante, siempre bajo su consentimiento explícito o de forma tácita.

Descripción general

El servicio Transferencia Pull permite a las PSP solicitar o aceptar transferencias de fondos entre cuentas del mismo titular (CBU ↔ CVU o CVU ↔ CVU).

A diferencia de las transferencias push tradicionales, en este modelo es la cuenta destino (CVU) quien inicia la solicitud de fondos desde la cuenta origen (CBU/CVU), ya sea:

• Con consentimiento explícito (enrolamiento y token previo)
• Con consentimiento tácito, cuando el usuario da una instrucción operativa que implica la aceptación de la transferencia.

La operación finaliza con acreditación inmediata, y su ciclo incluye notificaciones en cada etapa crítica para asegurar trazabilidad y conciliación.

Beneficios

• Acreditación inmediata de fondos, optimizando la disponibilidad del dinero.
• Flexibilidad en la operación, permitiendo tanto el uso de consentimiento explícito como tácito.
• Mayor eficiencia en la gestión de fondeo de cuentas CVU.
• Facilidad de integración con los estándares del ecosistema financiero.

☰ Índice

1. Requisitos de Integración
2. APIs Obligatorias
3. Webhooks Necesarios
4. Modalidades Operativas
5. Roles de la PSP
6. Flujos de operación

1. Requisitos de Integración

Funcionalidad

Para poder integrar y operar el servicio Transferencia Pull, la PSP debe cumplir con los siguientes requisitos:

1. Homologación de integración al servicio de Transferencias Pull con Comafi Apibanking.
2. Homologación del flujo de Pago QR interoperable previamente.
3. Integración a consentimiento explícito (si aplica). Si se implementa Transferencia Pull con consentimiento explícito, la PSP debe contar con:
   • Desarrollo e integración del flujo para generar el token de consentimiento mediante el enrolamiento de cuentas.
4. Integración de APIs obligatorias.

2. APIs Obligatorias

Funcionalidad

Este módulo agrupa las APIs mediante las cuales la PSP inicia, consulta o responde operaciones de Transferencias Pull. Cada endpoint está asociado a un rol (Crédito / Débito) y a un momento del ciclo transaccional.

APIS

Endpoint	Descripcion Funcional	Documentación
POST /v1/transfers/pull	Inicia una solicitud de fondeo desde una CVU de la PSP desde otra cuenta del mismo titular	Link
GET /v1/transfers/pull/{id}	Permite consultar el estado de una Transferencia Pull (por ID local o ID COELSA).	Link
POST /v1/transfers/pull/chargeback	Permite iniciar una solicitud de contracargo ante desconocimiento o error.	Link
POST /v1/cvu/operations/debit/confirm	Informa a API Banking la decisión de la PSP (aceptar/rechazar) ante una solicitud de débito recibida en una CVU.	Link

3. Webhooks Necesarios

Funcionalidad

API Banking genera notificaciones asincrónicas que son enviadas hacia los Webhooks de la PSP para informar los distintos eventos de operaciones de negocio. Permiten a la PSP mantener actualizadas sus operaciones y reaccionar automáticamente ante cambios de estado. Los Webhooks deben integrarse de manera obligatoria.

Webhooks

Endpoint	Evento	Descripcion Funcional	Comportamiento Esperado	Documentación
POST /v1/notifications/cvu/credit-received	Crédito recibido	Aviso de acreditación exitosa en una CVU. Los fondos se acreditan en la cuenta recaudadora de la PSP	Registrar el movimiento contable y actualizar el estado a “acreditado”.	Link
POST /v1/notifications/cvu/debit-pending	Débito pendiente	Solicitud de débito en una CVU. La PSP debe aceptar o rechazar usando la API POST /v1/cvu/operations/debit/confirm.	Procesar y dar respuesta al mismo en ≤ 3 segundos.	Link
POST /v1/notifications/cvu/transfer-pull/chargeback	Contracargo recibido	Notifica que un cliente solicitó la devolución de fondos de una Transferencia Pull ejecutada por la PSP	Marcar la operación como “en revisión” y esperar confirmación del débito por contracargo.	Link
POST /v1/notifications/psp/operation-result	Resultado final	Informa el resultado (éxito o error) de cualquier operación Pull procesada.	Usar para cierre y conciliación operativa	Link

4. Modalidades Operativas

Funcionalidad

En el ecosistema de Transferencias Pull, la PSP puede actuar en dos roles distintos:

• Crédito (solicitante de fondos) o Débito (entidad que recibe solicitud de extracción).
• Cada rol requiere integrar distintos endpoints y procesar diferentes notificaciones.

Modalidad	Características Funcionales	Token Requerido	Responsabilidad de la PSP	Flujo Técnico
Consentimiento Explícito	Basada en un consentimiento otorgado previamente mediante enrolamiento. El token garantiza autorización del titular.	SI	Validar vigencia del token y custodiarlo de forma segura.	Ejecutar servicio POST /v1/transfers/pull con header X-TRX-PULL: Bearer {token}
Consentimiento Tácito	Deriva de una acción operativa del cliente que demuestra conocimiento de la transacción y no la rechace explícitamente.	NO	Asumir el riesgo operativo ante reclamos	Ejecutar servicio POST /v1/transfers/pull sin token en header X-TRX-PULL: Bearer {token}

5. Roles de la PSP

Funcionalidad

En el ecosistema de Transferencias Pull, la PSP puede actuar en dos roles distintos:

Crédito (solicitante de fondos) o Débito (entidad que recibe solicitud de extracción).

Cada rol requiere integrar distintos endpoints y procesar diferentes notificaciones. La PSP debe integrarse para operar con ambos roles.

Rol	Descripción Funcional	APIs Involucradas	Endpoints Involucrados	Responsabilidad Principal
Crédito	La CVU perteneciente a la PSP solicita fondos desde una cuenta de su misma titularidad	POST /v1/transfers/pull	POST /v1/notifications/cvu/credit-received POST /v1/notifications/psp/operation-result POST /v1/notifications/cvu/transfer/pull/chargeback	Iniciar operaciones y registrar acreditaciones.
Débito	La PSP recibe solicitudes de débito (otras entidades solicitan fondos desde una CVU de la PSP).	POST /v1/cvu/operations/debit/confirm POST /v1/transfers/pull/chargeback	POST /v1/notifications/cvu/debit-pending POST /v1/notifications/cvu/credit-received (por contracargo) POST /v1/notifications/psp/operation-result	Evaluar, autorizar o rechazar débitos recibidos y ejecutar contracargos