Skip to main content

​
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

EstadoDescripción
PENDINGCuenta creada, pendiente de validación
VALIDATINGProceso de validación en progreso (para Daviplata con OTP)
ACTIVECuenta validada y lista para débitos
REJECTEDLa validación fue rechazada
INACTIVECuenta desactivada

​
Webhooks relevantes