post
https://payment-backend-sandbox.milio.com.co/breb_keys/
La llave puede ser genérica de empresa o asociada a un cliente específico. Si se crea como llave de cliente, todos los campos relacionados al cliente son obligatorios.
El cuerpo del request debe estar encriptado y la respuesta también estará encriptada.
Flujo de creación
La creación es asíncrona:
- Se envía el request con los datos requeridos.
- La API valida los datos de forma síncrona.
- Si la validación pasa, se encola una tarea y se retorna un
task_idjunto con un preview de la llave generada. - La llave se crea en segundo plano. Para conocer el resultado final, consulta el endpoint Obtener Estado de Tarea Asíncrona usando el
task_idretornado.
Cuerpo del request (Body)
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
is_client | boolean | ✅ Sí | Indica si la llave es para un cliente (true) o genérica de empresa (false) |
description | string | No | Descripción opcional para la llave |
alias | string | No | Alias opcional para identificar la llave |
client_name | string | ✅ Si is_client=true | Nombre completo del cliente |
client_document | string | ✅ Si is_client=true | Número de documento del cliente |
client_document_type | integer | ✅ Si is_client=true | ID del tipo de documento del cliente |
❌ 400 — Error de validación síncrona
La API detectó un error antes de encolar la tarea. La respuesta incluirá un campo status_code indicando el problema. Causas comunes:
is_client=truepero faltan campos del cliente.
❌ 401 — No autorizado
La llave de API no fue enviada o es inválida.
❌ 403 — Prohibido
No tienes permisos para acceder a este recurso.