Tokenizar cuentas Nequi y Daviplata

Vincula cuentas de Nequi y Daviplata para habilitar débitos automáticos.

Tokenizar Nequi y Daviplata

Este caso de uso te permite capturar y tokenizar cuentas bancarias de Nequi y Daviplata de tus clientes para posteriormente realizar débitos automáticos. Cada proveedor tiene un flujo de validación diferente.

El parámetro authorization debe ser true. Sin esto, la cuenta se crea pero el usuario nunca recibe la solicitud de enrolamiento en su billetera y no podrás realizar cargos.

Flujo con Nequi

1. Crear un cliente

   Registra al cliente en nuestra plataforma. Utiliza el endpoint Crear un cliente con los datos personales del titular de la cuenta Nequi.

2. Crear una cuenta Nequi

   Registra la cuenta bancaria del cliente seleccionando el banco Nequi. Utiliza el endpoint Crear una cuenta con:

   • bank_id: 9957817d-239b-4032-8dca-bc508a76579c
   • subtype: ELECTRONIC_DEPOSIT
   • authorization: true
   • account_number: Número de celular registrado en Nequi
3. Mostrar instrucciones al cliente

   Nequi requiere que el cliente complete el proceso de vinculación desde la aplicación del banco. Redirige al cliente a la aplicación de Nequi para que autorice el débito automático.

4. Validar la cuenta

   Valida la cuenta usando el endpoint Validar cuenta. Para Nequi no se requiere OTP, para Daviplata envía el código OTP recibido por SMS.

5. Usar la cuenta para débitos

   Con la cuenta tokenizada y activa, puedes usarla para débitos automáticos usando el endpoint Crear cargo con:

   • customer_id: ID del cliente
   • account_id: ID de la cuenta validada
   • amount: Monto a debitar

Flujo con Daviplata

1. Crear un cliente

   Registra al cliente en nuestra plataforma. Utiliza el endpoint Crear un cliente con los datos personales del titular de la cuenta Daviplata.

2. Crear una cuenta Daviplata

   Registra la cuenta bancaria del cliente seleccionando el banco Daviplata. Utiliza el endpoint Crear una cuenta con:

   • bank_id: 9957817d-26b5-456d-bc49-4a8ba1bc021b
   • subtype: ELECTRONIC_DEPOSIT
   • authorization: true
   • account_number: Número de celular registrado en Daviplata
3. Solicitar OTP al cliente

   Daviplata requiere validación mediante código OTP. Solicita al cliente que ingrese el código OTP recibido por SMS.

4. Validar la cuenta con OTP

   Valida la cuenta usando el endpoint Validar cuenta enviando el código OTP recibido por SMS.

5. Usar la cuenta para débitos

   Con la cuenta tokenizada y activa, puedes usarla para débitos automáticos usando el endpoint Crear cargo con:

   • customer_id: ID del cliente
   • account_id: ID de la cuenta validada
   • amount: Monto a debitar

Estados de la cuenta

Estado	Descripción
PENDING	Cuenta creada, pendiente de validación
VALIDATING	Proceso de validación en progreso (para Daviplata con OTP)
ACTIVE	Cuenta validada y lista para débitos
REJECTED	La validación fue rechazada
INACTIVE	Cuenta desactivada

Webhooks relevantes

• Webhook de cuentas: Notifica cambios en el estado de la cuenta
• Webhook de cargos: Notifica débitos realizados