Suscripciones externas a Kushki

14 mayo 2025

Cobra con Kushki y administra tus suscripciones de forma externa

Kushki permite procesar pagos bajo demanda con credenciales tokenizadas fuera de su plataforma (por ejemplo, por un orquestador o motor externo de suscripciones). Para ello, es obligatorio que el comercio cuente con certificación PCI DSS y que gestione correctamente la seguridad, almacenamiento y uso del token de tarjeta.

Condiciones de uso

Para que una transacción sea enviada al emisor como pago recurrente externo, debe omitir los siguientes parámetros:

Diferidos (número de cuotas o tipo de diferido),
3DS (autenticación reforzada),
CVV,
Criptogramas de seguridad (por ejemplo, generados por wallets).

Si alguno de estos elementos se incluye, la transacción se procesará como un pago único, lo que puede afectar la tasa de aprobación.

Aplica en	Disponible	Implementación
Colombia 🇨🇴 México 🇲🇽 Chile 🇨🇱 Perú 🇵🇪	☑ Adquirente ☐ Agregador	API
Ecuador 🇪🇨	☐ Adquirente ☑ Agregador	API

Pasos para integrar cobros con motor de recurrencia externo

1. Solicita a Kushki la activación del servicio

Contacta a tu ejecutivo de cuenta para habilitar la opción de cobros de suscripciones externas sin CVV.

2. Solicita un token para cargo con tarjeta, omitiendo el CVV

Realiza una solicitud de tokenización omitiendo el campo cvv.

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

3. Realiza el cargo

Para que un cargo se tome como recurrente es necesario enviar el campo externalSubscriptionID con el id de la suscripción de tu motor externo con una longitud igual o menor a 20 caracteres alfanuméricos, de esta forma Kushki identificará que corresponde a una subscripción administrada por un motor externo. Este parámetro lo envías al realizar el 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"
}