Authorize payments

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

Use this endpoint to request an authorization using a token provided by Kushki.

You authorize 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.

WARNING

Product in beta version for Colombia 🔐👨‍💻
We are working on our beta version. Stay tuned for its official release! You can also contact your account manager for more information.

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

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

Make sure you include the threeDomainSecure object in your request.

* Applies only to Mexico 🇲🇽, Peru 🇵🇪, Chile 🇨🇱 and Colombia 🇨🇴.

Got a suggestion on this documentation? Contact Us.

curl --location --request POST 'https://api-uat.kushkipagos.com/card/v1/preAuthorization' \ --header 'Private-Merchant-Id;' \ --header 'Content-Type: application/json' \ --data-raw '{ "token": "QZPnSP1000000b3MG3062555GhIrcYt5", "amount": { "subtotalIva": 0, "subtotalIva0": 10000, "ice": 0, "iva": 0, "currency": "CLP" }, "fullResponse": "v2", "metadata": { "key0": "value0", "key1": "value1", "key2": "value2" } }'

{ "details": { "amount": { "subtotalIva": 0, "subtotalIva0": 59, "ice": 0, "iva": 0, "currency": "CLP" }, "approvalCode": "000000", "approvedTransactionAmount": 59, "binInfo": { "bank": "BANCO DE LA PRODUCCION S.A. (PRODUBANCO)", "bindCard": "545195", "cardCountry": "Chile", "lastFourDigits": "5480", "type": "credit" }, "cardHolderName": "John Doe", "created": 1658360425000, "merchantId": "20000000104111374000", "merchantName": "Tu comercio Chile", "paymentBrand": "Master Card", "processorBankName": "0032~BANCO INTERNACIONAL", "requestAmount": 59, "responseCode": "000", "responseText": "Transacción aprobada", "transactionId": "985906214634267722", "transactionReference": "8a42f3a2-fa30-4019-b8f6-9bfc7c78e669", "transactionStatus": "APPROVAL", "transactionType": "PREAUTHORIZATION" }, "ticketNumber": 73884255559778900, "transactionReference": "8a42f3a2-fa30-4019-b8f6-9bfc7c78e669" }

This functionality is available for the following models:

Product in beta version for Colombia 🔐👨‍💻

Do you have your own 3DS authentication engine?*

This functionality is available for the following models:

Request

Responses

Authorize payments

This functionality is available for the following models:#

Product in beta version for Colombia 🔐👨‍💻#

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

This functionality is available for the following models:#

Request

Responses

This functionality is available for the following models:

Product in beta version for Colombia 🔐👨‍💻

Do you have your own 3DS authentication engine?*

This functionality is available for the following models: