Reparte tu dinero a las cuentas bancarias de tus clientes.Dispersar pagos con transferencia consiste en entregar dinero a las cuentas de tus clientes. En otras palabras, si ya cuentas con la información bancaria de tus clientes, puedes usar tu cuenta de dispersión de Kushki para depositar directamente en sus cuentas a través de transferencia, usando la lógica que prefieras.Pago a proveedores o vendedores
Ten en cuenta que, debido a nuestras políticas de riesgo, los medios de pago disponibles y el tipo de integración pueden variar al momento en que formalices la afiliación. Te indicaremos cómo proceder en caso de que este proceso aplique para tu comercio.
Detalles de operación#
El proceso de dispersión en Colombia se realiza siguiendo el flujo que aparece a continuación: Comercio > Kushki > Banco > Usuario.| Parámetro | Detalle |
|---|
| Monto mínimo por transacción | 1,000 COP |
| Monto máximo por transacción | 13,900,000,000 COP (al mismo NIT) |
| Monto máximo por beneficiario | 13,900,000,000 COP al día |
| Horario de procesamiento con el procesador | Ciclos ACH |
| Horario de procesamiento API | 24/7 (Para envío de peticiones API a Kushki). |
| Inicio del procesamiento | Desde el momento en que Kushki deposita los archivos por corte al banco procesador |
| Tiempo de aprobación - mismo banco | Mismo día hábil operativo, dentro de los ciclos ACH |
| Tiempo de aprobación - otros bancos | Hasta 72 horas hábiles (sin contar sábados, domingos ni festivos) |
Nota Importante: La API de Kushki recibe y procesa las peticiones de transferencia 24/7, pero la transferencia real de los fondos está sujeta a los Ciclos ACH del sistema bancario colombiano, que solo operan durante días y horas hábiles.
Flujo#
El flujo que integrarás es el siguiente:Aquí aprenderás como integrar las dispersiones de dinero con transferencia.1. Obtén el listado de bancos asociados#
Es importante que te asegures de que todos los bancos a los que realizarás las transferencias se encuentren en el listado de bancos asociados. Te recomendamos realizar la consulta del listado los bancos asociados utilizando nuestro endpoint de listado de bancos.Ten en cuenta que cada banco tiene a un código identificador y este debe ser enviado en la solicitud de tokenizacion de la información. Campos obligatorios para obtener el token#
Ten en cuenta los campos requeridos en el cuerpo de la petición de token de transfer out:ACH — no envíes el campo name. En transferencias a cuenta bancaria (ACH), la solicitud del token es rechazada («Cuerpo de la petición inválido») cuando incluye el campo name. En transferencias Bre-B, el campo es opcional.
Dispersión a número de cuenta (accountType=CC,CA) |
|---|
- documentType
- documentNumber
-accountType
-accountNumber
- bankId
- totalAmount
- currency |
3. Inicializa la transacción#
En esta etapa, debes recibir el token obtenido e iniciar el proceso de dispersión con Kushki. Deberás realizar una llamada a nuestro endpoint de inicialización para iniciar el pago.La respuesta, entrega un número de ticket y el estado de la transacción.4. Consulta el estado de la transacción (opcional)#
Ahora que la transferencia está próxima a procesarse, puedes conocer el estado de la transacción utilizando webhooks o consultando manualmente utilizando nuestra APIWebhook#
El estado de la transacción se notifica automáticamente en el momento en el que el dinero ha sido entregado en la cuenta bancaria.Para configurar un webhook a tu comercio de prueba, es necesario que lo notifiques a nuestros agentes especificando la URL y el m étodo de pago, mediante correo electrónico.
API#
Puedes utilizar nuestro endpoint Get Status, en nuestra API para consultar manualmente el estado de una transacción específica.5. Prueba tu integración#
El resultado final de estos datos de prueba depende de la configuración de tu comercio: requiere que el ambiente de pruebas (sandbox) esté activo en tu comercio y que el procesador asignado admita simular ciertos estados. Si no obtienes el resultado esperado, escribe a tu ejecutivo de Kushki o a soporte.
Transacción aprobada: 123456789
Transacción declinada: 999999990
6. Prepara tu certificación#
Toma en consideración las siguientes pautas para aprobar la certificación técnica (requerida para obtener credenciales productivas):Los cálculos de los impuestos están correctos.
Mostrar mensajes en pantalla de acuerdo con las respuestas de Kushki.
Guardar y registrar todas las respuestas de Kushki (requeridas en caso de necesitar soporte).
Si no se requiere enviar el comprobante al correo del cliente, no se debe especificar el email en la solicitud del token.
Si se reciben notificaciones por webhook correctamente, responder a la solicitud con un status 200.
El botón de pago se deshabilita después del primer clic.
El logo de Kushki debe ser visible para el cliente. Puedes encontrar nuestro logo en varios formatos aquí. Asegurarse que en el cuerpo de la petición se envíen todos los campos requeridos en la referencia API.
Acepta webhooks
Maneja eventos poscobro de la manera correcta.Dispersión efectivo
Dispersa tu dinero de forma segura a través de efectivo. 
