1. Raw card-present API
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. Raw card-present API

Preguntas frecuentes

¿Cómo se envía el total de una transacción por API?#

El total de una transacción se debe enviar en el objeto amount. Este tiene diversos atributos y los parámetros a enviar varían dependiendo si aplican o no impuestos o propinas a la transacción:
ParámetrorTipoDescripciónValores /Defecto
currencystringRequerido. La moneda de la transacciónCLP MXN
ivanúmeroRequerido. Impuesto al valor agregado. Envíalo en 0 si la transacción no tiene este impuesto
subtotal_ivanúmeroRequerido. Monto neto de una transacción en la que se aplica el IVA o cualquier otro impuesto. (IVA, ICA, etc.) pero sin incluir el monto de la propina (si aplica). En caso de que la transacción no tenga ningún impuesto, establece este parámetro en 0 y envía el subtotal en el campo subtotal_iva0.
subtotal_iva0númeroRequerido. Envía en este campo el subtotal de la transacción si ésta no tiene ningún impuesto incluido. No incluyas aquí el monto de la propina (si aplica). En caso de que la transacción sí tenga impuestos, envía este parámetro en 0 y envía el subtotal en el campo subtotal_iva.
tipnúmeroOpcional. El monto de la propina. Omite este campo en caso de que no desees incluir una propina.
extra_taxesobjectoOpcional. Impuestos adicionales
airport_taxnúmeroOpcional. Tasa aeroportuaria
travel_agencynúmeroOpcional. Utilizado en aerolíneas
iacnúmeroOpcional. Impuesto de Industria y Comercio
icenúmeroOpcional. Impuesto a Consumos Especiales

Ejemplos#

Transacción en la cual aplica IVA#

Monto total = 100000 CLP

IVA = 19000 CLP

Total con IVA= 119000 CLP
"amount": {
  "currency": "CLP",
  "iva": 19000,
  "subtotal_iva": 100000,
  "subtotal_iva0": 0
}

Transacción exenta de IVA#

Monto total = 100000 CLP

IVA = 0 CLP

Total con IVA= 100000 CLP
"amount": {
  "currency": "CLP",
  "iva": 0,
  "subtotal_iva": 0,
  "subtotal_iva0": 100000
}

Transacción con IVA y propina#

Monto total = 100000 CLP

IVA = 19000 CLP

propina (tip) = 10000

Total con IVA= 119000 CLP

Monto total de la transacción (con IVA y propina incluídas)= 129000 CLP
"amount": {
  "iva": 19000,
  "tip": 10000,
  "currency": "CLP",
  "subtotal_iva": 119000,
  "subtotal_iva0": 0
}
Modificado en 2026-09-21 19:28:27
Anterior
Intercambio de claves criptográficas
Siguiente
Códigos de error para transacciones con tarjeta presente
Built with