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.

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 in Chile 🇨🇱.

curl --location 'https://api-uat.kushkipagos.com/card/v1/preAuthorization' \ --header 'Private-Merchant-Id;' \ --header 'Content-Type: application/json' \ --data '{ "token": "8b91be6433c94a98b2b8db6a3e7e564d", "amount": { "subtotalIva": 0, "subtotalIva0": 30000, "ice": 0, "iva": 0, "currency": "CLP" }, "orderDetails": { "siteDomain": "example.com", "shippingDetails": { "name": "Catalina Fuentes", "phone": "+667566314515", "city": "Santiago", "region": "Región Metropolitana", "country": "Chile", "address1": "Av. Apoquindo 4501", "zipcode": "7550000" }, "billingDetails": { "name": "Catalina Fuentes", "phone": "+56912345678", "city": "Santiago", "region": "Región Metropolitana", "country": "Chile", "address1": "Av. Apoquindo 4501", "zipcode": "7550000" } }, "months": 3, "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 Santander Chile", "bindCard": "545195", "cardCountry": "Chile", "lastFourDigits": "5480", "type": "credit" }, "cardHolderName": "Catalina Fuentes", "created": 1658360425000, "merchantId": "20000000104111374000", "merchantName": "Mi 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": "073884255559778896", "transactionReference": "8a42f3a2-fa30-4019-b8f6-9bfc7c78e669" }

This functionality is available for the following models:

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:#

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:

Do you have your own 3DS authentication engine?*

This functionality is available for the following models: