1. Raw card-present API
Kushki Docs
English
  • Español
  • English
  • Home
  • Quick Start
    • Frequently Asked Questions
    • Moving to Production
    • Policy for Important API Changes
    • Test Data
    • Error Codes
    • Latest Features
  • Payment Glossary
    • Payments Glossary
  • One-time card payments (Online)
    • Supported card brands
    • Functionalities by business model
    • Network Tokens
    • One-step Payments
      • How do Card Payments Work?
      • Accept a Card Payment
      • Direct charge (without token)
      • Accept One-Time Payments with OTP
      • OTP Authentication Error Codes
      • Error codes for single card payments
    • Two-steps Payments
      • How do one-time payments with authorization and capture work?
      • Receive payments with authorization and capture
    • Refunds
      • Returns, cancellations, and refunds
    • 3DS Authentication
      • Introduction to 3DS
      • 3DS API integration
      • 3DS integration with kushki.js library
      • 3DS API integration plus kushki.js library
      • 3DS Error Codes
    • Apple Pay Payments
      • Apple Pay Configuration
      • Apple Pay Sandbox testing
  • Recurring Card Payments (Online)
    • Functionalities by business model
    • External subscriptions to Kushki
    • Authenticate your subscriptions with 3DS
    • Accept one-click payments with 3DS
    • Error codes in recurring charges
    • Apple Pay for Subscriptions
    • Scheduled payments
      • How do Credit or Debit Card Payment Recurring Charges Work?
      • Create a recurring charge
      • Manage your Scheduled Charges
    • OneClick Payments
      • Accepting One-Click Payments
      • How does authorization and capture work in OneClick payments?
      • Receive OneClick payments with authorization and capture
  • Card-present payments
    • Accept card present payments
    • Test data
    • Webhooks for card present
    • Raw card-present API
      • Raw card-present API overview
      • Cryptographic key exchange
      • Sample script to encrypt information
      • Take Payments
      • Frequently Asked Questions
      • Error codes for card-present transactions
    • Transactions
      • Transactions
      • Cancel payments
    • Kushki One
      • First Steps
      • Autenticación y Cifrado de Requests
      • Accept payments with Kushki One
      • Amount Format
      • Async services and webhooks
      • Printing on SmartPOS terminal
      • Unified Error Catalog — Kushki ONE Connect
    • Kushki One Payment App
      • Overview
      • Process a payment
      • Split payment on the terminal
      • Refunds and PreAuth & Capture
      • Review Your Transactions
      • Terminal Setup
  • Wire Transfers
    • Shopping experiences and transaction details for bank transfer payments
    • Receive Wire Transfers
    • Check the Status of a Transaction
  • Cash Payments
    • Accept a Cash Payment
    • Authorized locations
    • Error Codes for declined cash transaction
  • Alternative payment methods (APM)
    • How do APM payments work?
    • Accept Yape payments
  • Money Disbursement
    • Wire Transfer
      • How does the disbursement through bank transfer work?
      • Payment disbursement to bank accounts
      • Error codes for transfer disbursements
    • Card
      • How does sending funds to cards work?
      • Send money to a card
      • Error Codes
  • Plugins
    • Shopify
      • Shopify
      • Plugin Operation
    • VTEX
      • VTEX Integration Guide
  • Payment Links
    • Smartlinks
  • Payment forms and buttons
    • Kajita
      • How Does it Work?
      • Payment Kajitas
    • Payment Button
      • Overview
      • Generate a payment button
  • Branch Offices Management
    • How to Onboard Submerchants via API
  • Notifications
    • Good Practices
    • Check your Webhooks
    • One-time Payments Webhooks
      • Webhook for One-Time Payments made with a card
      • Webhook for One-Time Payments by Wire Transfer
      • Webhook for One-Time Payments in Cash
    • Recurring Payments Webhooks
      • Webhook for Recurring Payments Made with Card
    • Payment Distribution Webhooks
      • Webhook for payment disbursement through wire transfer
      • Webhook for card disbursement
    • Payment button Webhooks
      • Webhooks with Payment Button
    • Smartlinks Webhooks
      • Webhooks with Smartlinks
    • Refunds Webhooks
      • Webhook for Voids and Refunds
      • Chargeback Webhooks
HomeMexico 🇲🇽Ecuador 🇪🇨Chile 🇨🇱Colombia 🇨🇴Peru 🇵🇪
HomeMexico 🇲🇽Ecuador 🇪🇨Chile 🇨🇱Colombia 🇨🇴Peru 🇵🇪
Status
Soporte / Support
English
  • Español
  • English
  1. Raw card-present API

Frequently Asked Questions

How is the total of a transaction sent in an API request?#

The total of a transaction must be sent in the amount object. This has several attributes and the parameters to send vary depending on whether or not taxes or tips are applied to the transaction:
ParameterTypeDescriptionValues /Default
currencystringRequired. The currency of the transactionCLP MXN
ivanumberRequired. Value added Tax (VAT). Send it in 0 in case the transaction does not include this tax
subtotal_ivanumberRequired. Net amount of a transaction where iva or any other tax applies. (iva, ica, etc.) but not including the amount of the tip (if applicable). In case the transaction does not have any tax, set this parameter to 0 and send the subtotal in the subtotal_iva0 field
subtotal_iva0numberRequired. Send in this field the subtotal of the transaction if the transaction does not have any tax included. Don't include the amount of the tip (if applicable). In case the transaction does have taxes, set this parameter to 0 and send the subtotal in the subtotal_iva field
tipnumberOptional. The amount of the tip. Skip this field in case you don't want to include a tip.
extra_taxesobjectOptional. Additional taxes
airport_taxnumberOptional. Airport tax
travel_agencynumberOptional. Used in airlines
iacnumberOptional. Industry and Trade Tax
icenumberOptional. Special Consumption Tax

Examples#

Transaction where IVA (VAT) applies#

Net amount = 100000 CLP

iva = 19000 CLP

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

IVA (VAT) exempt transaction#

Net amount = 100000 CLP

iva = 0 CLP

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

Transaction where IVA (VAT) and tip applies#

Net amount = 100000 CLP

iva = 19000 CLP

tip = 10000

Total with iva= 119000 CLP

Total amount of the transaction (with iva and tip included)= 129000 CLP
"amount": {
  "iva": 19000,
  "tip": 10000,
  "currency": "CLP",
  "subtotal_iva": 119000,
  "subtotal_iva0": 0
},
Modificado en 2026-09-25 15:33:47
Anterior
Take Payments
Siguiente
Error codes for card-present transactions
Built with