Reparte tu dinero a las cuentas bancarias de tus clientes o proveedores.Dispersar pagos con transferencia consiste en entregar dinero a las cuentas de tus clientes. En otras palabras, si dispones de la información bancaria de estos, puedes usar tu cuenta de dispersión de Kushki y por medio de transferencia enviar el dinero a sus cuentas, 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 México se hace en la siguiente dirección: Merchant > Kushki > Procesador > Usuario.| Parámetro | Detalle |
|---|
| Monto mínimo | 1 MXN |
| Monto máximo | Sin límite |
| Tiempo en aprobarse una transacción | Inmediato (mismo banco y otros bancos) |
| Días de procesamiento | Los 7 días de la semana |
| Horario de procesamiento | 24/7 |
| Tipos de cuentas disponibles para abono | - Cuenta CLABE
- Tarjeta débito
- Número de celular**.
(Se envían en el request del token, parámetros accountType y accountNumber) |
** Para enviar pagos mediante número de celular, el destinatario de la transferencia debe haber asociado previamente su cuenta de depósito a su número de celular en su banco, ya sea mediante medios físicos (sucursal bancaria) o electrónicos (aplicación móvil del banco).El Banco S3 México, S.A. no está disponible para dispersión con transferencias bancarias.
Flujo#
El flujo que integrarás es el siguiente:Aquí aprenderás cómo integrar las dispersiones de dinero con transferencia.1. Obtén el listado de bancos asociados#
El primer paso es consultar el listado de bancos disponibles para realizar la transferencia. Para ello debes consumir este endpoint, el cual, te mostrará las instituciones bancarias disponibles para poder realizar la transacción.Como respuesta a esta llamada, recibirás el nombre (name) y el código (code) de los bancos disponibles. Este último debe ser enviado en la solicitud del token de transfer out.En caso de que no sepas el número de documento del destinatario, envía ND en el campo documentNumber.
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.Una vez inicializada una dispersión con transferencia no será posible anularla.
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 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.
La respuesta del webhook contendrá las variables processorStatus y processorStatusDescription dentro del objeto metadata con el el estado final de la dispersión: "metadata": {
"processorStatus": "LIQUIDADO",
"contractID": "AB123",
"processorStatusDescription": null
},
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 a soporte@kushkipagos.com. 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.
Número de cuenta: 646180110400000007
Número de identificación: 123456789
Tipo de identificación: CURP o RFC
Número de cuenta: 646180206800000003
Número de identificación: CADM9108029F4
Tipo de identificación: CURP o RFC
Número de cuenta: 646180206800000003
Número de identificación: CADM9108029G5
Tipo de identificación: CURP o RFC
Existen dos métodos para recargar fondos en tu cuenta de dispersión. El primero es a través de la Consola y lo puedes realizar siguiendo estas instrucciones.El segundo método es a través de soporte. Para recargar fondos para la fase de pruebas, envíanos un correo a integraciones@kushkipagos.com y para la fase de producción debes hacer una transferencia de fondos a la siguiente cuenta empresarial:Cuenta empresarial: 710969000045648227
Razón social: Kushki S D RL DE CV
NIT/Identificación: KUS1812121C1
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 pospago de la manera correcta. 
