Acepta un pago en efectivo

Esta opción de pago es la ideal para aquellos clientes que quieren adquirir los productos o servicios disponibles en tu sitio web, pero que no poseen una tarjeta o cuenta bancaria. Para ello, es necesario que captures los datos básicos de tu cliente, con el fin de generar una referencia o "voucher", con el que tu usuario podrá realizar el pago en un punto físico de la entidad de recaudo que seleccione.

El flujo de pago que integrarás es el siguiente:

1. Configura tu Front-end#

La responsabilidad del front-end es recolectar los datos principales del usuario, tokenizar esta información a través de los servidores de Kushki y luego enviarla al back-end para iniciar el proceso de pago.

Para ello cuentas con dos opciones: Kajita y Kushki.js.

Kajita#

Kushki cuenta con formularios de pago listos para recopilar información de tarjeta de forma segura. Podrás usar cualquiera de nuestras versiones:

Crea y personaliza tus Kajitas#

Con Kushki puedes crear tus Kajitas desde la Consola de administración. Haz clic aquí para aprender cómo hacerlo.

Configura Kajita#

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. No incluyas el script en un bundle o paquete ni hostees una copia de él.

Añade Kajita a tu sitio#

Kajita necesita un espacio dentro de tu página. Ingresa el siguiente código en el <body> de tu sitio donde quieras que se despliegue el formulario de pago.

Para Kajita (v.2):

Para Cajita (v.1)

Recuerda configurar la acción del formulario action de acuerdo con el endpoint correspondiente en tu back-end, para obtener el token.

Luego, agrega el tag script.

Para la Kajita (v.2) Podrás obtener dicho script desde tu Consola de Administración según lo explicado aquí.

Para la v.1 (Cajita), añade el siguiente script y asegúrate de que el formulario se haya cargado:

Esto creará un formulario predefinido 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.

Opción 2 - NPM#

Instala el paquete desde npm.

Luego impórtalo en tu código utilizando el siguiente código.

Configura el objeto Kushki#

Agrega el siguiente código a tu aplicación

Recolecta la información del usuario y envíala a tu back-end#

Primero, añade el formulario a tu página de pagos con los campos requeridos. Puedes diseñarlo como prefieras.

Por ejemplo:

Luego, cuando el usuario envía el formulario, deberás solicitar el token y enviarlo a tu back-end.

2. Configura tu back-end#

La responsabilidad del back-end es recibir el token obtenido desde tu front-end e iniciar el proceso de pago con Kushki.

Cuando el usuario envía el formulario, tu front-end transfiere un token al endpoint que hayas especificado. Con este token, deberás realizar una llamada a nuestro endpoint de cobros para iniciar el cobro.

De acuerdo a la respuesta del consumo del método para iniciar la transacción, redirecciona al usuario a la URL del PDF del voucher para que tu cliente pueda descargarlo e imprimirlo y así realice el pago en el punto físico de la entidad de recaudo que seleccione.

3. Prueba tu integración#

Existen números de identificación de prueba que puedes utilizar en el ambiente UAT para asegurarte de que tu integración está lista.Úsalos en la solicitud del token (front-end) para simular cualquier estado:

4. Prepara tu certificación#

Toma en consideración las siguientes pautas para aprobar la certificación técnica (requerida para obtener credenciales productivas):

Si estás utilizando Kushki.js, asegúrate que:

Si diseñas tu propio comprobante, valida que:

---