Make a charge or deferred charge

This functionality is available for the following models:
☑ Acquirer
☑ Aggregator

Make a charge with a token provided by Kushki which represents the customer's credit card.

Deferred charges in Colombia 🇨🇴

For Colombia 🇨🇴, deferred transactions vary depending on the affiliation model:

For Acquiring

For deferred charges in Colombian merchants, you have to set the deferred object that includes the creditType, graceMonths, and months parameters.

In all countries, graceMonths must be sent with the value of 00.

Example: Credit Type `01` (Colombia's Standard Installments)

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

For Aggregator model

For deferred charges in Colombian merchants in aggregator model, you can send the number of installments in the months parameter.

"months": 3,

Important!
In any case, you should consult the request deferred options method as these vary according to the BIN of the card.

Do you have your own 3DS authentication engine?*

Make sure you include the threeDomainSecure object in your request.

* Applies in Colombia 🇨🇴.

Endpoint time out: 29 sec

Do you have your own subscriptions engine?*

This functionality is available for the following models:
☑ Acquirer
☐ Aggregator

* Applies in Colombia 🇨🇴.

In case you have your own subscriptions engine (only PCI Compliance merchants), you can follow the steps below to process recurring charges:

Obtain a card token by sending initialRecurrence in the transactionMode parameter.

Use the obtained token in step 1 to make an initial charge (see the example named Initial recurrence charge for subscriptions).

Make sure you save the transactionReference number of the charge completed in step 2.

For the subsequent transactions, obtain a card token by sending subsequentRecurrence in the transactionMode parameter.

Make a charge by sending the transactionReference number in the initialRecurrenceReference field (see the example named 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 } }'

This functionality is available for the following models:

Deferred charges in Colombia 🇨🇴

For Acquiring

Example: Credit Type `01` (Colombia's Standard Installments)

For Aggregator model

Important!

Do you have your own 3DS authentication engine?*

Do you have your own subscriptions engine?*

This functionality is available for the following models:

Request

Responses

Make a charge or deferred charge

This functionality is available for the following models:#

Deferred charges in Colombia 🇨🇴#

For Acquiring#

Example: Credit Type 01 (Colombia's Standard Installments)#

For Aggregator model#

Important!#

Do you have your own 3DS authentication engine?*#

Do you have your own subscriptions engine?*#

This functionality is available for the following models:#

Request

Responses

This functionality is available for the following models:

Deferred charges in Colombia 🇨🇴

For Acquiring

Example: Credit Type `01` (Colombia's Standard Installments)

For Aggregator model

Important!

Do you have your own 3DS authentication engine?*

Do you have your own subscriptions engine?*

This functionality is available for the following models: