1. Quick Start
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. Quick Start

Latest Features

Do you always want to be up to date with our latest features? Find here the releases, upgrades, fixes and new articles that will make your day-to-day life
with Kushki easier.

September 2026#

Network Tokens. 🚀 New functionality / Card payments. You can now ask Kushki to also create a network token when it tokenizes the card during a charge or pre-authorization. It is enabled on demand through a commercial agreement. Learn how it works in the Network Tokens guide and check the charge reference.
Fraud alerts query. 🚀 New functionality / Card payments. Query the fraud alert records from VISA (TC40) and Mastercard (SAFE) through the API, without waiting for a file to be delivered manually. Check the Query fraud alerts endpoint.

August 2026#

Kushki One: asynchronous services and webhooks. 🚀 New functionality / Card-present payments. Terminal payment operations now have an asynchronous variant that does not block your system, and you receive a webhook notification on every status change of the transaction. Learn about asynchronous services and webhooks, split payments on the terminal and the amount format. Also check the Kushki One release notes.

June 2026#

Apple Pay Sandbox testing. 📚 New guide / Card payments, Apple Pay. Test your integration before going live with the Apple Pay Sandbox testing guide.

May 2026#

Apple Pay for subscriptions. 📚 New guide / Recurring payments, Apple Pay. Learn how to charge subscriptions with Apple Pay in the Apple Pay for subscriptions guide.

April 2026#

Kushki One. 🚀 New functionality / Card-present payments. Launch (Beta) of Kushki One Connect, to integrate your point-of-sale software with SmartPOS terminals: payments, terminal printing and a unified error catalog. Start with Getting started, Take payments, request authentication and encryption and the terminal payment app.
Settlements, subscription transactions and platform status. 🚀 New functionality / Queries. Three new endpoints: settlement query in JSON, subscription transactions and platform status.

March 2026#

Chargebacks API (Beta). 🚀 New functionality / Chargebacks. Query your chargebacks through the API (status, deadlines and risk level) and request asynchronous exports. Check the chargebacks reference.

February 2026#

Apple Pay configuration. 📚 New guide / Card payments, Apple Pay. Learn how to configure Apple Pay to accept payments from Apple devices.

October 2025#

Merchant installments (Cuotas Comercio) in online payments (Beta). 🚀 New functionality / Card payments, Recurring payments. Offer your customers installment payments of 2 to 12 months where the merchant absorbs the installment cost. Available in charges and pre-authorizations, and in one-click payments for existing subscriptions. Check the charge reference.

September 2025#

Card payouts. 🚀 New functionality / Payouts. New product for Chile: send money directly to Visa debit or credit cards, ideal for refunds, commissions or reimbursements. Find the details in the Online Payments release notes.
Idempotency in Online Payments. 🚀 New functionality / Card payments. You can now safely retry voids, refunds and subscription pre-authorizations without the risk of processing the same transaction twice, even after timeouts or network failures. Learn how it works in the Card payments reference.
VTEX integration guide. 📖 Updated Guide / Plugins. We updated the guide to accept card payments and bank transfers with the Kushki plugin in your VTEX store. Check the VTEX integration guide.

April 2025#

Reversals without the physical card. ⚙️ Improvement / Card-present payments. You can now make same-day reversals without the physical card, always for the full transaction amount. Check the Card Present release notes.

February 2025#

Get Transactions List v2. 🚀 New functionality / Queries. It now covers card-present and card-not-present transactions, filters by payments and payouts, and returns the most recent first. Check Get Transactions List v2.
Merchant installments (Cuotas Comercio) in card-present payments (Beta). 🚀 New functionality / Card-present payments. Offer installments of 2 to 12 months where the merchant absorbs the cost. Available in Beta for Chile; contact the Kushki team to enable it. Check the Card Present release notes.

October 2024#

OTP authentication error codes. 📚 New guide / Card payments. Check the OTP authentication error codes.

September 2024#

Card payment error codes. 📚 New guide / Error codes. Check the error codes for one-time payments and recurring charges to show the right message to your customers.
Card-Present Raw API. 🚀 New product/ Card Present Payments. Connect your POS terminals to our new card-present payment processing API. Check here the API reference or consult our integration guides.

July 2024#

Kushki.js Hosted Fields. 🚀 New functionality / Card payments, One-Click Payments, Recurring payments, Authorization and capture. Introducing Kushki.js Hosted Fields, our new front end library that allows you to make payments in your web application easily, quickly and securely.
Check out the guide on how to implement Kushki.js Hosted Fields for Accept a Card Payment, Accept One-Time Payments with OTP, authenticate transactions using 3D Secure from your front end, authenticate transactions using 3D Secure from your front end and back end, receive payments with authorization and capture, create a recurring charge and how to generate one click payments.
Check out the full Kushki.js Hosted Fields reference.

June 2024#

Present Card. 🚀 New functionality / Present Card. The Present Card documentation for accepting physical payments with certified terminals using Kushki API is enabled in Beta version. Check here the documentation.

October 2023#

Webhooks. 📖 Updated Guide / Notifications, Webhooks. At Kushki we make sure you receive a callback from Webhook to keep you up to date with the transactions you receive. For this reason, learn about our Webhooks Retry Policy.

August 2023#

3DS. 🚀 New feature / 3DS. Kushki now supports 3DS 1.0 and 2.0 authentication (depending on the issuer) for Visa and Mastercard brands. This validation is applicable to one-time and recurring card payments.
Branch Office Management. 🚀 New feature / Console. If your merchant has different branches, now you can manage your information from a single platform, saving time and facilitating the their integration. For more information, check our guides Branch Office Configuration and Branch Offices Creation and Updating.

July 2023#

VTEX. 🚀 New feature / Plugins. Now, you can accept card, cash, or transfer payments at your Vtex store with Kushki. If you want to know more about our new plugin, check out our Introduction and integration guide.

March 2023#

Webhooks with Payment Button. 📚 New guide / Notifications, Webhooks, Card payments, Transfer payments, Cash payments. Check this guide for the structure of webhooks sent by Kushki when making a payment via a Payment Button.

February 2023#

Shopify. 🚀 New feature / Plugins. Kushki now accepts payments with Shopify, allowing making transactions in a safe and quick manner, without writing a single line of code. If you want to learn more about our new plugin, check out our Introduction and integration guide.
Payment Distribution to Bank Accounts. 🚀 New functionality / Transfer Out. Now you will be able to disperse money to your users through bank transfers. Learn more about the process here, or check out the step-by-step in this guide.

January 2023#

Webhooks. 💻 Update / Notifications, Webhooks, Card payments, Transfer payments, Cash payments. You can now receive notifications (webhooks) for each transaction by sending the webhooks object from your back-end. For more information, check our webhooks and Check your webhooks guides.

November 2022#

iOS SDK Version. 💻 Update / iOS, Card Payments, One-Click Payments, Transfer payments, Cash Payments, Recurring payments, Webpay Plus, Webpay OneClick. Documentation related to iOS SDK version 2.4.2 has been updated. For more information, please check our guides on Accept a Card Payment, Accept Payments through Webpay Plus, Accepting One-Click Payments, Webpay OneClick Payments, Reserve Funds in a Card, Receive Wire Transfers, Accept a Cash Payment, Create a recurring charge and Recurring Payments through Webpay OneClick.

October 2022#

Generate a payment button. ⚙️ Improvement / Payments with Webpay. Changed the payment methods you can use in a payment button. Now you can receive debit card payments through Transbank's Webpay.
Banks and transaction details for bank transfer payments. 💻 Update / Transfer In. Payments with bank transfers in Chile must be made from personal accounts and not from company accounts.

September 2022#

Receive wire transfers. ⚙️ Improvement / Web, IOS, Android, Payments through transfers. Several changes were made improving the user experience, when making a payment by wire transfers.

August 2022#

