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
Registrado	RD000	Registro completado exitosamente
No registrado	RD001	Registro de cuenta rechazado
No registrado	RD004	Cuenta inactiva o bloqueada
No registrado	RD006	La cuenta e identificación no coinciden
No registrado	RD010	La cuenta no existe
No registrado	RD025	Cuenta no autorizada para débito
No registrado	FD001	El registro falló, se requiere reintentar
Fallido	Fallido	El registro falló, se requiere reintentar

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#