1. One-time card payments (Online)
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. One-time card payments (Online)

Introduction to 3DS

This functionality is available for the following models:
☐ Aggregator

☑ Aggregator
Do you have your own 3DS authentication engine?
If so, please make sure to send the threeDomainSecure object in the payment request to proceed with the payment authorization.

Introduction#

For the security of your merchant, the Kushki fraud prevention team will request you to activate the 3DS authentication when receiving card payments.
By having the 3DS authentication service active, your customers will be requested to complete an extra verification step (from now on, challenge) with the card issuer to complete certain transactions. This challenge usually consists of an OTP sent by the bank to your customer's e-mail address or telephone number.

3DS Validation Availability#

Check below for the availability of 3DS validation with the affiliation and integration models available in Kushki.

By affiliation models#

3DS validation is available when processing transactions with the following card brands:

Aggregation/Gateway#

Credit and debit cards
VisaMastercardAmerican ExpressDiners
Colombia 🇨🇴        -       -        -
Chile 🇨🇱        -          -         -         -
Ecuador 🇪🇨 (Onlye Gateway)YesYes         -         -
Perú 🇵🇪YesYes          -          -
México 🇲🇽YesYes          -         -

Availability by integration method#

3DS validation is available in the following integration methods:
Shopify integration
Smartlink Integration
Kajita Integration
Android Integration (SDK)
iOS Integration (SDK)
Payment button integration
Kushki.js integration
Kushki.js Hosted Fields integration
API Integration

How does the 3DS authentication work?#

Once the user fills out the form and clicks on the Pay button, Kushki will validate if 3DS authentication is required for the transaction. If this validation is required, your customer will be displayed a challenge whose experience may vary depending on the brand and the issuing bank. When your customer completes the challenge, they will be able to finalize the transaction.
The 3DS authentication flow with Kushki is shown below:
3DS Flujo pagos únicos EN
Important
Keep in mind that, due to our risk policies, the available payment methods and the integration type may vary once you complete the affiliation. We will tell you how to proceed in case this process applies to your merchant.
This is what a payment with 3DS authentication will look like:
3DS

100% API integration
If you are a PCI-certified merchant or PSP, you will be able to authenticate your one-time card payments with 3DS by consuming our API.
Integration via Kushki.js
Use this option if you have implemented or plan to implement kushki.js in your front-end and want to authenticate your transactions with 3DS.
Modificado en 2026-10-14 19:46:29
Anterior
Supported card brands
Siguiente
Functionalities by business model
Built with