Appearance
Transfers pull
Generación de Transferencia Pull
Al generar una Transferencia Pull, la PSP solicita dinero a una cuenta de uno de sus clientes para fondear una cuenta CVU del mismo cliente dentro de la PSP.
Para más información acerca de las notificaciones involucradas, visitar la siguiente documentación:
Procedimiento
El proceso de generación de una Transferencia Pull está compuesto por las siguientes etapas:
- PSP: Solicita una Transferencia Pull mediante la API de Transferencias Pull POST /v1/transfers/pull y queda a la espera de la confirmación de la acreditación de los fondos.
- Comafi Apibanking: Acepta la solicitud de Transferencia Pull y devuelve el estado PENDING a la PSP para realizar la solicitud de fondos a la cuenta correspondiente.
- Comafi Apibanking: Una vez realizada la acreditación de los fondos en la cuenta recaudadora de la PSP, Comafi Apibanking envía la notificación de crédito en CVU al Webhook de la PSP: POST /v1/notifications/cvu/credit-received.
- PSP: La PSP confirma la recepción de la notificación.
- Comafi Apibanking: Una vez finalizada la operación, Comafi Apibanking envía la notificación del resultado de la operación al Webhook de la PSP: POST /v1/notifications/psp/operation-result.
- PSP: La PSP confirma la recepción de la notificación.
Diagrama de secuencia
Procedimiento
El proceso de generación de una Transferencia Pull con error está compuesto por las siguientes etapas:
- PSP: Solicita una Transferencia Pull mediante la API de Transferencias Pull POST /v1/transfers/pull y queda a la espera de la confirmación de la acreditación de los fondos.
- Comafi Apibanking: Acepta la solicitud de Transferencia Pull y devuelve el estado PENDING a la PSP para realizar la solicitud de fondos a la cuenta correspondiente.
- Comafi Apibanking: Se prouce un error al procesar la Transferencia Pull con la entidad de destino y se envía la notificación del resultado de la operación con ERROR al Webhook de la PSP: POST /v1/notifications/psp/operation-result.
- PSP: La PSP confirma la recepción de la notificación.
Diagrama de secuencia
Atención:
- El id enviado debe ser único.
- En caso de una respuesta no exitosa (http status code >= 500 o timeout), se debe consultar antes de reintentar la petición.
Ejecutar Transferencia Pull.
POST
/v1/transfers/pull
Servicio para realizar el fondeo de una CVU (destino) mediante los fondos de una cuenta externa (origen) del mismo titular a través de Transferencias Pull.
Autorizaciones
bearerAuth
Tipo
HTTP (bearer)
Parámetros
Header Parameters
User-Agent*
header de identificación de cliente que envía la petición.
Tipo
Requeridostring
Ejemplo
"client-name"trace-id*
id único de la petición
Tipo
Requeridostring
Ejemplo
"416f4961-f677-4c8b-aafa-be6384a035c2"Formato
"uuid"X-Trx-Pull
Token de consentimiento para realizar la transferencia.
Tipo
string
Ejemplo
"eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3MTmIjoxNzE0NzQyNTgiLCJzdWIi..."Cuerpo de la petición
application/json
JSON "id": "0000000000001", "cuit": "23244825664", "from_account_key": "0000205100000005111068", "to_account_key": "0000772800334021336407", "transfer_code": "VAR", "amount": 15000.65, "currency_code": "ARS", "note": "Ingreso de dinero a mi billetera", "fingerprint": { "device_ip": "127.0.0.0", "device_name": "PC", "platform": "WINDOWS", "imsi": "350123451234560", "imei": "310170845466094", "geolocalization": { "latitude": "-18.011775864280644", "longitude": "-70.24436930849632" } }
{
}
Respuestas
Accepted
application/json
JSON "id": "0000000000001", "coelsa_id": "4KIW612E36ME4PXQ2GXYVR", "amount": 15000.65, "currency_code": "ARS", "from_account_key": "0000205100000005111068", "to_account_key": "0000772800334021336407", "note": "Ingreso de dinero a mi billetera", "transfer_code": "VAR", "status": "PENDING"
{
}