Llaves Cobre con Bre-B
Las Cobre Keys no tienen fecha de vencimiento, por lo que pueden usarse tantas veces como sea necesario para recibir payins.
Combinaciones Permitidas
| Tipo de Cuenta | Geo | Tipo de Llave | Ejemplo de Valor de Llave |
|---|---|---|---|
| Cobre Balance | COL | Alfanumérico | @CBARG452PEXTOCOLOMBI |
Estructura y personalización de llaves
| Prefijo de Institución Financiera | Cadena Aleatoria | Cadena Configurable |
|---|---|---|
| @CB — Identifica llaves creadas por Cobre | Asegura unicidad global | Permite al cliente personalizar la llave basándose en nombre, ID o un valor aleatorio |
Tipos de Cobre Key
El alias utilizado para llaves basadas en nombre puede configurarse desde el Portal de Cobre o mediante una solicitud a través de nuestros canales de soporte.
| Tipo de Llave | Longitud | Ejemplo |
|---|---|---|
name | 21 | @CBARG452PEXTOCOLOMBI |
ID | 17-18 | @CBAQ1ER9001234567 |
random | 10 | @CBAQ1EXD8 |
open_input | 21 | @MYPERSONALIZEDKEY123 |
open_input: Únicamente letras y números son permitidos, sin espacios, mínimo 5 caracteres y máximo 20 para la parte personalizable.
name: Puedes crear llaves tipo name con un alias al inicio para mejorar tu visibilidad de marca in las llaves generadas. Por ejemplo: @PEXTOCOLOMBICBARG452 Contacta a tu KAM para habilitar este feature
| Método de Pago | open_input | name | id | random |
|---|---|---|---|---|
| Direct link Key | x | x | ||
| Direct link Qr | x | |||
| Checkout Key | x | |||
| Checkout Qr | x | |||
| Static Key | x | x | x | x |
Ciclo de vida de Cobre Key y acciones previas
| estado | descripción |
|---|---|
processing | Un estado intermedio que indica que la creación de Cobre Key enviada aún está siendo procesada |
registered | La Cobre Key fue creada y registrada exitosamente, y ahora está disponible para uso |
unregistered | La Cobre Key fue cancelada por solicitud del usuario a través de nuestra API de cancelación de llaves.** Una vez cancelada, una llave no puede ser reactivada** |
disabled | La Cobre Key fue deshabilitada por el usuario o por Cobre. Una llave en estado deshabilitado puede ser reactivada |
failed | La acción intentada sobre la llave no fue exitosa y es necesario enviar la solicitud de creación nuevamente |
Idempotencia de Cobre Key
En este momento, solo se puede crear una Cobre Key por cuenta de Cobre Balance.
Acciones realizadas en una Cobre Key
🔑 Crear
🔍 Obtención
❌ Bloquear o Reactivar
❌ Cancelar
Descripción: Creación de Cobre Key.
Qué esperar después de la acción: La Cobre Key es creada en Cobre.
📘 Aprende más:
Qué esperar después de la acción: La Cobre Key es creada en Cobre.
📘 Aprende más:
Cómo Comenzar
Antes de usar esta API
Necesitas un Cobre Balance en Colombia
Para poder crear una Cobre Key, debes tener una cuenta de Cobre Balance en Colombia.
Define el tipo de Cobre Key
Antes de crear una Cobre Key, considera cuidadosamente qué tipo de llave se adapta mejor a tu caso de uso. El tipo seleccionado determina cómo se genera, gestiona y reutiliza el valor de la llave a través de tus flujos de pago.
Implementa Webhooks para rastrear el estado de Cobre Key
Para mantenerte informado sobre cambios en el ciclo de vida de una Cobre Key, recomendamos encarecidamente implementar Webhooks. Los Webhooks notifican a tu sistema en tiempo real cuando una Cobre Key es creada, habilitada, deshabilitada o eliminada, permitiéndote reaccionar prontamente a cada cambio de estado. También suscríbete a los eventos requeridos para recibir notificaciones sobre créditos de transacciones.Ver Notificaciones para más detalles.
Qué esperar después de usar esta API
Comenzar a recibir transferencias
Una vez que la Cobre Key es creada y está disponible, puedes exponerla a tus usuarios finales para comenzar a recibir transferencias a través de la llave y tener los fondos acreditados directamente a tu Cobre Balance. Verás una transacción de crédito tipo breb_credit en la cuenta de Cobre Balance vinculada a la llave.
Bloquear o Reactivar una Cobre Key
Una vez que la Cobre Key es creada y está disponible, puedes habilitarla o deshabilitarla en cualquier momento, dependiendo de tus necesidades operacionales o de negocio.
Eliminar una Cobre Key
Una vez que la Cobre Key es creada y está disponible, puedes eliminarla si ya no tienes la intención de usarla para operaciones. Una vez que una Cobre Key es eliminada, no puede ser usada nuevamente.
Modified at 2026-03-25 21:21:04