Request a recurring charge token

POST

/subscriptions/v1/card/tokens

This functionality is available for the following models:
☑ Acquirer
☑ Aggregator

DANGER

Important Notice about Transactions with BBVA Peru 🇵🇪

Starting January 1, 2025, BBVA Peru will only accept card transactions with dynamic CVV as part of its measures to enhance the security of online transactions.

Request a recurring charge token that can later be used to create a recurring charge of a customer using the /subscriptions/v1/card endpoint.

Important to consider: If you are using this option to request the token, be sure to comply with all the PCI requirements to handle card data on your servers.

WARNING

DANGER

Token expiration
Tokens will expire in 30 minutes and can be used only for a single transaction (even if the transaction was wrong). You will need to request a new token when it expires.

Got a suggestion on this documentation? Contact Us.

Request

Header Params

Body Params application/json

Examples

Responses

🟢201

application/json

TokenCreated

Body

🟠400

🟠402

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api-uat.kushkipagos.com/subscriptions/v1/card/tokens' \
--header 'Public-Merchant-Id;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "card": {
        "name": "John Doe",
        "number": "4242424242424242",
        "expiryMonth": "03",
        "expiryYear": "25",
        "cvv": "071"
    },
    "currency": "CLP"
}'

Response Example

201 - GL - Generated token

{
    "token": "AbCDef123456Z7Ghi8901234jkLMNopQ"
}

Modified at 2026-04-16 17:50:42

Preauthorization (tokenless)

Update recurring charge card data

Request a recurring charge token

This functionality is available for the following models:#

Token expiration#

Request

Responses

This functionality is available for the following models:

Token expiration