Authorization (Pre-auth)
POST
/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.
unknown at card-present time (hotels, gas stations, open-tab restaurants).
| Card type | Validity |
|---|---|
| Debit | 7 days |
| Credit | 28 days |
Save rawResponse.transaction_reference— required forcapture,re_authorization, andvoid.
tip removed from request body (now DMS-managed).Request
Header Params
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api-uat.kushkipagos.com/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-06-03 17:35:17