Create payment (tokenless)

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

Limitations

Only available for Visa and Mastercard.

Not compatible with Siftscience nor TransUnion antifraud tools.

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

Not compatible with Kushki OTP authentication.

Mexico

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

Here is a quick list of types of credit that you could be sent in the creditType field. Keep in mind that the exact creditType you will be able to use for deferred transactions depends on the credit card BIN. You can request the deferred options for a specific BIN from your frontend with our API or with one of our frontend libraries.

Do you have your own 3DS authentication engine?*

Make sure you include the threeDomainSecure object in your request.

* Applies in Mexico 🇲🇽.

Do you have your own subscriptions engine?*

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

Send initialRecurrence in the transactionMode parameter and process the charge. For this initial transaction, you must send the CVV.

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

For the subsequent transactions, send subsequentRecurrence in the transactionMode parameter and include the transactionReference number in the initialRecurrenceReference field. Now you can omit the CVV.

An alternative option to process external subscriptions is by sending the parameter externalSubscriptionID. Click here for more information.

curl --location '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": 10000, "ice": 0, "iva": 0, "currency": "MXN" }, "isDeferred": false, "metadata": { "referencia": "999929" }, "contactDetails": { "documentType": "CC", "documentNumber": "1234567890", "email": "user@example.com", "firstName": "John", "lastName": "Doe", "phoneNumber": "+525512345678" }, "orderDetails": { "siteDomain": "example.com", "shippingDetails": { "name": "John Doe", "phone": "+525512345678", "address1": "Av. Insurgentes Sur 1234", "city": "Ciudad de México", "region": "CDMX", "country": "Mexico" }, "billingDetails": { "name": "John Doe", "phone": "+525512345678", "address1": "Av. Insurgentes Sur 1234", "city": "Ciudad de México", "region": "CDMX", "country": "Mexico" } }, "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": "MXN", "isDeferred": false }, "approvalCode": "123456", "approvedTransactionAmount": 5000, "binInfo": { "bank": "Banco de S.A.", "binCard": "531122", "cardCountry": "Mexico", "lastFourDigits": "2112", "type": "credit" }, "cardHolderName": "John Doe", "created": 1712092118000, "merchantId": "20000000101835540000", "merchantName": "CENTRALIZADA NUEVA PRUEBA GOB", "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

Mexico

Do you have your own 3DS authentication engine?*

Do you have your own subscriptions engine?*

Request

Responses

Create payment (tokenless)

Limitations#

Mexico#

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

Do you have your own subscriptions engine?*#

Request

Responses

Limitations

Mexico

Do you have your own 3DS authentication engine?*

Do you have your own subscriptions engine?*