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

Solicita un token de cargo recurrente que luego puedes usar para crear un 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 fue errónea). Tendrás que solicitar un token nuevo cuando expire.

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 'https://api-uat.kushkipagos.com/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": "COP"
}'

Response Example

201 - GL - Generated token

{
    "token": "AbCDef123456Z7Ghi8901234jkLMNopQ"
}

Modified at 2026-09-11 15:04:40

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