Autentica tus suscripciones con 3DS
¿Tienes tu propio motor de autenticación 3DS?
Importante
Importante
Disponibilidad de validación 3DS con suscripciones
Por modelos de afiliación
Adquirencia
Tarjeta de crédito y tarjeta de débito
| VISA | MasterCard | CARNET |
|---|---|---|
| Soporta ✅ | Soporta ✅ | No soporta ❌ |
Por métodos de integración
| Soporta ✅ | No soporta ❌ |
|---|---|
| Integración con Smartlink (pagos calendarizados) | Integración vía API |
| Integración con Kajita | Integración con Shopify |
| Integración Android (SDK) | |
| Integración iOS (SDK) | |
| Integración con botón de pago | |
| Integración Kushki.js | |
| Integración Kushki.js Hosted Fields |
¿Cómo funciona la validación 3DS?
Marcas soportadas en 3DS
¿Quieres recibir pagos con 3DS?
1. Configura tu front-end
Kushki.js
requestSubscriptionToken() se verá de esta manera:| Parámetro | Tipo | Descripción |
|---|---|---|
authRequired | Booleana | Este campo te indica si se requiere o no challenge de 3DS. |
acsURL | URL | Hace referencia a la URL de la página del reto que el usuario debe pasar (Access Control System). |
specificationVersion | String | Se refiere a la versión de 3DS aplicable. |
authenticationTransactionId | String | ID de la transacción verificada desde las marcas. |
paReq | String | Significa Payer Authentication Request. Es un campo codificado en base64 que contiene información de tu comercio y del tarjetahabiente y que se envía al emisor para la autenticación Nota: en caso de estar haciendo pruebas en ambiente UAT, se debe enviar sandbox. |
¿Obtienes el token desde tu back-end?
1.
2.
jwt.3.
jwt obtenido en el paso 2.4.
secureService, secureId y el objeto security (expecificadas en la tabla anterior).5.
requestValidate3DS para hacer la validación 3DS, tal y como se explica a continuación.security a Kushki consumiendo el método requestValidate3DS :authRequired es igual a true el modal para validación de 3DS será presentado y tu cliente entonces recibirá el valor a ingresar por correo electrónico o mensaje de texto.authRequired es igual a false no se presentará el modal para validación de 3DS.callback será:{
isValid: true
}callback será algo como:{
"message":"error-message",
"code":"error-code"
}Kushki.js Hosted Fields
requestToken() para solicitar un token, si existe una regla 3DS y se cumple la condición, el método requestToken() desplegará el modal para que el cliente pueda ingresar los datos de la validación 3DS.isSubscription con el valor de true para generar una suscripción. Si el método initCardToken() se configuró como suscripción, deberás llamar al endpoint de crear un cargo recurrente desde tu back-end, en lugar de realizar un pago único con el token obtenido.| CÓDIGO | MENSAJE | EJEMPLO | DESCRIPCIÓN |
|---|---|---|---|
| E004 | Error en solicitud de JWT | { code: "E004", message: "Error en solicitud de JWT" } | Si el comercio tiene habilitada una regla para 3DS y hubo un error al solicitar el JWT, se regresará el código E004. Por favor, vuelve a intentar; si el error persiste, contacta a soporte de Kushki. |
| E005 | Campos 3DS inválidos | { code: "E005", message: "Campos 3DS inválidos" } | Si el comercio tiene habilitada una regla para 3DS y hubo un error en la autenticación 3DS, se regresará el código E005. Por favor, vuelve a intentar asegurándote de ingresar correctamente los datos para la validación 3DS. |
| E006 | Error en solicitud de validación de token | { code: "E006", message: "Error en solicitud de validación de token" } | Si el comercio tiene habilitada una regla 3DS y hubo un error en la sesión de validación 3DS, se regresará el código E006. Por favor, vuelve a intentar asegurándote de ingresar correctamente los datos para la validación 3DS; si el error persiste contacta a soporte de Kushki. |
2. Configura tu back-end
3. Prueba tu integración
1234 como código de validación.445652808038986044565292672342004456529165328302445652486977025544565233400699564456540000000063445654337171331444565419820686154456541249811088Importante
4. Prepara tu certificación
Modificado en 2026-09-21 22:20:28