Solicitar un token de tarjeta
https://api-uat.kushkipagos.com
https://api-uat.kushkipagos.com
POST
/card/v1/tokens
charge.Expiración del token
Los tokens expiran en 30 minutos y solo pueden usarse para una única transacción (incluso si la transacción salió mal). Cuando expire, deberás solicitar uno nuevo.
Nota: El token que entrega Kushki solo cifra y envía información. Si quieres guardar la información de la tarjeta para compras futuras, ve a la sección One-Click & Scheduled Payments.
Transacciones recurrentes*
transactionMode para solicitar un token de cargo recurrente que luego puedas usar para crear un cargo recurrente, así:initialRecurrence; así puede omitir el ingreso del CVV y hacer un cargo después con el flujo actual.NOTA: Si quieres procesar un cargo recurrente con un motor externo, debes omitir el envío del CVV.
¿Quieres validar una cuenta?*
transactionMode con el valor accountValidation para solicitar un token de validación de cuenta que luego puedas usar para verificar una cuenta con el endpoint card/v1/validation. Asegúrate de poner totalAmount en 0.Autenticación 3D Secure (3DS)*
| PROPIEDAD | VALORES POSIBLES | DESCRIPCIÓN |
|---|---|---|
| authValidation | url iframe | Define el tipo de integración que quieres para la autenticación 3DS. Usa url para redirección o iframe para incrustarla. |
| callbackUrl | string | Callback donde se enviará la respuesta de la autenticación 3D Secure. |
| PROPIEDAD | VALORES POSIBLES | DESCRIPCIÓN |
|---|---|---|
| url | string | URL que se debe usar para la autenticación 3D Secure. |
| secureService | 3dsecure | Indica el servicio de autenticación de la transacción. |
| secureId | string | ID de seguridad de la transacción. |
{
"token": "sBkQ7F110000tI1HVq116862fd5Ah3mG",
"url": "https://uat-auth.kushkipagos.com?token=sBkQ7F110000tI1HVq116862fd5Ah3mG&merchantId=306cb10581bb4acb9a2bfc77e163c482&bin=NDM0OTAwMzA=&callbackUrl=https://www.kushkipagos.com/callback/&isSandbox=false",
"secureService": "3dsecure",
"secureId": "1f5584db-0c5b-c729-a19c-6eb0283ca448"
}url vendrá la url que deberás mostrar al tarjetahabiente para la autenticación 3D Secure, si es necesario. Para más detalle, revisa la guía 3D Secure API authentication.NOTA: Para habilitar 3DS en modo de pruebas en tu comercio, se requiere una configuración adicional por parte de Kushki.
callbackUrl
callbackUrl, enviando los parámetros de la respuesta en la url (path parameters).Nota: El parámetro booleano successindica si la transacción se autenticó correctamente (true) o si hubo un problema con la autenticación 3D Secure (false). Si estrue, puedes continuar con el cargo. Si esfalse, el tarjetahabiente tendrá hasta 3 intentos para reintentar la autenticación antes de que la transacción sea declinada.
| PROPIEDAD | TIPO | DESCRIPCIÓN |
|---|---|---|
| success | boolean | Indica si la autenticación 3D Secure fue exitosa o no. |
| token | string | Token que devuelve Kushki para usarlo al hacer el cargo si la autenticación 3D Secure fue exitosa. |
| message | string | Si hay un problema durante la autenticación, aquí se devolverá el motivo. |
Ejemplo de callback con autenticación exitosa
https://www.tutienda.com/?success=true&token=cfa0bfec88324bd7a5c6c1ad9135a846Ejemplo de callback con problema de autenticación
https://www.tutienda.com/?success=false&message=Error%20en%20la%20validación%20de%203DS&token=cfa0bfec88324bd7a5c6c1ad9135a846Request
Header Params
Body Params application/json
Responses
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location '/card/v1/tokens' \
--header 'Public-Merchant-Id;' \
--header 'Content-Type: application/json' \
--data '{
"card": {
"name": "John Doe",
"number": "5451951574925480",
"expiryMonth": "08",
"expiryYear": "28",
"cvv": "121"
},
"totalAmount": 16.98,
"currency": "PEN"
}'Response Response Example
201 - Successful request
{
"token": "3c1518cf6f844e248880aad6187cf8d7"
}Modified at 2026-09-11 14:52:43