Create payment (tokenless)

Make a single charge without the need for a card token.

DANGER

This is an On-demand service only available for PCI DSS compliance companies.

WARNING

This functionality is available for the Acquirer model only.

Limitations

Only available for the Acquirer model in Colombia 🇨🇴.

Only available for Visa and Mastercard.

Not compatible with Siftscience nor TransUnion antifraud tools.

Not compatible with Kushki 3DS authentication tool (use your own 3DS authentication engine instead).

Not compatible with Kushki OTP authentication.

Deferred charges in Colombia

For deferred charges, 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

"months": 3

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?

Follow the same steps as for charges v1. Send initialRecurrence / subsequentRecurrence in transactionMode and use initialRecurrenceReference for subsequent charges.

Got a suggestion on this documentation? Contact Us.

curl --location --request POST 'https://api-uat.kushkipagos.com/card/v2/charges' \ --header 'Private-Merchant-Id;' \ --header 'Content-Type: application/json' \ --data-raw '{ "card": { "name": "John Doe", "number": "5311220000122112", "expiryMonth": "12", "expiryYear": "25", "cvv": "123" }, "amount": { "subtotalIva": 0, "subtotalIva0": 20000, "ice": 0, "iva": 0, "currency": "COP" }, "isDeferred": false, "metadata": { "referencia": "999929" }, "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": "Av. Reforma 123", "city": "Bogotá", "region": "Cundinamarca", "country": "Colombia", "address": "Calle 100 # 10-20", "zipCode": "110111" }, "billingDetails": { "name": "John Doe", "phone": "+573012345678", "address1": "Av. Reforma 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 } ] }, "fullResponse": "v2" }'

{ "details": { "amount": { "subtotalIva": 0, "subtotalIva0": 5000, "ice": 0, "iva": 0, "currency": "COP", "isDeferred": false }, "approvalCode": "123456", "approvedTransactionAmount": 5000, "binInfo": { "bank": "BANCOLOMBIA", "binCard": "531122", "cardCountry": "Colombia", "lastFourDigits": "2112", "type": "credit" }, "cardHolderName": "John Doe", "created": 1712092118000, "merchantId": "20000000105929933000", "merchantName": "Tu comercio Colombia", "messageFields": { "f38": "123456", "f39": "00", "f48": { "s22": { "se5": "C101" } } }, "paymentBrand": "Mastercard", "processorBankName": "Kushki", "recap": "409321136945", "requestAmount": 5000, "responseCode": "000", "responseText": "Approved or completed successfully.", "transactionId": "821712092118240856443", "transactionReference": "3d0d7e1f-02b5-46fa-9791-92722f42df5b", "transactionStatus": "APPROVAL", "transactionType": "SALE" }, "ticketNumber": "821712092118240271", "transactionReference": "3d0d7e1f-02b5-46fa-9791-92722f42df5b" }

Limitations

Deferred charges in Colombia

For Aggregator model

Do you have your own 3DS authentication engine?

Do you have your own subscriptions engine?

Request

Responses

Create payment (tokenless)

Limitations#

Deferred charges in Colombia#

For Aggregator model#

Do you have your own 3DS authentication engine?#

Do you have your own subscriptions engine?#

Request

Responses

Limitations

Deferred charges in Colombia

For Aggregator model

Do you have your own 3DS authentication engine?

Do you have your own subscriptions engine?