Re-authorization
Testing
UAT Testing Env
https://api-uat.kushkipagos.com
UAT Testing Env
https://api-uat.kushkipagos.com
POST
/terminal/v1/{terminalSerial}/sync/re_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.
| Goal | subtotal_iva0 value |
|---|---|
| Extend validity only | 0 |
| Increase reserved amount | Additional amount to add |
What you encrypt
{
"amount": {
"iva": 0,
"subtotal_iva": 0,
"subtotal_iva0": 0
},
"client_transaction_id": "a1b2c3d4-1234-5678-abcd-000000000001",
"transaction_reference": "1524e838-8270-4b9e-9929-58f3f892bfca",
"omit_card": false
}omit_card is optional and applies to capture, re_authorization and void, in sync and async — the six combinations. With true the terminal completes the operation without asking for the card again, which is what makes the hotel check-out case work.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/SN71652/sync/re_authorization' \
--header 'Authorization: Basic 9f2c4e1b7a63d8f05c2e9b41a7d3086fbe15c4d29a7e0b38f6c1d52a94e7b3c0' \
--header 'timestamp: 1748476800' \
--header 'Content-Type: application/json' \
--data '{
"data": "a3f14c7e9b02d85fbc1e46a9d370f28b:9e0d7f21c4a8b653e17d902fac48b5d6e83c1704a9f26db8"
}'Response Response Example
200 - default
{
"hostRespond": true,
"approved": true,
"responseCode": "000",
"message": "Approved or completed successfully.",
"request": {
"amount": {
"currency": "MXN",
"iva": 0,
"subtotal_iva": 0,
"subtotal_iva0": 0,
"tip": 0,
"extra_taxes": {
"airport_tax": 0,
"iac": 0,
"ice": 0,
"travel_agency": 0
}
},
"transaction_type": "reAuthorization",
"transaction_mode": "Authorization",
"client_transaction_id": "a9542947-bc3a-4264-89c6-65b095f90431",
"transaction_reference": "f57b6d20-1c4a-443b-8a98-3db21af7a83b",
"country": "MEX",
"is_deferred": false,
"is_cashback": false,
"cashback_amount": 0,
"omit_card": true,
"metadata": {
"reference": "ABC12345",
"customerEmail": "cliente@ejemplo.com",
"device": "SUNMI-P3H"
},
"query_deferred": false,
"show_decimal_places": true,
"is_async": false,
"events_webhook_url": ""
},
"rawResponse": {
"additional_amounts": {
"account_type": "",
"amount": 0,
"amount_type": "",
"card_type": "",
"currency_code": ""
},
"card_type": "credit",
"cvm_type": "none",
"F11": "107745",
"franchise": "MASTERCARD",
"kushki_response": {
"code": "000",
"message": "Approved or completed successfully."
},
"message_fields": {
"F38": "123456",
"F39": "00"
},
"transaction_reference": "8e352cd2-f461-42fd-8b5e-ec4cf3649440",
"transaction_status": "APPROVAL",
"transaction_type": "reAuthorization",
"ticket_number": "118419357229742564"
},
"timestamp": 1788661811865,
"needReversal": false
}Modified at 2026-09-09 19:44:10