Authorization and capture with Webpay. 🚀 New functionality / Authorization and capture. The authorization and capture service is enabled for payments with Webpay Plus, for one click payments with Webpay OneClick and for recurring payments with Webpay OneClick. Among other advantages, this functionality allows you to make two-step payments with debit cards through Webpay.
How does it work?. 📖 Updated guide / transfer in and cash in. Restructured the overview articles of the transfer in and cash in integrations for all countries.

July 2022#

Webhook for Webpay Plus payments 📚 New guide / Webhooks,Notifications. Now you can always keep track of the status of your Webpay Plus payments as Kushki can send you notifications via webhooks every time a transaction is generated and its status changes. Click here for more information.

February 2022#

WooCommerce Plugin. 📖 Guide Updated /Plugins. We include the section plugin operation : what are the different states of an order, how to process payments via authorization and capture or single payment, plus how to request a refund. Click here for more information.

January 2022#

Payment button. 🚀 New feature / Payment button| The new Kushki payment button integrates with your web or website to receive card, cash or transfer payments in a shopping experience controlled by Kushki, quickly and securely. Learn more about it here.

December 2021#

Magento plugin update. 💻 Update /Plugins.
The Magento plugin now supports more payment methods and you can customize the appearance of the payment form from your Administration Console. Click here for more information.
Prestashop plugin update. 💻 Update /Plugins.
The Prestashop plugin now supports more payment methods. Also, you can customize the appearance of the payment form from your Administration Console. Click here to learn more.

November 2021#

Payment Glossary. 📖 Guide Updated / glossary. We have updated our payment glossary. There you will find common terms used in the industry and in Kushki products. Check it out here.
Collection points. 📚 New guide / cash payments. Check here the different cash reception points available with Kushki, as well as the expiration dates of the payment vouchers and the minimum and maximum amounts allowed.
Supported brands. 📚 New guide / card payments. In this guide you will find a summary of the brands supported by country as well as the operations allowed.

October 2021#

Manage your credentials. 🚀 New feature / credentials| With the new Credential Master user role, you can easily create, edit, or delete credentials of your main and your secondary businesses. This feature is available only on demand, from the Console or through our API. Find here our guides for more information.

September 2021#

Returns, cancellations, and refunds. 📚 New guide / returns cancellations refunds
Learn how to cancel a payment or request a refund for your customers through API or from your Administration Console.
Webhook cancellations. 📚 New guide cancellations refunds
Check this new guide to learn about the structure of the notifications (via webhooks) sent by Kushki when a cancellation or refund is approved for your customers.
New Kajita of payments. ⚙️ Upgrade / Solutions for front-end.
With the new version of our payment form: Kajita, you can have several ready-to-use forms in your integration and customize them from your Administration Console. Find here our guides for more information.

August 2021#

Deferred payments. ⚙️ Upgrade / On-Demand Payments.
In the event that you wish to accept installment payments on one-click on-demand purchases, you may now send the deferred object, which contains the number of installments, when you charge. Check our integration guide for more information.
Installment payments with Webpay OneClick. ⚙️ Upgrade / On-Demand Payments.
In the event that you wish to accept installment payments when receiving one-click on-demand payments, you only need to send the deferred object when you charge. Check our integration guide for more information.
WooCommerce plugin update. 💻 Update /WooCommerce.
The WooCommerce plugin now supports more payment methods and you can customize the appearance of the payment form from your Administration Console. Click here for more information.

July 2021#

Webhooks of chargebacks. 🚀 New feature / Notifications.
Now you can always keep track of the status of your chargebacks, since Kushki can send you notifications via webhooks every time a chargeback changes status. Click here for more information.
Check the status of your webhooks. ⚙️ Upgrade /Notifications Console.
We have added a new option when setting up webhooks from the Administration Console called Connection status. With this, you will be able to verify whether the URL linked to a certain webhook is working or not.

June 2021#

Test data. 📚 New guide.
Find here a full list of card numbers and credentials so that you test different scenarios while performing your integration with Kushki
New error codes. 📖 Updated guide / Error codes.
We included new error codes in our catalog. Use them to display the appropriate messages to your customers during their payment experience.
Modificado en 2026-10-19 16:59:26
Anterior
Error Codes
Siguiente
Payment Glossary
Built with