Integración BReB
Realizar Transferencia
Ejecuta la transferencia de dinero entre dos cuentas. Es el paso final donde el dinero realmente se mueve. Necesitas tener listo el targetResolutionId que obtuviste en Consultar destinatario.
El targetResolutionId es único por transacción y expira. Úsalo inmediatamente después de obtenerlo en get-target.
{BASE_URL}/breb/transactionParámetros — Origen (quien envía)
| Campo | Tipo | Descripción | Req. |
|---|---|---|---|
channel / sourceService / user / ip | string | Datos del canal y operador. | Sí |
amount | string | Monto a transferir. Ej: "1000000". | Sí |
reference | string | Descripción o referencia del pago. Ej: "Pago de referencia". | Sí |
sourceIdentification | string | Cédula de quien envía. Ej: "11281434". | Sí |
sourceTypeIdentification | string | Tipo de doc de quien envía. Ej: "CC". | Sí |
sourceFirstName / sourceSurName | string | Nombre y apellido de quien envía. | Sí |
sourceEntity | string | Código del banco de quien envía. Ej: "EB000001". | Sí |
sourceNumberAccount | string | Número de cuenta de quien envía. Ej: "862000159". | Sí |
sourceTypeAccount / sourceSubTypeAccount | string | Tipo y subtipo de cuenta origen. Ej: "AH", "DE". | Sí |
Parámetros — Destino (quien recibe)
| Campo | Tipo | Descripción | Req. |
|---|---|---|---|
targetResolutionId | string | ★ Clave. ID obtenido en get-target. Ej: "373988e9-490c-48d6-aa12-a06b92e184af". | Sí |
targetValueKeyCustomer | string | Llave del destinatario. Ej: "80009330". | Sí |
targetTypeKeyCustomer | string | Tipo de llave del destinatario. Ej: "NRIC". | Sí |
targetEntity | string | Código del banco destino. Ej: "00000022". | Sí |
targetNumberAccount | string | Número de cuenta destino. Ej: "862000034". | Sí |
targetTypeAccount / targetSubTypeAccount | string | Tipo y subtipo de cuenta destino. | Sí |
targetIdentification / targetTypeIdentification | string | Cédula y tipo de doc del destinatario. | Sí |
targetFirstName / targetSurName | string | Nombre y apellido del destinatario. | Sí |
targetNode | string | Nodo de la red ACH del destinatario. Ej: "NODE001". | Sí |
geoLocation / uuid / mac / trademark / model / platform / serialDevice / simDeviceId / simCellNumber / simOperator / simSerialNumber / versionPlatform / userAgentString | string | Datos del dispositivo para seguridad y auditoría. | No |
Ejemplo de petición
{
"channel" : "MOVIL",
"sourceService" : "MEX",
"user" : "jcano",
"ip" : "192.168.0.1",
"reference" : "Pago de referencia",
"amount" : "1000000",
"sourceIdentification" : "11281434",
"sourceTypeIdentification": "CC",
"sourceFirstName" : "DEISON ANDREI",
"sourceSurName" : "BUITRAGO",
"sourceEntity" : "EB000001",
"sourceNumberAccount" : "862000159",
"sourceTypeAccount" : "AH",
"sourceSubTypeAccount" : "DE",
"targetResolutionId" : "373988e9-490c-48d6-aa12-a06b92e184af",
"targetValueKeyCustomer": "80009330",
"targetTypeKeyCustomer": "NRIC",
"targetEntity" : "00000022",
"targetNumberAccount" : "862000034",
"targetTypeAccount" : "AH",
"targetSubTypeAccount" : "DE",
"targetNode" : "NODE001",
"targetIdentification" : "80009330",
"targetTypeIdentification": "CC",
"targetFirstName" : "RENE",
"targetSurName" : "LOZADA"
}Respuestas
| Código | Descripción |
|---|---|
| 200 | Transacción realizada. El dinero está en camino y recibirás un paymentId para seguimiento. |
| 400 | Datos inválidos. Revisa que todos los campos obligatorios estén correctos. |
| 404 | Cuenta o llave no encontrada. El targetResolutionId expiró o la cuenta no existe. |
| 500 | Error en la transacción. Problema interno — guarda el error y contacta soporte. |
POSTConsultar destinatario
Busca a quién le vas a enviar la plata usando su llave (correo, celular o cédula). Cuando envías la información del monto y cuenta origen, el sistema prepara la transacción y te devuelve un transactionId — guárdalo porque lo necesitas en el siguiente paso.
POSTConsultar pago
Verifica el estado de una transferencia que ya realizaste usando su paymentId. Es como rastrear un paquete de Rappi: le das el número de pedido y te dice en qué estado va.