Reparte fondos desde tu plataforma mediante efectivo.Dispersar pagos con efectivo consiste en entregar dinero físicamente a tus clientes o dependientes. En otras palabras, supón que ofreces un servicio o producto y para llevarlo a cabo, necesitas ayuda de un tercero, a quien debes pagar por su servicio. La entrega del dinero, por el servicio brindado por el tercero, a través de este método de dispersión, facilita este proceso, ya que a través de una referencia se acerca al punto de pago más cercano a su ubicación y retira su dinero.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.
Asegúrate de recoger y enviar los nombres y apellidos completos del usuario en los parámetros name y lastName, tal y como se detalla en el siguiente ejemplo.
2. Inicializa la transacción#
Ahora es necesario utilizar el token obtenido para iniciar el proceso de dispersión con Kushki. Con este token, simplemente deberás realizar una llamada a nuestro endpoint de inicialización.La respuesta entrega un comprobante que sirve para que el usuario se acerque al punto de pago más cercano o de su preferencia, muestre la referencia y retire su dinero.Además, se entrega la información necesaria para que puedas generar un comprobante utilizando tu propio diseño.Ten en cuenta que generar un comprobante con tu propio diseño implicará una verificación más estricta por nuestros agentes en el proceso de certificación.
3. Consulta el estado de la transacción (opcional)#
Ahora que se ha generado el comprobante para que el usuario retire su dinero, puedes conocer el estado de la transacción ya sea mediante 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 retirado.Para configurar un webhook en 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 Get Transaction Status, en nuestra API. para consultar manualmente el estado de una transacción específica.4. Prueba tu integración#
Puedes usar el siguiente número de identificación de prueba en el ambiente UAT para asegurarte de que tu integración está lista. Úsalo con cualquier tipo de documento válido para tu país.Transacción aprobada: 123456789
5. 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 recibe notificaciones por webhook correctamente, responder a la solicitud con un status 200.
El botón de pago se deshabilita después del primer click.
El logo de Kushki debe ser visible para el cliente. Puedes encontrar nuestro logo en varios formatos aquí. Asegurar que en el cuerpo de la petición se envíen todos los campos requeridos en la referencia API. Se muestra el número de pin.
Se muestra el numero de convenio. (solamente si la respuesta del init lo contiene).
Se muestra la fecha máxima de expiración del comprobante.
Se muestran los puntos de pago donde el pin puede ser utilizado para retirar el dinero.
Se muestra el monto total.
Soluciones para front end (opcional)#
Kushki también provee de manera opcional, herramientas para que puedas desplegar un formulario de retiro en tu frontend, ayudando al proceso de tokenización. Útil por ejemplo cuando no quieres o no te es necesario guardar los datos de transacción de los usuarios. Ofrecemos dos soluciones para la tokenización de la información: Cajita y Kushki.js.Cajita#
Usa Cajita para simplicar tu integración y proporcionar una solución lista para usar y recopilar información del usuario de forma segura.Configura Cajita#
Incluye el script de kushki-checkout.js en tu página de pago añadiéndolo al <head> de tu archivo HTML. Siempre carga kushki-checkout directamente desde cdn.kushkipagos.com para mantener siempre cargado kushki-checkout.js directamente desde cdn.kushkipagos.com. No incluyas el script en un bundle o paquete ni hostees una copia de él.Añade Cajita a tu sitio web#
Cajita necesita un lugar donde vivir en tu página. Ingresa el siguiente código en el <body> de tu sitio donde quieras que se despliegue el formulario de pago.Recuerda configurar la acción del formulario action de acuerdo con el endpoint correspondiente en tu back-end, para obtener el token.Luego, añade el siguente tag script. Asegúrate de que el formulario se haya cargado.Esto creará un formlario pre-definido en tu página para aceptar pagos.Kushki.js#
Usa Kushki.js si necesitas un mayor control sobre el "look & feel" o apariencia de tu formulario de pago.Configura Kushki.js#
Opción 1 - CDN#
Usa el siguiente tag script al final del <body> en tu página de pagos.Option 2 - NPM#
Instala el paquete desde npm.Luego impórtalo en tu código utilizando el siguiente código.Configura el objeto Kushki#
Añade el siguiente código a tu aplicaciónPrimero, añade el formulario a tu página de pagos con los campos requeridos. Puedes diseñarlo de la forma que mejor te parezca.Luego, cuando el usuario envía el formulario, deberás solicitar el token y enviarlo a tu back-end.
Maneja tus dispersiones
Modifica o elimina tus transacciones de dispersión.Dispersión con transferencias bancarias
Dispersa tu dinero de forma segura a través de transferencias bancarias. 
