Elevate Per-Transaction Limit
在不走审批流程的情况下,临时提升某张 ACTIVE 卡片的单笔限额。提升后的限额在本次提升过期后自动恢复为卡片的标准单笔限额;卡片的长期限额设置保持不变。
各币种上限
| 币种 | 提升后的单笔限额上限 |
|---|---|
| USD / XUSD | 80,000 |
| SGD | 100,000 |
并发
一张卡片同一时间只能有一笔处于 processing 或 active 状态的提升。若在一笔提升仍生效时再次提交请求,将返回 400。
由服务端管理的字段(请勿在请求体中发送)
| 字段 | 原因 |
|---|---|
currency | 由卡片币种解析得出。 |
intent | 由服务端固定为内部枚举。 |
reason | 不接受。 |
异步结果
同步响应仅确认请求已收到,并返回 order_status: PENDING。最终结果通过 card.elevate_limit.succeeded 或 card.elevate_limit.failed webhook 送达。通过 card_id 将 webhook 与请求匹配——一张卡片同一时间只能有一笔进行中的提升。
授权
由 UQPay 提供的登录 API Token。
请求头
指定代表哪个子账户发起请求。应设置为 account_id,该值可通过 List Connected Accounts 接口获取。若省略或为空,则请求以主账户身份执行。
更多信息参见 关联账户。
用于维持操作幂等性的唯一标识符(UUID),确保同一操作的重复执行不会产生意外影响或重复。它有助于在网络错误、重试或失败的情况下保持数据一致性。
路径参数
资源的全局唯一标识符(UUID v4)。
"71fdb0fe-9682-457a-9361-e8868694f12f"
请求体
响应
提升请求已受理。请监听 webhook 获取最终结果。
卡片的唯一标识符。
"c0cef051-29c5-4796-b86a-cd5b684bfad7"
卡订单的 ID。
"c0cef051-29c5-4796-b86a-cd5ee34bfad7"
在刚受理的提升请求上始终为 PENDING。请监听 card.elevate_limit.succeeded 或 card.elevate_limit.failed webhook 获取最终结果。
PENDING "PENDING"

