Introducción a Cloud terminal API

06 agosto 2025

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:

• Ultra
• Ultra P

Operaciones

Estas son las operaciones disponibles para integraciones a través de Cloud Terminal API:

• Venta
• Propina
• Pagos diferidos
• Búsqueda de transacciones
• Cancelaciones y devoluciones

• Impresión de tickets personalizados

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.

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:

1. 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.
2. La API de Kushki recibe la solicitud con la información de pago para su procesamiento.
3. La API devuelve una respuesta a la solicitud indicando el estado.
4. 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:

1. El cliente ingresa la información de pago en la terminal.
2. La terminal se encarga de leer, cifrar y enviar la información de pago a Kushki para ser procesada.
3. Kushki envía un webhook con el resultado de la operación.
4. Continúa el flujo de acuerdo al resultado de la operación.