Solicitar un token de cargo recurrente

https://api-uat.kushkipagos.com

POST

/subscriptions/v1/card/tokens

Esta funcionalidad está disponible para los siguientes modelos:
☑ Adquirencia
☑ Agregador

Aviso importante sobre transacciones con BBVA Perú 🇵🇪

A partir del 1 de enero de 2025, BBVA Perú solo aceptará transacciones con tarjeta que usen CVV dinámico, como parte de sus medidas para reforzar la seguridad de las transacciones en línea.

Solicita un token de cargo recurrente que luego puedes usar para crear el cargo recurrente de un cliente con el endpoint /subscriptions/v1/card.

Importante: Si usas esta opción para solicitar el token, asegúrate de cumplir con todos los requisitos PCI para manejar datos de tarjeta en tus servidores.

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, tendrás que solicitar un token nuevo.

¿Tienes una sugerencia sobre esta documentación? Contáctanos.

Request

Header Params

Body Params application/json

Examples

Responses

🟢201Created

application/json

TokenCreated

Bodyapplication/json

🟠400Bad Request

🟠402

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location '/subscriptions/v1/card/tokens' \
--header 'Public-Merchant-Id;' \
--header 'Content-Type: application/json' \
--data '{
    "card": {
        "name": "John Doe",
        "number": "4242424242424242",
        "expiryMonth": "03",
        "expiryYear": "25",
        "cvv": "071"
    },
    "currency": "USD"
}'

Response Example

201 - GL - Generated token

{
    "token": "AbCDef123456Z7Ghi8901234jkLMNopQ"
}

Modified at 2026-09-11 14:53:27

One-Click & Scheduled Payments

Crear un cargo recurrente

Solicitar un token de cargo recurrente

Esta funcionalidad está disponible para los siguientes modelos:#

Expiración del token#

Request

Responses

Esta funcionalidad está disponible para los siguientes modelos:

Expiración del token