Preauthorization (tokenless)

Make a preauthorization (two-step payment) without the need for a card token.

DANGER

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

You preauthorize a card payment when you want to verify that sufficient credit exists on a customer's credit card before processing a sale. The cardholder's credit limit will be reduced by the amount of the authorization until the authorization is captured or expires.

In Colombia, Perú, México and Chile, the authorization will expire after 28 days for credit cards and after 7 days for debit cards from the time of request.

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

Limitations

Only available for Acquirer model in Chile 🇨🇱, Colombia 🇨🇴, México 🇲🇽, and Perú 🇵🇪.

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.

NOTE: An authorization can be canceled through the Void a transaction endpoint. After performing the cancellation, no reauthorizations can be made on the canceled transaction.

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?*

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 preauthorization. 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.

Got a suggestion on this documentation? Contact Us.

curl --location --request POST 'https://api-uat.kushkipagos.com/card/v2/preAuthorization' \ --header 'Private-Merchant-Id;' \ --header 'Content-Type: application/json' \ --data-raw '{ "card": { "name": "John Doe", "number": "4259078012341233", "expiryMonth": "12", "expiryYear": "25", "cvv": "123" }, "amount": { "subtotalIva": 0, "subtotalIva0": 10000, "ice": 0, "iva": 0, "currency": "CLP" }, "metadata": { "Referencia": "99999" }, "contactDetails": { "documentType": "RUT", "documentNumber": "11111111-1", "email": "user@example.com", "firstName": "John", "lastName": "Doe", "phoneNumber": "+56912345678" }, "orderDetails": { "siteDomain": "example.com", "shippingDetails": { "name": "John Doe", "phone": "+56912345678", "address1": "Eloy Alfaro 139 y Catalina Aldaz", "address2": "centro 123", "city": "Santiago", "region": "Metropolitana", "country": "Chile", "address": "Av. Providencia 1234", "zipCode": "7500000" }, "billingDetails": { "name": "John Doe", "phone": "+56912345678", "address1": "Eloy Alfaro 139 y Catalina Aldaz", "address2": "centro 123", "city": "Santiago", "region": "Metropolitana", "country": "Chile", "address": "Av. Providencia 1234", "zipCode": "7500000" } }, "productDetails": { "product": [ { "id": "198952AB", "title": "eBook Digital Services", "price": 10000, "sku": "10101042", "quantity": 1 } ] }, "fullResponse": "v2" }'

{ "details": { "amount": { "subtotalIva": 0, "subtotalIva0": 4000, "ice": 0, "iva": 0, "currency": "CLP", "isDeferred": false }, "approvalCode": "123456", "approvedTransactionAmount": 4000, "binInfo": { "bank": "WELLSFARGO", "binCard": "425907", "cardCountry": "United States of America", "lastFourDigits": "1233", "type": "credit" }, "cardHolderName": "John Doe", "created": 1712159361000, "merchantId": "20000000101835540000", "merchantName": "Tu comercio Chile", "messageFields": { "f38": "123456", "f39": "00" }, "paymentBrand": "Visa", "processorBankName": "Kushki", "recap": "409415159483", "requestAmount": 4000, "responseCode": "000", "responseText": "Approval and completed successfully Accepted and processed.", "transactionId": "821712159361453407367", "transactionReference": "ba48f90b-43ef-4cff-b842-7bc34c41f78e", "transactionStatus": "APPROVAL", "transactionType": "PREAUTHORIZATION" }, "ticketNumber": "821712159361453410", "transactionReference": "ba48f90b-43ef-4cff-b842-7bc34c41f78e" }

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

This functionality is available for the following models:

Limitations

Do you have your own 3DS authentication engine?*

Do you have your own subscriptions engine?*

Request

Responses

Preauthorization (tokenless)

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

This functionality is available for the following models:#

Limitations#

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

Do you have your own subscriptions engine?*#

Request

Responses

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

This functionality is available for the following models:

Limitations

Do you have your own 3DS authentication engine?*

Do you have your own subscriptions engine?*