1. Card-present payments
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
    • Webpay Plus Payments
      • Accept Payments through Webpay Plus
      • Reserve funds with Webpay Plus
    • 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 Webpay Scheduled Payments
      • Recurring Payments through Webpay OneClick
      • Reserve funds in subscriptions with Webpay OneClick
    • One Click Payments with Webpay OneClick
      • Webpay OneClick Payments
      • Reserve funds in one click payments with Webpay OneClick
    • 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
    • Banks and transaction details for bank transfer payments.
    • Receive Wire Transfers
    • Check the Status of a Transaction
  • Cash Payments
    • How do Cash Payments Work?
    • Accept a Cash Payment
    • Authorized locations
    • Error Codes for declined cash transaction
  • Money Disbursement
    • Wire Transfer
      • How does the dispersion by means of bank transfer work?
      • Payment Distribution to Bank Accounts
      • Error codes for transfer dispersions
  • 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
      • Webhook for Payments Made with Webpay Plus
    • Recurring Payments Webhooks
      • Webhook for Recurring Payments Made with Card
      • Webhook for recurring payments with Webpay OneClick
    • Payment Distribution Webhooks
      • Webhook for payment disbursement through wire transfer
    • 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. Card-present payments

Accept card present payments

Check out everything you need to start accepting card-present payments using a POS terminal
Card-present payments through a physical or digital card correspond to transactions conducted with your customer physically at the Point of Sale system (also known as POS). Through this device, you can streamline the transaction process with your customers and enable a fast service that allows them to:
Make purchases with physical or digital cards through different reading channels (NFC, chip, magnetic stripe).
Reduce the wait time for transaction processing.
Decrease the margins of error in charging or processing.
Simplify the process of cancellation or return of transactions made.
In this way, if you have a physical store, you can enable quick payments through Kushki’s services.

Features#

Features of card present payments.
Online compatibility: through the use of Kushki’s services, you can verify transaction information received and conducted by your merchant via digital or in-person means from the administration console.
Compatibility with multiple card readers: you can choose the certified card reader of your preference.
Secure and direct communication with Kushki: this service establishes direct communication between Kushki and your merchant, through the transmission of information via encrypted means over secure electronic channels on the Internet. The communication established towards Kushki’s services should be done from your backend.
Connection types: depending on your merchant needs and the technical capabilities of the terminals used, you can establish the internal connection of your terminals via bluetooth, Wifi, USB or internet.
Below are the steps to follow to start receiving card payments at your local business.

Step 1. Set up an account#

Create an account depending on the type of integration.
Raw card-present API: Contact our sales team so we can provide you with the best solution according to your business needs. Access the administration panel with your created account to obtain your integration credentials and view your merchant information.

Step 2. Scope of integration#

Depending on your business needs, choose one or more of the following integration types and available terminals to accept card-present payments.
Raw Card-Present API (Others): integrate your own terminals to process transactions through our payment network.
Please note that some types of integration will require you to be PCI compliant.

Step 3. Get test terminals#

Once you choose the integration type and terminal to use in your integration, it will be necessary to obtain test terminals to begin the development and testing process.
Some integration types and terminals may require additional configurations to target the test environment, so we recommend contacting our sales team to make sure you have everything you need to get started.
Note: In some cases, terminals that have been used for testing may not be able to be used for real payments. Learn more from your account manager.

Step 4. Configure your integration#

Obtain your credentials and access keys to perform the necessary tests in the development environment that will allow you to correctly integrate the terminals into your point-of-sale system.
Make the necessary adjustments to your system according to the type of integration and the desired operations, configure a webhook to receive notifications of events and perform tests to cover all available scenarios.

Step 5. Certification#

Certain types of integration require certification before you can go live to ensure everything is working properly.
After you have configured your integration and performed the necessary tests, validate the following steps with your account manager to perform the corresponding certifications.

Step 6. Go live#

Obtain your live environment credentials to begin accepting real payments with terminals once you have completed the necessary certifications (if applicable).
Obtain and configure the necessary terminals in your store, ensure they are pointed at the live environment, and make any final adjustments to your system.
Please contact your Account Manager to start your go-live process and obtain your credentials.
Modificado en 2026-10-12 16:00:58
Anterior
Card-present payments
Siguiente
Test data
Built with