Hacer un cargo o cargo diferido

Haz un cargo con un token entregado por Kushki que representa la tarjeta de crédito del cliente.

Aviso importante sobre transacciones con BBVA Perú 🇵🇪
A partir del 1 de enero de 2025, BBVA Perú solo acepta transacciones con tarjeta con CVV dinámico como parte de sus medidas para reforzar la seguridad de las transacciones en línea.

Cargos diferidos en Perú 🇵🇪

En Perú 🇵🇪, las transacciones diferidas varían según el modelo de afiliación:

Para adquirencia

Para cargos diferidos en comercios peruanos, debes enviar el objeto deferred, que incluye los parámetros creditType, graceMonths y months.

En todos los países, graceMonths debe enviarse con el valor 00.

Ejemplo: Credit Type `01` (diferido del emisor en Perú)

  "deferred": {
    "graceMonths": "00",
    "creditType": "01",
    "months": 6
  }

Para el modelo agregador

Para cargos diferidos en comercios peruanos con modelo agregador, puedes enviar el número de cuotas en el parámetro months.

"months": 3,

¡Importante!
En cualquier caso, consulta el método Request Deferred Options, ya que las opciones varían según el BIN de la tarjeta.

¿Tienes tu propio motor de autenticación 3DS?*

Asegúrate de incluir el objeto threeDomainSecure en tu request.

* Aplica en Perú 🇵🇪.

Timeout del endpoint: 29 seg

¿Tienes tu propio motor de suscripciones?*

* Aplica en Perú 🇵🇪.

Si tienes tu propio motor de suscripciones (solo comercios con PCI Compliance), puedes seguir estos pasos para procesar cargos recurrentes:

Obtén un card token enviando initialRecurrence en el parámetro transactionMode.

Usa el token obtenido en el paso 1 para hacer un cargo inicial (revisa el ejemplo llamado Initial recurrence charge for subscriptions).

Guarda el número transactionReference del cargo completado en el paso 2.

Para las transacciones siguientes, obtén un card token enviando subsequentRecurrence en el parámetro transactionMode.

Haz un cargo enviando el número transactionReference en el campo initialRecurrenceReference (revisa el ejemplo llamado Subsequent recurrence charge for subscriptions)

curl --location '/card/v1/charges' \ --header 'Private-Merchant-Id;' \ --header 'Content-Type: application/json' \ --data-raw '{ "token": "24e5cc0d47fc4b2ab098bdb7d0b94569", "amount": { "currency": "PEN", "subtotalIva": 0, "subtotalIva0": 5000, "iva": 0, "ice": 0, "extraTaxes": { "iac": 0, "tasaAeroportuaria": 0, "agenciaDeViaje": 0 } }, "metadata": { "key0": "value0", "key1": "value1", "key2": "value2" }, "fullResponse": "v2", "ignoreWarnings": true, "contactDetails": { "firstName": "John", "lastName": "Doe", "email": "user@example.com", "documentType": "DNI", "documentNumber": "ABCD123456EF", "phoneNumber": "+51912345678" }, "orderDetails": { "siteDomain": "example.com", "shippingDetails": { "name": "John Doe", "phone": "+51912345678", "address": "Centro 123", "city": "Lima", "region": "Lima", "country": "Peru" }, "billingDetails": { "name": "John Doe", "phone": "+51912345678", "address": "Centro 123", "city": "Lima", "region": "Lima", "country": "Peru" } }, "productDetails": { "product": [ { "id": "198952AB", "title": "eBook Digital Services", "price": 15000, "sku": "10101042", "quantity": 1 } ] }, "threeDomainSecure": { "cavv": "AAABBoVBaZKAR3BkdkFpELpWIiE=", "eci": "07", "specificationVersion": "2.2.0", "acceptRisk": true } }'

Cargos diferidos en Perú 🇵🇪#

Para adquirencia#

Ejemplo: Credit Type 01 (diferido del emisor en Perú)#

Para el modelo agregador#

¡Importante!#

¿Tienes tu propio motor de autenticación 3DS?*#

¿Tienes tu propio motor de suscripciones?*#

Request