Débito Directo

Cobrar Fondos Mediante Débitos Directos

La API de Registro de Débito Directo (DDR) permite a los clientes de Cobre registrar una contraparte con su institución financiera para que la cuenta de la contraparte pueda ser autorizada para débitos directos.

Una vez que el registro está completado y aprobado por la contraparte, los clientes pueden iniciar movimientos de dinero direct_debit hacia la contraparte registrada utilizando la API de Movimientos de Dinero.

Los Débitos Directos permiten la cobranza automatizada de fondos sin requerir que la contraparte inicie manualmente las transferencias.

Términos Clave

DDR (Registro de Débito Directo): Proceso utilizado para registrar y autorizar una cuenta de contraparte para que pueda ser debitada.

Nequi: Institución financiera que proporciona cuentas de depósito y ahorro de bajo valor y soporta operaciones de débito directo.

API de Registro de Débito Directo

La API de Registro de Débito Directo registra una cuenta de Cobre Balance con la institución financiera (FI) de la contraparte.
Durante este proceso, la FI notifica a la contraparte y solicita autorización para permitir operaciones de débito en su cuenta.

El registro es asíncrono y su estado final depende de la respuesta de la institución financiera y la contraparte.

Estados del Registro de Débitos Directos

A continuación, puedes encontrar los posibles estados que puede obtener una solicitud de registro de débito directo de una contraparte.

Estado	Descripción
Procesando	Indica que la solicitud de registro está siendo procesada y la institución financiera notificará y solicitará confirmación de la contraparte.
Registrado	Indica que la contraparte fue registrada exitosamente para operaciones de débito directo.
No registrado	Indica que la contraparte no está autorizada para realizar operaciones de débito directo.

Estados del Registro de Débito Directo

Estado	Código de Estado	Descripción
Registered	NA	El registro se completó exitosamente.
Unregistered	DR000	No fue posible crear el registro de la cuenta. Por favor intenta de nuevo más tarde.
Unregistered	DR002	La solicitud de registro de cuenta ha fallado. La contraparte $co u n t er p a r t y$ no está permitida para el registro de cuenta. Por favor verifica que la geografía y el tipo de la contraparte cumplan con los criterios necesarios para el registro de cuenta.
Unregistered	DR003	La solicitud de registro de cuenta ha fallado. La descripción proporcionada supera el tamaño máximo permitido. Por favor ingresa una descripción válida e intenta de nuevo.
Unregistered	DR004	La solicitud de registro de cuenta ha fallado. El tipo de registro no es válido. Por favor ingresa un tipo de registro válido e intenta de nuevo.
Unregistered	DR005	El registro de cuenta ha fallado. El tipo de contraparte o su beneficiary_institution no son válidos para un registro de tipo ddr_nequi. Por favor verifica que la contraparte tenga un tipo válido y la beneficiary_institution correcta, luego intenta de nuevo.
Unregistered	DR006	El registro de cuenta ha fallado. Ya hay una solicitud de registro en curso para esta contraparte. Por favor intenta de nuevo cuando el registro actual haya finalizado.
Unregistered	DR007	El registro de cuenta ha fallado. Se ha superado el límite de Registros de Débito Directo (30) para esta contraparte. Por favor intenta de nuevo con una nueva contraparte.

Experiencia de Débito Directo de Cobre

Registrar la contraparte

Registrar la contraparte especificando el tipo de registro deseado (por ejemplo, nequi).

Confirmación de registro

La contraparte debe aprobar el registro a través de su institución financiera.

Crear un movimiento de dinero de Débito Directo

Una vez que la contraparte esté en estado registered, crear un movimiento de dinero direct_debit utilizando la API de Movimientos de Dinero.

Recepción de fondos

Una transacción dd_credit será acreditada a la cuenta de Cobre Balance asociada con el débito directo.

No todas las instituciones financieras permiten a los usuarios rechazar el registro; sin embargo, la mayoría notifica a la contraparte cuando su cuenta es registrada.
Si una contraparte ha sido registrada múltiples veces bajo diferentes tipos, se utilizará el último registro.

Tipos de Registro

	Débito Directo Nequi
Descripción	Permite registrar y debitar contrapartes a través de Nequi (código FI: 1507)
Tiempo Aproximado de Registro	Hasta 15 minutos para aprobación del usuario
Aceptación del Usuario	Requerida a través de la aplicación Nequi
Tiempo de Procesamiento de Débito	Tiempo real
Instituciones Financieras Habilitadas	Nequi

Cómo Empezar

Antes de usar esta API

Crear una contraparte

Crear una contraparte de tipo CC, CH, o DP.

Registrar la contraparte para Débitos Directos

Registrar la contraparte utilizando el endpoint de Registro de Débito Directo.

Suscribirse a eventos requeridos

Suscribirse a eventos para recibir notificaciones sobre cambios de estado de registro, movimientos de dinero y créditos.

Cada contraparte debe ser registrada individualmente con la cuenta que será debitada.

Qué esperar después de usar esta API

Actualización del estado de registro

El registro transiciona a registered, unregistered, o failed.

Realizar movimientos de dinero de Débito Directo

Si la contraparte está en estado registered, puedes iniciar movimientos de dinero direct_debit.

Recibir fondos

Una vez que el movimiento de dinero alcanza completed, una transacción dd_credit es registrada en la cuenta de Cobre Balance.

Acciones Realizadas en el Registro de Débito Directo

🔑 Crear

🔍 Consulta

Descripción: Registrar una contraparte para Débitos Directos.
Qué esperar: Un objeto de Registro de Débito Directo es creado y procesado de forma asíncrona.
📘 Aprende más:

🔗 Registrar una Contraparte para Débito Directo

Débito Directo

Cobrar Fondos Mediante Débitos Directos#

Términos Clave#

API de Registro de Débito Directo#

Estados del Registro de Débitos Directos#

Estados del Registro de Débito Directo#

Experiencia de Débito Directo de Cobre#

Tipos de Registro#

Cómo Empezar#

Antes de usar esta API#

Qué esperar después de usar esta API#

Acciones Realizadas en el Registro de Débito Directo#