Transfer-In
Las referencias de cuenta Transfer-In no tienen fecha de vencimiento, por lo que pueden utilizarse todas las veces que sea necesario para recibir transferencias entrantes.
Contacta a tu KAM para habilitar Transfer-In
transfer_acc.Combinaciones Permitidas
| Geo del Cobre Balance (source_id) | Provider ID | Tipo de Account Reference |
|---|---|---|
| Cobre Balance Colombia | pr_col_1066 | transfer_acc |
Ciclo de Vida de la Referencia de Cuenta Transfer-In
connectivity.status. Esto te permite:connectivity.status | Descripción |
|---|---|
processing | Estado intermedio que indica que la solicitud de creación de la cuenta ha sido enviada y el proveedor está aprovisionando el número de cuenta. El número de cuenta aún no está disponible. |
enabled | La referencia de cuenta fue aprovisionada exitosamente y está activa y lista para recibir transferencias. El número de cuenta bancaria y el tipo de cuenta están disponibles en el objeto metadata. |
failed | La creación de la referencia de cuenta falló. No se devuelve la cuenta bancaria. |
Ten en cuenta que la creación de referencias de cuenta Transfer-In es asíncrona, por lo que las solicitudes de creación siempre retornarán con connectivity.status: "processing". El estado final debe verificarse posteriormente a través del endpoint GET o mediante webhook una vez que la referencia transite a estadoenabledofailed.
Acciones Realizadas sobre una Referencia de Cuenta Transfer-In
🔑 Crear
🔍 Consulta
❌ Eliminar una Referencia de Cuenta
Descripción: Creación de una referencia de cuenta Transfer-In.
Qué esperar después de la acción: Se crea una referencia de cuenta con
📘 Más información:
Qué esperar después de la acción: Se crea una referencia de cuenta con
connectivity.status: "processing" y es aprovisionada de forma asíncrona por el proveedor. Una vez activa, el número de cuenta bancaria está disponible en el objeto metadata.📘 Más información:
Códigos de Error
| Código de Error | Descripción |
|---|---|
REF000 | La creación de la referencia ha fallado. Por favor, inténtalo de nuevo. |
REF001 | La creación de la referencia ha fallado. El proveedor de {source_id} no es válido para el tipo de referencia. Por favor, selecciona una cuenta con un proveedor válido e inténtalo de nuevo. |
REF002 | La creación de la referencia ha fallado. El tipo de referencia no es válido. Por favor, ingresa una referencia válida e inténtalo de nuevo. |
REF006 | La creación de la referencia ha fallado. El {source_id} no pertenece al cliente que inicia la solicitud. Por favor, inicia una solicitud con una cuenta que pertenezca al cliente correcto e inténtalo de nuevo. |
REF008 | La creación de la referencia ha fallado. El tipo de referencia de cuenta que intentas crear está vinculado a una funcionalidad que tienes deshabilitada. Por favor, contacta a tu KAM para habilitar esta funcionalidad e inténtalo de nuevo. |
REF009 | La creación de la referencia ha fallado. El proveedor que intentas usar para crear la referencia no está habilitado. Por favor, inicia una solicitud con un provider_id válido e inténtalo de nuevo. |
REF010 | La creación de la referencia ha fallado. La cuenta {source_id} no está activa. Por favor, selecciona una cuenta activa e inténtalo de nuevo. |
Cómo Empezar
Antes de usar esta API
Contacta a tu KAM para habilitar Transfer-In
Transfer-In debe estar habilitado para tu cuenta antes de poder usar el tipo de referencia
transfer_acc.Necesitas un Cobre Balance activo en Colombia
Para crear una referencia de cuenta Transfer-In, debes tener una cuenta Cobre Balance Colombia activa (proveedor
pr_col_cobre).Define tu modelo de recaudo
Antes de crear referencias de cuenta, considera cómo deseas estructurar tu flujo de recaudo. Puedes crear una referencia de cuenta por pagador para una atribución precisa, o usar una única referencia de cuenta para recaudar de múltiples pagadores.
Implementa Webhooks para rastrear el estado de la referencia de cuenta y las transferencias entrantes
Para mantenerte informado sobre los cambios en el ciclo de vida de una referencia de cuenta Transfer-In y recibir notificaciones cuando se reciban fondos, recomendamos firmemente implementar Webhooks. Los Webhooks notifican a tu sistema en tiempo real cuando una referencia de cuenta es aprovisionada y cuando se aplica un crédito por transferencia en tu Cobre Balance. Suscríbete al evento Consulta Notificaciones y Suscripciones para más detalles.
accounts.balance.credit para recibir notificaciones sobre transacciones, y a los eventos transfer_acc.status.processing, transfer_acc.status.enabled y transfer_acc.status.failed para estar al tanto del proceso de creación de tus cuentas.Qué esperar después de usar esta API
Comparte los datos de la cuenta bancaria con tu pagador
Una vez que la referencia de cuenta transite a Consulta Generar un Certificado para tu Referencia de Cuenta
enabled, obtén el número de cuenta bancaria del campo value, el tipo de cuenta de metadata.account_type, el banco de metadata.provider_id y el NIT del titular de la cuenta de metadata.account_holder_Id — y compártelos con tu pagador para que pueda iniciar la transferencia desde cualquier institución financiera colombiana.Empieza a recibir transferencias
Una vez que el pagador envíe una transferencia bancaria al número de cuenta asignado, Cobre detecta la transferencia entrante y acredita automáticamente el Cobre Balance asociado. Verás una transacción de tipo
transfer_credit en la cuenta Cobre Balance vinculada a la referencia. Usa webhooks o el endpoint GET para obtener las transacciones.Concilia los pagos entrantes
Cada transacción
transfer_credit incluye el NIT del pagador, nombre del pagador, banco del pagador, fecha de la transferencia y la referencia de cuenta que recibió los fondos — brindando a tu equipo de finanzas todo lo necesario para conciliar los recaudos con precisión.Modified at 2026-05-14 20:03:26