Appearance
Transferencias desde CBU
API para transferir fondos de una cuenta propia hacia un CBU/CVU
POST
/transfers
API para emitir una nueva transferencia desde CBU
Autorizaciones
access_token
Tipo
HTTP (bearer)
Parámetros
Header Parameters
conciliation
Estableciendo este header en true, se agrega el dato de numero de movimiento de la transferencia realizada. Esto permite realizar la conciliacion con API Movements
Tipo
boolean
Ejemplo
falsePor defecto
falseoperation-document-type
Indica el tipo de documento que se envia en el header 'Operation-Document-Number' sobre el quiere hacer la consulta. Para 'Plataformas' que vienen en representación de un cliente a ejecutar una api, esta cabecera es requerida.
Tipo
string
Valores válidos
"DNI""CUIT"Ejemplo
"CUIT"operation-document-number
Indica el numero de documento asociado al header 'Operation-Document-Type' sobre el que se quiere hacer la consulta. Para 'Plataformas' que vienen en representación de un cliente a ejecutar una api, esta cabecera es requerida.
Tipo
string
Ejemplo
30123456789Patrón
"\\^[0-9]{2,11}$"Cuerpo de la petición
application/json
JSON "id": "53bd2ccd-6a2c-4abe-acb2-ae962b295686", "amount": 2599.99, "currency_code": "ARS", "from_cbu": "2990039520000067790124", "to_cbu": "0150039520000067790123", "note": "Brunch with Camila", "transfer_code": "VAR", "ip_address": "34.100.201.26", "timestamp": "2020-02-20T10:49:04-07:00", "document_id": "12345678", "fingerprint": { "time_stamp": "2020-02-20T10:49:04-07:00", "hardware_id": "cc0af42f83a842a93ea95fc23dabc45f", "simid": "122334565", "geolocalization": { "latitude": "-18.011775864280644", "longitude": "-70.24436930849632" }, "device_model": "Samsung Galaxy J4 Core", "device_name": "My Phone", "os_name": "Android Donut", "os_version": "Android 1.6", "os_id": "746b9f55be4758b7", "language": "Spanish", "wifi_ssid": "TOWER1", "connection_type": "746babcde345be4758b7", "localization_area_id": "098af987ce88", "compromised": false, "emulator": false, "user_agent": "DimoApp/1.0.0" }, "risk": { "country": 100, "operation": 100 }
{
}
Respuestas
Transferencia completada, se completó tanto el débito como el crédito
application/json
JSON "reference_id": "53bd2ccd-6a2c-4abe-acb2-ae962b295686", "updated_at": "2020-02-20T10:49:04-07:00", "amount": 2599.99, "currency_code": "ARS", "from_cbu": "2990039520000067790124", "to_cbu": "0150039520000067790123", "note": "Brunch with Camila", "transfer_code": "VAR", "status": "APPROVED"
{
}
Errores
A continuación se detallan los posibles errores que pueden ocurrir al momento de utilizar el servicio de Transferencias CBU y los procedimientos necesarios para cada uno de ellos:
Internal Server Error
Este error puede ocasionarse por una falla interna de los servicios, lo cual impide la ejecución de la transferencia. En estos casos el HTTP Status recibido será el código 500. Ante la ocurrencia de este error, se permitirá el reintento de dicha transferencia utilizando el mismo ID, ya que la misma no fue cursada.
IMPORTANTE: Se debe consultar el estado de la transferencia antes de reintentar, para ello se utiliza la API de consulta de Transferencias CBU (/v1/transfers/cbu/{transfer_id}).
Transfer Pending Revision
Durante la ejecución de una transferencias, puede existir un error de intercomunicación con los servicios de transferencias por lo que la misma debe ser corroborada para certificar si fue ejecutada correctamente. Al ocurrir este error se recibe el siguiente mensaje con el código HTTP Status 409.
En esta situación la transferencia permanecerá en estado PENDING_REVISION (puede ser consultada mediante la API de consulta de Transferencias CBU), y la misma no podrá ser reintentada inmediatamente hasta que llegue a un estado final (Pudiendo ser éstos: APPROVED o FAILED).
Para estos casos se realiza un esquema de validaciones que nos permiten verificar si la transferencia fue ejecutada correctamente el cual realiza múltiples intentos. Si se logra verificar automáticamente que la transferencia se cursó correctamente, el estado pasará a APPROVED. Caso contrario, en el que NO se haya podido verificar que la transferencia se cursó, la misma quedará en PENDING_REVISION y será revisada a la brevedad por nuestro equipo.
IMPORTANTE:Las transferencias con estado PENDING_REVISION, no deben ser reintentadas hasta haber recibido un estado final (APPROVED o FAILED) de la transferencia al consultarla en la API de consulta de Transferencias CBU. Caso contrario, si la transferencia se ejecuta con un el mismo ID, el servicio indicará que la transferencia se encuentra en el estado PENDING_REVISION.
En el caso de que la transferencia se ejecute con un ID distinto, es decir con los mismos parámetros de transferencia (origen, destino, monto, etc) pero con otro ID, esto constituye una nueva transferencia que no se encuentra vinculada a la anterior ya que cada transferencia se diferencia únicamente por su ID. La transferencia debe ser reintentada solo cuando se haya obtenido un estado final de la misma al consultarla, para de esta manera evitar duplicaciones de transferencias.
Timeout
Nuestros servicios tienen un tiempo de conexión máximo de 30 segundos por request por lo que una vez excedido dicho tiempo, el servicio retornara una respuesta de Timeout con el con el código HTTP Status 504. Al recibir dicho error no implica que la request falló, sino que esta excedio el tiempo máximo establecido, pero la request continua procesandoce. Es importante en estos casos realizar una consulta de la transferencia en la API de consulta de Transferencias CBU, para conocer su estado final. Si ser recibe el estado PENDING, la transferencia continua procesándose.