Integración BReB
Consultar destinatario (GetTarget)
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.
Si envías amount, sourceIdentification y sourceAccount junto con los datos del destinatario, este endpoint también prepara la transacción y retorna el transactionId listo para ejecutar.
{BASE_URL}/breb/get-targetParámetros
| Campo | Tipo | Descripción | Req. |
|---|---|---|---|
channel | string | Canal. Ej: "WEB". | Sí |
sourceService | string | Servicio origen. Ej: "PEX". | Sí |
entity | string | Código de la entidad bancaria del destinatario. Obligatorio y debe enviarse desde el frontend. Ej: "EB000001". | Sí |
user | string | Operador. Ej: "jcano". | Sí |
typeKeyCustomer | string | Tipo de llave del destinatario: "E" = email, "P" = celular, "NRIC" = cédula. | Sí |
valueKeyCustomer | string | Valor de la llave del destinatario. Ej: "deison_ac@hotmail.com". | Sí |
ip | string | IP del dispositivo. Ej: "192.168.0.1". | Sí |
amount | string | Monto a transferir. Si se envía, también prepara la transacción. Ej: "1.02". | No* |
sourceIdentification | string | Cédula de quien envía el dinero. Ej: "1051287968". | No* |
sourceAccount | string | Número de cuenta de quien envía. Ej: "852000002". | No* |
uuid / mac / trademark / model / platform / serialDevice / simDeviceId / simCellNumber / simOperator / simSerialNumber / versionPlatform / geoLocation / userAgentString | string | Datos del dispositivo (igual que en get-key). | No |
* Si envías uno de los tres (amount, sourceIdentification, sourceAccount), debes enviar los tres juntos.
Ejemplo de petición
{
"channel" : "WEB",
"sourceService" : "PEX",
"entity" : "EB000001",
"user" : "jcano",
"typeKeyCustomer" : "E",
"valueKeyCustomer" : "deison_ac@hotmail.com",
"ip" : "192.168.0.1",
"amount" : "1.02",
"sourceIdentification": "1051287968",
"sourceAccount" : "852000002",
"geoLocation" : "4.710989,-74.072092"
}Respuestas
| Código | Descripción |
|---|---|
| 200 | Destinatario encontrado. Si se envió monto, retorna transactionId para usar en el siguiente paso. |
| 400 | Datos inválidos. |
| 404 | Destinatario no encontrado — esa llave no existe en el sistema. |
DELEliminar llave
Desvincula y elimina la llave de un cliente. Después de esto, esa llave ya no se puede usar para recibir transferencias. Es como borrar un número de cuenta de tus favoritos en la app del banco.
POSTTransferencia
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.