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.

The authorization will expire after 28 days for credit cards and after 7 days for debit cards from the time of request.

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 in Colombia 🇨🇴.

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": 39, "ice": 0, "iva": 0, "currency": "COP" }, "orderDetails": { "siteDomain": "example.com", "shippingDetails": { "name": "John Doe", "phone": "+667566314515", "address": "Av Mariscal Caceres", "city": "Ayacucho", "region": "Ayacucho", "country": "Colombia", "zipCode": "170402" }, "billingDetails": { "name": "John Doe", "phone": "+573912345678", "address": "Av Mariscal Caceres", "city": "Ayacucho", "region": "Ayacucho", "country": "Colombia", "zipCode": "170402" } }, "months": 3, "fullResponse": "v2", "metadata": { "key0": "value0", "key1": "value1", "key2": "value2" } }'

{ "details": { "amount": { "currency": "COP", "subtotalIva": 0, "subtotalIva0": 10, "iva": 0, "ice": 0, "extraTaxes": { "iac": 0, "tasaAeroportuaria": 0, "agenciaDeViaje": 0 } }, "approvalCode": "string", "approvedTransactionAmount": 0, "binInfo": { "bank": "BANCO CONTINENTAL", "type": "credit" }, "cardHolderName": "string", "created": 0, "merchantId": "string", "merchantName": "string", "paymentBrand": "string", "processorBankName": "string", "requestAmount": 0, "responseCode": "string", "responseText": "string", "transactionId": "string", "transactionReference": "string", "transactionStatus": "APPROVAL", "transactionType": "SALE", "messageFields": { "f38": "string", "f39": "string", "f62": { "f2": "string" }, "f63": "string", "f15": "string", "f57": "string" }, "externalReferenceId": "string", "network": { "scheme": "mastercard", "transactionIdentifier": "1231234561234" } }, "ticketNumber": "string", "transactionReference": "string" }

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: