1. Pagos con tarjeta presente
Kushki Docs
Español
  • Español
  • English
  • Inicio
  • Inicio rápido
    • Últimas novedades
    • Preguntas frecuentes
    • Paso a producción
    • Política de cambios importantes del API
    • Datos de prueba
    • Códigos de error
  • Glosario de pagos
    • Glosario de pagos
  • Pagos únicos con tarjeta (Online)
    • Network Tokens
    • Marcas de tarjeta soportadas
    • Funcionalidades por modelo de negocio
    • Guía de integración Comisiones a terceros
    • ¿Cómo funcionan las Comisiones a terceros?
    • Pagos en un paso
      • Acepta un pago con tarjeta
      • Cargo directo (sin token)
      • ¿Cómo funcionan los pagos con tarjeta?
      • Acepta pagos únicos con OTP
      • Códigos de error autenticación OTP
      • Códigos de error pagos únicos con tarjeta
    • Pagos en dos pasos
      • Recibe pagos con autorización y captura
      • ¿Cómo funcionan los pagos únicos con autorización y captura?
    • Devoluciones
      • Devoluciones, anulaciones y reembolsos
    • Autenticación 3DS
      • Integración 3DS API + librería kushki.js
      • Introducción a 3DS
      • Integración 100% API de 3DS
      • Integración 3DS con librería kushki.js
      • Códigos de error autenticación 3DS
    • Pagos con Apple Pay
      • Configuración de Apple Pay
      • Pruebas en Sandbox Apple Pay
  • Pagos recurrentes con tarjeta (Online)
    • Autentica tus suscripciones con 3DS
    • Apple Pay en Suscripciones
    • Suscripciones externas a Kushki
    • Acepta pagos one click con 3DS
    • Funcionalidades por modelo de negocio
    • Códigos de error en cargos recurrentes
    • Pagos calendarizados
      • ¿Cómo funcionan los cargos recurrentes con tarjeta?
      • Maneja tus cargos calendarizados
      • Crea un cargo recurrente
    • Pagos OneClick
      • Genera pagos one click
      • Recibe pagos OneClick con autorización y captura
      • ¿Cómo funcionan los pagos OneClick con autorización y captura?
  • Pagos con tarjeta presente
    • Acepta pagos con tarjeta presente
    • Datos de prueba
    • Webhooks para tarjeta presente
    • Cloud Terminal API
      • Acepta pagos
      • Anula una solicitud de pago
      • Consulta el estado de una petición de cobro
      • ¿Cómo imprimir un ticket personalizado?
    • App-to-app
      • Acepta pagos
    • Transacciones
      • Anula un pago
      • Transacciones
    • Terminal SDK
      • Acepta pagos
    • Kushki One
      • Autenticación y Cifrado de Requests
      • Realiza cobros con Kushki One
      • Formato de montos en Kushki ONE
      • Impresión en terminal SmartPOS
      • Catálogo Unificado de Errores — Kushki ONE Connect
      • Servicios asíncronos y webhooks
    • Raw card-present API
      • Acepta pagos
      • Script de ejemplo para cifrar información
      • Intercambio de claves criptográficas
      • Preguntas frecuentes
      • Códigos de error para transacciones con tarjeta presente
    • Kushki One App de Pagos
      • Devoluciones y PreAuth & Capture
      • Procesa un cobro
      • Pago Dividido en la terminal
      • Consulta tus transacciones
      • Configuración del terminal
  • Pagos con transferencias
    • Bancos y detalles de operación para pagos con transferencia bancaria
    • Recibe transferencias bancarias
    • Consulta el estado de una transacción
  • Dispersión de dinero
    • Transferencia bancaria
      • Dispersa a cuentas bancarias
      • Códigos de error para dispersiones por transferencia
  • Plugins
    • Shopify
      • Operación del Plugin
    • Vtex
      • Guía de integración VTEX
  • Links de pago
    • Smartlinks
  • Formularios y botones de pago
    • Kajita
      • Kajitas de pago
      • ¿Cómo funciona?
    • Botón de pago
      • ¿Cómo funciona el botón de pago?
      • Genera un botón de pago
  • Administración de sucursales
    • ¿Cómo realizar el onboarding de subcomercios vía API?
  • Notificaciones
    • Buenas prácticas
    • Consulta tus webhooks
    • Webhooks para pagos únicos
      • Webhook para pagos únicos con tarjeta
      • Webhook para pagos únicos con transferencia bancaria
      • Webhook para pagos únicos con efectivo
    • Webhooks para dispersiones
      • Webhook para dispersión de dinero con transferencia
    • Webhooks para botón de pagos
      • Webhooks con Botón de pago
    • Webhooks para smartlinks
      • Webhooks con Smartlinks
    • Webhooks para pagos recurrentes
      • Webhook para pagos recurrentes con tarjeta
    • Webhooks para devoluciones
      • Webhook para devoluciones
      • Webhook para contracargos
HomeMexico 🇲🇽
Ecuador 🇪🇨Chile 🇨🇱Colombia 🇨🇴Peru 🇵🇪
HomeMexico 🇲🇽
Ecuador 🇪🇨Chile 🇨🇱Colombia 🇨🇴Peru 🇵🇪
Status
Soporte / Support
Español
  • Español
  • English
  1. Pagos con tarjeta presente

Cloud Terminal API

Producto en versión beta 🔐👨‍
Estamos trabajando en nuestra versión beta. ¡Manténte atento a su lanzamiento oficial! También puedes contactar a tu gerente de cuenta para más información.
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.
AmbienteUrl base
devhttps://kushkicollect.billpocket.dev
livehttps://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.
Flujo 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.
Recuerda que para que una terminal pueda recibir solicitudes debe estar en Modo integración, estar encendida y con una conexión estable a internet.

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.
Acepta pagosCobra con terminal POS en tu tiendaVer artículo →
Anula una solicitud de pagoCancela una solicitud de pagoVer artículo →
Consulta el estado de una petición de cobroConsulta el estado de una transacciónVer artículo →
¿Cómo imprimir un ticket personalizado?Imprime recibos personalizadosVer artículo →
Modificado en 2026-10-21 16:30:15
Anterior
Webhooks para tarjeta presente
Siguiente
Acepta pagos
Built with