Integración BReB
PUT
Actualizar llave de cliente
Modifica los datos de una llave que ya existe. Por ejemplo, si el cliente cambió de correo o quiere actualizar el nombre. Es como editar un contacto guardado en el celular.
PUT
{BASE_URL}/breb/update-keyNecesitas el idKeyCustomer (el ID único de la llave). Lo obtienes del resultado de Consultar llave.
Parámetros clave
| Campo | Tipo | Descripción | Req. |
|---|---|---|---|
idKeyCustomer | string | ID único de la llave a modificar. Es como el número de turno de esa llave. Ej: "416da151-51e9-4bd6-8c13-4f244f3648d9". | Sí |
processKeyCustomer | string | Para actualizar usar "AMND". | Sí |
typeKeyCustomer | string | Tipo de llave: "E" = email, "P" = celular, "NRIC" = cédula. | Sí |
valueKeyCustomer | string | Nuevo valor de la llave. Ej: "rolozadag@gmail.com". | Sí |
firstName / surName | string | Nombre actualizado del cliente. | Sí |
identification / numberAccount | string | Cédula y número de cuenta del cliente. | Sí |
channel / sourceService / user | string | Datos del canal y operador (igual que en los demás endpoints). | Sí |
Ejemplo de petición
{
"channel" : "MOVIL",
"processKeyCustomer" : "AMND",
"typeKeyCustomer" : "E",
"valueKeyCustomer" : "rolozadag@gmail.com",
"idKeyCustomer" : "416da151-51e9-4bd6-8c13-4f244f3648d9",
"receptorNode" : "VIS",
"sourceTypeAccountDescription": "Ahorros a la Vista",
"businessName" : "Integración BReB",
"firstName" : "RENEE",
"surName" : "LOZADA",
"sourceService" : "MEX",
"identification" : "80009330",
"typeIdentification" : "CC",
"numberAccount" : "862000034",
"typeAccount" : "AH",
"subTypeAccount" : "DE",
"user" : "jcano"
}Respuestas
| Código | Descripción |
|---|---|
| 200 | Llave actualizada exitosamente. |
| 400 | Datos inválidos. |
| 404 | Llave no encontrada — el idKeyCustomer no existe. |
POSTRegistrar llave
Crea una nueva llave para un cliente — puede ser su correo, celular o cédula — y la vincula a su cuenta bancaria. Es como inscribirse a Nequi por primera vez: das tu número de celular y lo atan a tu cuenta.
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.