Re-authorization

Testing

https://api-uat.kushkipagos.com

POST

/terminal/v1/{terminalSerial}/sync/re_authorization

Extends the reserved amount or validity of an existing pre-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

Request

Path Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

Re-authorization processed successfully.

This response does not have a body.

🟠400Bad Request

🟠401Unauthorized

🟠409Conflict

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

cURL

Extend validity onlyIncrease reserved amount

curl --location '/terminal/v1/SN71652/sync/re_authorization' \
--header 'Authorization: nRvpFJZHjqLU4k8Rz2YiDvxA3mQs9oB1cW7eT0=' \
--header 'timestamp: 1700000000000' \
--header 'Content-Type: application/json' \
--data '{
    "amount": {
        "iva": 0,
        "subtotal_iva": 0,
        "subtotal_iva0": 0
    },
    "client_transaction_id": "a1b2c3d4-1234-5678-abcd-000000000001",
    "transaction_reference": "1524e838-8270-4b9e-9929-58f3f892bfca"
}'

Response Example

400 - Example 1

{
    "type": "PARAMETER",
    "code": "PAR-003",
    "param": "amount.iva",
    "message": "Field amount.iva must satisfy: value >= 0",
    "object": {
        "client_transaction_id": "c5a3f3be-9d6f-4d39-8af5-58dbb589af69",
        "terminal_id": "172653",
        "serial_number": "TJ54241R20931"
    }
}

Modified at 2026-08-31 16:30:45

Capture

Post-tip

Re-authorization

🚧 Beta — Early Access#

Request

Responses

🚧 Beta — Early Access