Make a charge or deferred charge

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

Got a suggestion on this documentation? Contact Us.

Deferred charges in Ecuador 🇪🇨

If you perform a deferred charge with credentials of an Ecuadorian merchant, you have to set the deferred object that has the creditType, graceMonths and months.

How to obtain the available deferred options?

As soon as your customer's card number is entered, you must use the method Request deferred options to verify if there are deferred payment options for the BIN of the card entered by the user.

In response to this call, you will receive the name of the deferral, the type (corresponds to the creditType when executing the charge), the available months and the months of grace, as shown in the following example response:

{
    "name": "Diferido con intereses",
    "type": "002",
    "months": ["3", "6"],
    "monthsOfGrace": ["1", "2", "3"]
}

Some types of deferrals that may be returned in the response are:

Diferido con meses de gracia sin intereses.

Diferido con meses de gracia con intereses.

Diferido cuota fija con intereses.

Diferido cuota fija sin intereses.

Diferido con intereses.

Diferido sin intereses.

WARNING

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.

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": 16.98, "ice": 0, "iva": 0, "currency": "USD" }, "metadata": { "Referencia": "987654" }, "contactDetails": { "documentType": "CI", "documentNumber": "1716458334", "email": "user@example.com", "firstName": "John", "lastName": "Doe", "phoneNumber": "+593912345678" }, "orderDetails": { "siteDomain": "example.com", "shippingDetails": { "name": "John Doe", "phone": "+593912345678", "address1": "Eloy Alfaro 139 y Catalina Aldaz", "address2": "centro 123", "city": "Quito", "region": "Pichincha", "country": "Ecuador" }, "billingDetails": { "name": "John Doe", "phone": "+593912345678", "address1": "Eloy Alfaro 139 y Catalina Aldaz", "address2": "centro 123", "city": "Quito", "region": "Pichincha", "country": "Ecuador" } }, "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 } ] }, "fullResponse": "v2" }'

Deferred charges in Ecuador 🇪🇨#

How to obtain the available deferred options?#

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

Request

Responses

Deferred charges in Ecuador 🇪🇨

How to obtain the available deferred options?

Do you have your own 3DS authentication engine?*