Introducción a Cloud terminal API
Cloud terminal API te permite integrar de forma fácil y segura una terminal Ultra o Ultra P a tu sistema punto de venta (POS) a través de una API Rest. Puedes realizar operaciones de venta o de anulación con esta integración.
Características
Terminales
A continuación, la lista de terminales compatibles con integraciones Cloud terminal API:
Operaciones
Estas son las operaciones disponibles para integraciones a través de Cloud Terminal API:
Tarjetas
Las siguientes son las redes y marcas de tarjeta aceptadas a través de integraciones Cloud terminal API:
- Visa
- Mastercard
- Carnet
- American Express
- Sodexo
- Sí Vale
- Edenred
Requisitos
Antes de poder realizar una integración, deberás cumplir con los siguientes requisitos:
- Tener una cuenta de pruebas.
- Tener una terminal de pruebas compatible y configurada.
- Tener instalada y actualizada la aplicación de pagos en la terminal. Versión mínima de la aplicación: 4.3.26.
- Conexión estable a internet.
- Permitir la comunicación con nuestros servicios externos a través de firewalls y servicios similares.
Ambientes
Realiza todas las adecuaciones a tu sistema mediante pruebas en el ambiente de desarrollo dev
. Recuerda que en este ambiente no se procesarán transacciones reales.
Cuando estés listo, podrás cambiar al ambiente de producción live
para procesar transacciones reales.
Ambiente | Url base |
---|---|
dev | https://kushkicollect.billpocket.dev |
live | https://kushkicollect.billpocket.com |
Flujo
Conoce con más detalle el paso a paso durante el proceso de pago a través de Cloud Terminal API.
Solicitud de pago
Durante esta etapa del flujo:
- Tu sistema punto de venta se encarga de realizar una solicitud a la API de Kushki. Debes enviar la solicitud con la configuración de pago que aparecerá en la aplicación de pagos en la terminal.
- La API de Kushki recibe la solicitud con la información de pago para su procesamiento.
- La API devuelve una respuesta a la solicitud indicando el estado.
- Si la solicitud es correcta, se despliega la aplicación de pagos con la configuración enviada en la terminal.
Proceso de pago
Durante esta etapa del flujo:
- El cliente ingresa la información de pago en la terminal.
- La terminal se encarga de leer, cifrar y enviar la información de pago a Kushki para ser procesada.
- Kushki envía un webhook con el resultado de la operación.
- Continúa el flujo de acuerdo al resultado de la operación.