Bre-B
Limitaciones de Bre-B y comportamiento de enrutamiento
Contrapartes soportadas
| Tipo de Destino | Tipo de Contraparte | Rieles |
|---|---|---|
| Llave Bre-B | breb_key | Bre-B / Fast Pay* / ACH* |
| QR Bre-B | breb_QR | Bre-B |
( * ) Fast Pay o ACH solo se utilizan cuando es necesario re-enrutar la transacción debido a las limitaciones del riel Bre-B.
Flujo de Autorización (opcional)
pending_approval hasta que sea aprobado o rechazado. El proceso de aprobación puede completarse ya sea a través del Portal de Cobre o programáticamente vía API.Ciclo de vida del PayOut
Crear una contraparte de tipo
breb_key or breb_qr usando la información registrada de llave Bre-B del beneficiario o el string obtenido de la lectura del QR Bre-B.Esta contraparte representa el destino de la transacción PayOut.
Crear un Money Movement usando:
account_id del cual los fondos serán debitados, usado como el source_id.counterparty_id del paso anterior como el destination_iddescriptionexternal_id donde puedes usar para enviar una referencia desde tu sistema.Payouts con QR de Bre-B
breb_qr y el qr tiene un qr_amount definido diferente a -1, el monto del money movement debe ser igual.Una vez creado, el Money Movement inicia en el estado
initiated.processing. En este punto, la transacción es enviada a través de Bre-Bfailed.checker_approval = true, primero se mueve al estado pending_approval y solo transicionará a processing o canceled una vez que se tome la decisión de aprobación.Una vez que el Money Movement transiciona al estado
processing, los fondos son debitados del Cobre Balance asociado.completed, el beneficiario ha recibido exitosamente los fondos.rejected, los fondos son acreditados de vuelta a tu Cobre Balance.Los cambios de estado del Money Movement son comunicados vía Webhooks.
Acciones realizadas en un Money Movement (PayOut)
🔑 Crear
🔍 Consulta
Descripción: Creación de Money Movement.
Qué esperar después de la acción: Money Movement es creado en Cobre.
📘 Aprende más:
Qué esperar después de la acción: Money Movement es creado en Cobre.
📘 Aprende más:
Idempotencia del Money Movement
Las claves de idempotencia son válidas por 24 horas.
Cómo Empezar
Antes de usar esta API
Necesitas un Cobre Balance en Colombia
Para enviar fondos usando Bre-B, debes tener una cuenta Cobre Balance activa en Colombia con fondos suficientes.
Crear la Contraparte beneficiaria
Antes de crear un Money Movement de PayOut, debes crear una Contraparte con la información del beneficiario, que coincida con el tipo de destino seleccionado.
Definir la configuración del PayOut
Decidir el tipo de destino, monto, y cualquier metadato requerido necesario para procesar el PayOut.
Implementar Webhooks para rastrear el estado del pago
Para mantenerte informado sobre el estado de las transacciones PayOut, recomendamos fuertemente implementar Webhooks. Los Webhooks notifican a tu sistema cuando un pago es iniciado, procesado, completado, o falla. También suscríbete a los eventos requeridos para recibir notificaciones sobre débitos y créditos de transacciones.Ver Notificaciones y Suscripciones para más detalles.
Qué esperar después de usar esta API
Iniciar el PayOut
Una vez que la solicitud de creación de Money Movement es enviada, será creada con un estado iniciado.
Asegúrate de que tu sistema esté preparado para recibir actualizaciones de estado mientras el Money Movement progresa a través de su ciclo de vida.
Asegúrate de que tu sistema esté preparado para recibir actualizaciones de estado mientras el Money Movement progresa a través de su ciclo de vida.
Rastrear el estado de la transacción
Monitorea el ciclo de vida del PayOut usando Webhooks o endpoints de consulta.
Los fondos son entregados al beneficiario
Cuando el PayOut es exitoso, los fondos son acreditados a la cuenta del beneficiario y el estado del Money Movement es actualizado correspondientemente.
Modified at 2026-03-03 22:32:35