Make a charge or deferred charge

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

Deferred charges in Colombia

For deferred charges in Colombia, set the deferred object with creditType, graceMonths, and months.

Send graceMonths as "00".

Credit Type 01 — Standard Installments:

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

For Aggregator model

You can also send the number of installments in the months parameter directly:

"months": 3

Important

Consult the Request deferred options endpoint — available deferred options vary by card BIN.

Do you have your own 3DS authentication engine?

Make sure you include the threeDomainSecure object in your request.

Do you have your own subscriptions engine?

WARNING

This functionality is available for the Acquirer model only.

In case you have your own subscriptions engine (only PCI Compliance merchants), follow these steps:

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

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

Save the transactionReference from step 2.

For subsequent transactions, obtain a new token with subsequentRecurrence in transactionMode.

Include the transactionReference in the initialRecurrenceReference field.

Endpoint time out: 29 sec

Got a suggestion on this documentation? Contact Us.

curl --location --request POST 'https://api-uat.kushkipagos.com/card/v1/charges' \ --header 'Private-Merchant-Id;' \ --header 'Content-Type: application/json' \ --data-raw '{ "token": "f5c64f7ac8ea42d5a58dcdc74de973dc", "amount": { "subtotalIva": 0, "subtotalIva0": 20000, "ice": 0, "iva": 0, "currency": "COP" }, "metadata": { "Referencia": "987654" }, "contactDetails": { "documentType": "CC", "documentNumber": "1009283738", "email": "user@example.com", "firstName": "John", "lastName": "Doe", "phoneNumber": "+573012345678" }, "orderDetails": { "siteDomain": "example.com", "shippingDetails": { "name": "John Doe", "phone": "+573012345678", "address1": "Eloy Alfaro 139 y Catalina Aldaz", "address2": "centro 123", "city": "Bogotá", "region": "Cundinamarca", "country": "Colombia", "address": "Calle 100 # 10-20", "zipCode": "110111" }, "billingDetails": { "name": "John Doe", "phone": "+573012345678", "address1": "Eloy Alfaro 139 y Catalina Aldaz", "address2": "centro 123", "city": "Bogotá", "region": "Cundinamarca", "country": "Colombia", "address": "Calle 100 # 10-20", "zipCode": "110111" } }, "productDetails": { "product": [ { "id": "198952AB", "title": "eBook Digital Services", "price": 10000, "sku": "10101042", "quantity": 1 }, { "id": "198953AB", "title": "eBook Virtual Selling", "price": 6980, "sku": "004834GQ", "quantity": 1 } ] }, "webhooks": [ { "events": [ "approvedTransaction", "declinedTransaction" ], "headers": [ { "label": "json", "value": "12" } ], "urls": [ "https://eof2hhkrta4ooo1.m.pipedream.net" ] } ], "webhooksChargeback": [ { "events": [ "initialized", "pending", "review", "approval", "declined", "failed", "expired" ], "headers": [ { "label": "json", "value": "12" } ], "urls": [ "https://eof2hhkrta4ooo1.m.pipedream.net" ] } ], "fullResponse": "v2" }'

Deferred charges in Colombia#

For Aggregator model#

Do you have your own 3DS authentication engine?#

Do you have your own subscriptions engine?#

Request

Responses

Deferred charges in Colombia

For Aggregator model

Do you have your own 3DS authentication engine?

Do you have your own subscriptions engine?