Suspender Llave Bre-B
Visión General
Este endpoint se utiliza para suspender (desactivar temporalmente) una llave Bre-B específica asociada a la cuenta de un cliente.
Detalles del Endpoint
| Parámetro | Descripción |
|---|---|
| Endpoint | https://bre-b-sandbox.api.visionamos.passportfintech.com/v1/paas/entities/customers/accounts/keys/suspend |
| Método | PATCH |
| Encabezados | Content-Type: application/json, Authorization |
| Autenticación | Token de Acceso (Bearer Token) |
Cuerpo de la Solicitud
| Parámetro | Tipo | Descripción |
|---|---|---|
| id | String | identificador único de la llave a suspender. |
Ejemplo de Solicitud
7
7
curl --location --request PATCH \'https://bre-b-sandbox.api.visionamos.passportfintech.com/v1/paas/entities/customers/accounts/keys/suspend' \--header 'Content-Type: application/json' \--header 'Authorization: Bearer 33f3ea089c0cb5d6beac9a19c533efc3d38461c47cafcfe319fb61755b863202' \--data '{ "id": "591883bc-d138-4693-9cd0-c11e5da05207"}'Cuerpo de la Respuesta
- Código HTTP: 200 OK
Ejemplo de Respuesta
3
3
{ "key_status": "SUSP"}Errores Comunes y Manejo
| Código HTTP | Significado | Descripción |
|---|---|---|
| 400 | Bad Request | Campo id faltante o inválido. |
| 401 | Unauthorized | Token Bearer ausente o inválido. |
| 403 | Forbidden | Alcance insuficiente o falta de permisos para suspender la llave. |
| 404 | Not Found | No existe una llave con el id proporcionado. |
Buenas Prácticas
- Refresca los tokens OAuth antes de que expiren para evitar fallos de autenticación.
- Valida previamente los datos de entrada como el id para reducir errores 400.
- Usa la suspensión como medida temporal de seguridad antes de una cancelación definitiva.
- Mantén registros de quién y cuándo se suspendió la llave para fines de auditoría.