Direct Link
Todas las pantallas de cara al usuario, incluyendo selección de método de pago, instrucciones de pago, confirmación y mensajes de éxito, deben ser completamente desarrolladas y administradas por el integrador.
Métodos de pago compatibles
| Método de Pago | Riel | Tipo | Tiempo de Expiración |
|---|---|---|---|
| PSE | pse | Enlace de Pago | 10 minutos |
| Bancolombia | bancolombia | Enlace de Pago | 10 minutos |
| Nequi | nequi | Notificación Push | 15 minutos |
| BreB QR | breb_qr | Código QR | 5 minutos |
| Llave BreB | breb_key | Llave | 5 minutos |
Información de la Contraparte: Para pse, el correo electrónico definido en la contraparte se utiliza para autenticar al usuario en el flujo de PSE.Para nequi, el número de teléfono definido en la contraparte se utiliza para enviar la notificación push.
El tiempo de expiración varía según el método de pago: Para pse, los pagadores tienen hasta 10 minutos para abrir el link. Una vez abierto, tienen hasta 25 minutos para completar el pago (esto puede variar según el banco).Para bancolombia, los pagadores tienen hasta 10 minutos para abrir el link. Una vez abierto, tienen hasta 25 minutos para completar el pago.Para nequi, los pagadores tienen hasta 15 minutos paraacceptorejectel R2P mediante notificación push.
Puedes configurar descriptores de facturación (la descripción asociada al pago) para que los pagadores la vean en sus recibos. Configúralo usando el campo checkout_itemen la API de Checkouts. Esta funcionalidad aún no está disponible para Bre-B.
Ciclo de vida del Direct Link
1.
Crea una contraparte utilizando la información del pagador. Esta contraparte representa el origen de la transacción payin.
2.
Crea un Money Movement utilizando:
counterparty_id del paso anterior como el source_idaccount_id donde quieres recibir los fondos como el destination_idr2p_rail de pago que se utilizará para el cargo.3.
Obtén la información del Money Movement y procede con la instrucción apropiada para el usuario:
4.
Espera a que el usuario termine el pago y muestra una pantalla de confirmación o éxito.
5.
Los cambios de estado del Money Movement se comunican vía Webhooks.
6.
Una vez que el pago es exitoso, los fondos son acreditados al Cobre Balance asociado.
Acciones realizadas en un Money Movement (Direct Link)
🔑 Crear
🔍 Consulta
Descripción: Creación de Money Movement.
Qué esperar después de la acción: El Money Movement es creado en Cobre.
📘 Más información:
Qué esperar después de la acción: El Money Movement es creado en Cobre.
📘 Más información:
Idempotencia del Direct Link
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 poder recibir dinero, debes tener una cuenta Cobre Balance en Colombia.
Crear la Contraparte
Antes de crear un Money Movement, debes crear la Contraparte con la información del pagador.
Definir la configuración de pago
Decide qué métodos de pago estarán disponibles, junto con el monto, fecha de validez hasta, y referencia que se mostrará al pagador.
Implementar Webhooks para rastrear el estado del pago
Para mantenerte informado sobre el estado de las transacciones Payin, 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 créditos de transacciones.Ver Notificaciones y Suscripciones para más detalles.
Qué esperar después de usar esta API
Compartir las instrucciones
Una vez creado, proporciona a tus usuarios finales las instrucciones de pago apropiadas basadas en el método de pago seleccionado. Esto puede incluir redirigir al usuario a un enlace de pago, informarle sobre una próxima notificación push, o mostrar una Clave Bre-B o código QR para completar el pago.
El usuario final completa el pago
El pagador completa la transacción a través de la experiencia alojada.
Recibe fondos en tu Cobre Balance
Una vez que el pago es exitoso, los fondos son acreditados a tu Cobre Balance y un Money Movement es actualizado.
Modified at 2026-03-10 19:31:52