Authorization (Pre-auth)
POST
/terminal/v1/{terminalSerial}/sync/authorization
🚧 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.
or open-tab scenarios where the final amount is unknown at card-present time.
| Card type | Validity |
|---|---|
| Debit | 7 days |
| Credit | 28 days |
Save rawResponse.transaction_reference— required forcapture,re_authorization, andvoid.
Request
Path Params
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 Accepted and processed.",
"rawResponse": {
"authorized_amount": 12000,
"card_type": "prepaid",
"cvm_type": "pin",
"franchise": "VISA",
"kushki_response": {
"code": "000",
"message": "Approval and completed successfully Accepted and processed."
},
"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": "UNKNOWN",
"entryMode": "ICC",
"showReciptSignature": false,
"cvm": "pin",
"aid": "A0000000031010",
"bin": "453985",
"isOnlinePinMandatory": false
},
"timestamp": 1772636209320
}Modified at 2026-05-28 16:38:55