External subscriptions to Kushki

October 10, 2025

Manage your subscriptions externally and charge with Kushki

Kushki allows on-demand payments using tokenized credentials outside of the platform (for example, by an orchestrator or external subscription engine). To use this functionality, the merchant must have PCI DSS certification and properly manage the security, storage, and use of the card token.

Usage Conditions

Applies in	Available	Integration Method
Colombia 🇨🇴 México 🇲🇽 Chile 🇨🇱 Perú 🇵🇪	☑ Acquirer ☐ Aggregator	API
Ecuador 🇪🇨	☐ Acquirer ☑ Aggregator	API

Steps to integrate charges via external recurrence engine

1. Request the service activation from Kushki

Contact your account executive to enable the option for external subscription charges without CVV.

2. Request a card token without CVV

Send a tokenization request excluding the cvv. field.

{
   "card": {
       "name": "John Doe",
       "number": "5451951574925480",
       "expiryMonth": "05",
       "expiryYear": "25"
   },
   "totalAmount": 50,
   "currency": "USD"
}

3. Perform the charge

To process a charge as a recurring payment, you must include the externalSubscriptionID field containing the subscription ID from your external engine up to 20 alphanumeric characters. This way, Kushki will identify the transaction as a subscription managed by an external engine. Include this parameter when making a charge

{
   "token": "{{token}}",
   "amount": {
       "subtotalIva": 0,
       "subtotalIva0": 50,
       "ice": 0,
       "iva": 0,
       "currency": "USD",
       "extraTaxes": {
           "iac": 0,
           "tasaAeroportuaria": 0,
           "agenciaDeViaje": 0
       }
   },
   "metadata": {
       "contractID": "157AB"
   },
   "contactDetails": {
       "documentType": "PAS",
       "documentNumber": "1234567890",
       "email": "user@example.com",
       "firstName": "John",
       "lastName": "Doe",
       "phoneNumber": "+513912345678"
   },
   "orderDetails": {
       "siteDomain": "example.com",
       "shippingDetails": {
           "name": "John Doe",
           "phone": "+513912345678",
           "address": "Av. Simón Bolivar 1515",
           "city": "Lima",
           "region": "Pueblo Libre",
           "country": "Perú",
           "zipcode": "15084"
       },
       "billingDetails": {
           "name": "John Doe",
           "phone": "+593912345678",
           "address": "Av. Simón Bolivar 1515",
           "city": "Lima",
           "region": "Pueblo Libre",
           "country": "Perú",
           "zipCode": "15084"
       }
   },
   "productDetails": {
       "product": [
           {
               "id": "198952AB",
               "title": "eBook Digital Services",
               "price": 30,
               "sku": "10101042",
               "quantity": 1
           },
           {
               "id": "198953AB",
               "title": "eBook Virtual Selling",
               "price": 20,
               "sku": "004834GQ",
               "quantity": 1
           }
       ]
   },
   "fullResponse": "v2",
   "externalSubscriptionID": "SUB1228930920"
}