Hacer un cargo o cargo diferido

Esta funcionalidad está disponible para los siguientes modelos:
☑ Acquirer
☑ Aggregator

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

Cargos diferidos en Colombia 🇨🇴

Para Colombia 🇨🇴, las transacciones diferidas varían según el modelo de afiliación:

Para el modelo Acquirer

Para cargos diferidos en comercios colombianos, 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 estándar de Colombia)

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

Para el modelo Aggregator

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

"months": 3,

¡Importante!
En cualquier caso, debes consultar el método Request Deferred Options, ya que estas 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 Colombia 🇨🇴.

Tiempo límite del endpoint: 29 s

¿Tienes tu propio motor de suscripciones?*

Esta funcionalidad está disponible para los siguientes modelos:
☑ Acquirer
☐ Aggregator

* Aplica en Colombia 🇨🇴.

Si tienes tu propio motor de suscripciones (solo comercios con PCI Compliance), puedes seguir los pasos de abajo 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 (mira el ejemplo llamado Initial recurrence charge for subscriptions).

Asegúrate de guardar 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 (mira el ejemplo llamado Subsequent recurrence charge for subscriptions)

curl --location 'https://api-uat.kushkipagos.com/card/v1/charges' \ --header 'Private-Merchant-Id;' \ --header 'Content-Type: application/json' \ --data-raw '{ "token": "24e5cc0d47fc4b2ab098bdb7d0b94569", "amount": { "currency": "COP", "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": "CC", "documentNumber": "ABCD123456EF", "phoneNumber": "+573912345678" }, "orderDetails": { "siteDomain": "example.com", "shippingDetails": { "name": "John Doe", "phone": "+573912345678", "address": "Centro 123", "city": "Bogotá", "region": "Cundinamarca", "country": "Colombia" }, "billingDetails": { "name": "John Doe", "phone": "+573912345678", "address": "Centro 123", "city": "Bogotá", "region": "Cundinamarca", "country": "Colombia" } }, "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 } }'

Esta funcionalidad está disponible para los siguientes modelos:#

Cargos diferidos en Colombia 🇨🇴#

Para el modelo Acquirer#

Ejemplo: Credit Type 01 (diferido estándar de Colombia)#

Para el modelo Aggregator#

¡Importante!#

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

¿Tienes tu propio motor de suscripciones?*#

Esta funcionalidad está disponible para los siguientes modelos:#

Request

Responses

Esta funcionalidad está disponible para los siguientes modelos: