跳转到主要内容
POST
Elevate Per-Transaction Limit

授权

x-auth-token
string
header
必填

由 UQPay 提供的登录 API Token。

请求头

x-on-behalf-of
string

指定代表哪个子账户发起请求。应设置为 account_id,该值可通过 List Connected Accounts 接口获取。若省略或为空,则请求以主账户身份执行。 更多信息参见 关联账户

x-idempotency-key
string<uuid>
必填

用于维持操作幂等性的唯一标识符(UUID),确保同一操作的重复执行不会产生意外影响或重复。它有助于在网络错误、重试或失败的情况下保持数据一致性。

路径参数

id
string<uuid>
必填

资源的全局唯一标识符(UUID v4)。

示例:

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

请求体

application/json
limit_amount
number
必填

要应用的新单笔限额,以卡片币种计价。必须大于 0,最多两位小数,且不超过各币种上限(USD/XUSD 为 80000,SGD 为 100000)。

必须是以下数值的倍数 0.01
示例:

80000

duration_in_days
integer
默认值:14

提升保持生效的天数。提升过期后,单笔限额自动恢复为卡片的标准上限。

必填范围: 1 <= x <= 14
示例:

14

响应

200 - application/json

提升请求已受理。请监听 webhook 获取最终结果。

card_id
string
必填

卡片的唯一标识符。

示例:

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

card_order_id
string
必填

卡订单的 ID。

示例:

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

order_status
enum<string>
必填

在刚受理的提升请求上始终为 PENDING。请监听 card.elevate_limit.succeededcard.elevate_limit.failed webhook 获取最终结果。

可用选项:
PENDING
示例:

"PENDING"