External subscriptions to Kushki

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.

Beta Product 🔐👩🏽‍💻

We are currently working on our beta version. Stay tuned for the official release! You can also contact your account manager for more information.

Usage Conditions

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

Due to our risk policies, this implementation requires a prior assessment by the Kushki team. Please contact your sales representative or pre-sales engineer to evaluate feasibility.

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": "30"
   },
   "totalAmount": 50,
   "currency": "USD"
}

If the service has not been activated, you will receive error K015: Transaction not allowed without cvv2.

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"
}

If instead you want to execute a one-time charge not associated with a subscription, simply omit the externalSubscriptionID parameter.

External subscriptions to Kushki

Usage Conditions#

Steps to integrate charges via external recurrence engine#

1. Request the service activation from Kushki#

2. Request a card token without CVV#

3. Perform the charge#

Usage Conditions

Steps to integrate charges via external recurrence engine

1. Request the service activation from Kushki

2. Request a card token without CVV

3. Perform the charge