Skip to main content
POST
/
v1
/
issuing
/
cards
/
{id}
/
elevate_limit
Elevate Per-Transaction Limit
curl --request POST \
  --url https://api-sandbox.uqpaytech.com/api/v1/issuing/cards/{id}/elevate_limit \
  --header 'Content-Type: application/json' \
  --header 'x-auth-token: <api-key>' \
  --header 'x-idempotency-key: <x-idempotency-key>' \
  --data '
{
  "limit_amount": 80000,
  "duration_in_days": 7
}
'
{
  "card_id": "c0cef051-29c5-4796-b86a-cd5b684bfad7",
  "card_order_id": "c0cef051-29c5-4796-b86a-cd5ee34bfad7",
  "order_status": "PENDING"
}

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.

Authorizations

​
x-auth-token
string
header
required

The API token for login provided by UQPay.

Headers

​
x-on-behalf-of
string

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.

​
x-idempotency-key
string<uuid>
required

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.

Path Parameters

​
id
string<uuid>
required

Universally unique identifier (UUID v4) of a resource.

Example:

"71fdb0fe-9682-457a-9361-e8868694f12f"

Body

application/json
​
limit_amount
number
required

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).

Must be a multiple of 0.01
Example:

80000

​
duration_in_days
integer
default:7

Number of days the elevation remains in effect. When the elevation expires, the per-transaction limit auto-reverts to the card's standard cap.

Required range: 1 <= x <= 7
Example:

7

Response

200 - application/json

Elevation request accepted. Listen on the webhook for the final result.

​
card_id
string
required

Unique identifier for the card.

Example:

"c0cef051-29c5-4796-b86a-cd5b684bfad7"

​
card_order_id
string
required

ID of the card order.

Example:

"c0cef051-29c5-4796-b86a-cd5ee34bfad7"

​
order_status
enum<string>
required

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.

Available options:
PENDING
Example:

"PENDING"