Suscripciones externas a Kushki

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.

Producto en versión beta 🔐👩🏽‍💻

Estamos trabajando en nuestra versión beta. ¡Manténte atento a su lanzamiento oficial! También puedes contactar a tu gerente de cuenta para más información.

Condiciones de uso

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

Debido a nuestras políticas de riesgo, esta implementación requiere una evaluación previa por parte del equipo de Kushki. Contacta a tu ejecutivo comercial o ingeniero de preventa para evaluar la factibilidad.

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

Si el servicio no ha sido activado, recibirás el error K015: Transacción no permitida sin cvv2.

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

Si por el contrario, deseas ejecutar un cargo no atado a una subscripción, omite el parámetro externalSubscriptionID

Suscripciones externas a Kushki

Condiciones de uso#

Pasos para integrar cobros con motor de recurrencia externo#

1. Solicita a Kushki la activación del servicio#

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

3. Realiza el cargo#

Condiciones de uso

Pasos para integrar cobros con motor de recurrencia externo

1. Solicita a Kushki la activación del servicio

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

3. Realiza el cargo