Authorization (Pre-auth)
POST
/terminal/v1/sync/authorization
unknown at card-present time: hotels, gas stations, open-tab restaurants.
🚧 Beta — Early Access
This API is in early access. Endpoints, parameters, and response structures
may change without prior notice. Do not deploy to production without
coordinating with the Kushki integration team.
| Card type | Validity |
|---|---|
| Debit | 7 days |
| Credit | 28 days |
Save rawResponse.transaction_reference— required forcapture,re_authorization, andvoid.
Request
Header Params
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api-uat.kushkipagos.com/terminal/v1/sync/authorization' \
--header 'Authorization;' \
--header 'timestamp;' \
--header 'Content-Type: application/json' \
--data '{
"amount": {
"iva": 0,
"subtotal_iva": 0,
"subtotal_iva0": 50000,
"extra_taxes": {
"airport_tax": 0,
"iac": 0,
"ice": 0,
"travel_agency": 0
}
},
"client_transaction_id": "c5a3f3be-9d6f-4d39-8af5-58dbb589af30",
"metadata": {
"reference": "HOTEL-ROOM-302",
"device": "SUNMI-P3"
}
}'Response Response Example
200 - Example 1
{
"approved": true,
"responseCode": "00",
"authCode": "123456",
"issuerAuthenticationData": "663cddbc3ec72e76",
"issuerScript1": "string",
"issuerScript2": "string",
"message": "Approval and completed successfully.",
"rawResponse": {
"authorized_amount": 12000,
"card_type": "prepaid",
"cvm_type": "pin",
"franchise": "VISA",
"kushki_response": {
"code": "000",
"message": "Approval and completed successfully."
},
"transaction_reference": "983a7480-6d97-41c3-bdd8-d3cde6685c17",
"transaction_status": "APPROVAL",
"transaction_type": "charge",
"ticket_number": "110993659310263283",
"F11": "147009",
"message_fields": {
"F38": "123456",
"F39": "00",
"F55": "string"
}
},
"cardData": {
"pan": "**** **** **** 0043",
"cardHolderName": "string",
"cardType": "VISA",
"entryMode": "ICC",
"showReciptSignature": false,
"cvm": "pin",
"aid": "A0000000031010",
"bin": "453985",
"isOnlinePinMandatory": false
},
"timestamp": 1772636209320
}Modified at 2026-08-20 16:58:39