Elevate Per-Transaction Limit
Temporarily raise the per-transaction limit on an ACTIVE card without an approval flow. The elevated limit auto-reverts to the card’s standard per-transaction limit when the elevation expires; the card’s long-term limit settings stay unchanged.
Note: This endpoint is restricted to specific card BINs. Contact UQPAY to enable it for your account.
Per-currency caps
| Currency | Maximum elevated per-transaction limit |
|---|---|
| USD / XUSD | 80,000 |
| SGD | 100,000 |
Concurrency
A card can hold only one elevation in processing or active state at a time. Submitting another request while one is still in effect returns 400.
Fields managed by the server (do not send in the request body)
| Field | Reason |
|---|---|
currency | Resolved from the card’s currency. |
intent | Fixed by the server to an internal enum. |
reason | Not accepted. |
Asynchronous result
The synchronous response only acknowledges the request and returns order_status: PENDING. The final outcome is delivered via the card.elevate_limit.succeeded or card.elevate_limit.failed webhook. Match the webhook to the request by card_id — a card can only have one elevation in flight at a time.
Documentation Index
Fetch the complete documentation index at: https://developers.uqpay.com/llms.txt
Use this file to discover all available pages before exploring further.
授权
The API token for login provided by UQPay.
请求头
Specifies the sub-account on whose behalf the request is made. This should be set to the account_id, which can be retrieved via the List Connected Accounts endpoint. If omitted or empty, the request is executed using the master account.
More information at Connected Accounts.
A unique identifier (UUID) used to maintain operation idempotency, ensuring that repeated executions of the same operation do not result in unintended effects or duplication. It helps preserve data consistency in the face of network errors, retries, or failures.
路径参数
Universally unique identifier (UUID v4) of a resource.
"71fdb0fe-9682-457a-9361-e8868694f12f"
请求体
The new per-transaction limit to apply, denominated in the card's currency. Must be greater than 0, up to two decimal places, and within the per-currency cap (80000 for USD/XUSD, 100000 for SGD).
0.0180000
Number of days the elevation remains in effect. When the elevation expires, the per-transaction limit auto-reverts to the card's standard cap.
1 <= x <= 77
响应
Elevation request accepted. Listen on the webhook for the final result.
Unique identifier for the card.
"c0cef051-29c5-4796-b86a-cd5b684bfad7"
ID of the card order.
"c0cef051-29c5-4796-b86a-cd5ee34bfad7"
Always PENDING on a freshly accepted elevation request. Listen on the card.elevate_limit.succeeded or card.elevate_limit.failed webhook for the terminal outcome.
PENDING "PENDING"