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
    • Introduction to 3DS
    • Functionalities by business model
    • How do third party commissions work?
    • Integration guide Third Party Commissions
    • One-step Payments
      • How do Card Payments Work?
      • Accept a Card Payment
      • Accept One-Time Payments with OTP
      • OTP Authentication Error Codes
      • Error codes for single card payments
    • Scheduled payments
      • How do Credit or Debit Card Payment Recurring Charges Work?
      • Create a recurring charge
      • Manage your Scheduled Charges
    • Refunds
      • Returns, cancellations, and refunds
    • 3DS Authentication
      • 3DS API integration
      • 3DS integration with kushki.js library
      • 3DS API integration plus kushki.js library
      • 3DS Error Codes
  • Recurring Card Payments (Online)
    • Functionalities by business model
    • Error codes in recurring charges
    • Authenticate your subscriptions with 3DS
    • External subscriptions to Kushki
    • OneClick Payments
      • Accepting One-Click Payments
  • Wire Transfers
    • How do Payments by Wire Transfers Work?
    • 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
  • 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 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

Frequently Asked Questions

Check our quick answers to frequently asked questions

How can I get a test account?#

You can apply for a free test account from our website. Once your application has been accepted, Kushki will grant you access to the console, an online panel where you can manage your Kushki integration for a specific country.

I have built an integration for several countries, can I use the same test account?#

If you are developing an integration for several countries, we recommend you to create an account for each one of them. In this way, you can run tests with the local configuration and currency.

Does Kushki allow processing of international cards?#

Kushki allows you to process international cards in certain cases. Contact your sales representative or visit our Support Center for more information on how to do this.

Can I use my test account after obtaining my productive account credentials?#

Yes, you can do it. Your test account will not be disabled once you receive your productive account credentials.

What should I do once my integration is completed?#

A technical certification is required. Get in touch with us to schedule a certification session where we will perform some tests to verify that your integration runs as expected.

What is tokenization?#

Tokenization is a process by which Kushki transforms sensitive customer data into an alphanumeric code called token. When you use a token, it's not necessary to manage such data directly, and you can make any transaction safely.

Does the token expire?#

Yes, it expires. A token has a life span of 30 minutes and can only be used once.

Does Kushki have a pre-designed form for customers to enter payment information?#

Yes, it's called Cajita (Little Box). If you import Cajita on your front end, you will have a pre-designed form. The form will change according to the payment method.

Can I design my own front end form?#

Yes, you can do it. You are free to design your own form with the colors and logos of your choice. After obtaining data from your client, you just need to request a token by using one of Kushki's front end libraries. Check our web guides for more details.

What do I need to have in mind when designing my own form for credit card payments?#

Below you will find a list of the validations you need:
The cardholder's name is required.
The credit card number field only allows numbers.
The credit card field allows a maximum of 16 digits (it may be less).
The credit card number is required.
The CVV field only allows numbers.
The CVV field allows no more than 4 numbers (they may be 3).
A CVV is required.
The CVV will be masked so it cannot be read; each character is replaced with symbols such as asterisks (*) or points (-).
The expiry date must be a valid date (current or future month and year).
An expiry date is required.
The Pay button is disabled after the first click.

If I use Cajita, do I have to contact you to obtain a token?#

It is not necessary. Cajita already has built-in tokenization logic. After clicking the Pay button, the Cajita will give you a token.

Can Kushki send a payment confirmation to my integration service?#

Yes, it can. We offer you notifications via Webhooks. Check our guidelines on this topic.

How can I configure my Webhook URL in Kushki?#

Please, get in touch with us contact with us; our team will need your service's URL as well as the public ID of your business.

What do I need to receive a notification through my Webhook?#

Your Webhook should have the capacity to receive POST requests. It is also important to have a SSL certificate. If you receive notifications correctly, please send us back a 200 status code.

What if my Webhook temporarily fails?#

If we receive an error response when we try to notify your service, we will try again every 5 minutes, during the next 5 hours of the initial report.
Modificado en 2026-10-14 19:46:03
Anterior
Quick Start
Siguiente
Moving to Production
Built with