La dispersión de dinero te permite enviar pagos a múltiples destinatarios de forma simultánea. A continuación te explicamos paso a paso cómo implementar esta funcionalidad en tu aplicación.

1

Crear un cliente

El primer paso es registrar al destinatario como cliente en nuestra plataforma. Esto te permitirá asociar sus datos bancarios y realizar operaciones a su nombre. Utiliza el endpoint Crear un cliente proporcionando la información necesaria.

2

Listar bancos

Obtén el listado actualizado de instituciones financieras disponibles para realizar transferencias. Esto te ayudará a validar que el banco del destinatario está soportado. Consulta el endpoint Listar bancos.

3

Crear una cuenta bancaria

Registra la cuenta bancaria del cliente donde se depositarán los fondos. Ten en cuenta que los campos de autorización solo son necesarios si planeas realizar débitos automáticos desde esta cuenta. Para más detalles, visita Crear una cuenta bancaria.

4

Crear un payout

Inicia la dispersión de fondos creando un payout que especifique el monto y destinatario. Utiliza el endpoint Crear una dispersión con los parámetros requeridos.

5

Escucha el webhook de dispersión

Mantente informado del estado de la transferencia implementando el Webhook de dispersión. Este te notificará cuando el pago se haya completado exitosamente o si ocurre algún error.

Importante: Asegúrate de almacenar de forma segura los identificadores (IDs) del cliente, cuenta bancaria y payout generados. Estos te permitirán realizar futuras operaciones y dar seguimiento a las transacciones de manera eficiente.

Asegurate de entender los tipos de dispersión que existen y que tipo de dispersión necesitas hacer.

  • INSTANT: Transferencia inmediata solo a personas naturales, estas deben tener una cuenta bancaria registrada en transfiya.
  • TURBO: Transferencia inmediatas (menos de 2 horas*) a personas naturales y jurídicas.
  • ACH: Transferencia con velocidades de 1 a 3 dias habiles.

*Dependiendo del banco del destinatario y la hora de la transacción, el tiempo de la transferencia puede variar.