跳转到主要内容
POST
Card Recharge

授权

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
amount
number
必填

该卡片的充值或提现金额。

必填范围: x > 0
示例:

100.02

响应

200 - application/json

成功为卡片充值。

card_id
string
必填

卡片的唯一标识符。

示例:

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

card_order_id
string
必填

卡订单的 ID。

示例:

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

order_type
enum<string>
必填

订单类型。

可用选项:
CARD_CREATE,
CARD_RECHARGE,
CARD_WITHDRAW,
CARD_UPDATE,
CARD_ELEVATE_LIMIT
示例:

"CREATE_CARD"

amount
number
必填

该卡片的充值或提现金额。

必填范围: x > 0
示例:

100.02

card_currency
enum<string>
必填

卡币种。

可用选项:
SGD,
USD,
XUSD
示例:

"USD"

create_time
string
必填

对象的创建时间。

示例:

"2024-03-21T17:17:32+08:00"

update_time
string
必填

对象的更新时间。

示例:

"2024-03-21T17:17:32+08:00"

complete_time
string
必填

对象的完成时间。

示例:

"2024-03-21T17:17:32+08:00"

order_status
enum<string>
必填

此字段包含请求处理后的状态。

  • PENDING - 订单请求的初始状态。
  • PROCESSING - 此状态将通过 webhooks 通知。
  • SUCCESS - 订单请求的最终状态为成功。
  • FAILED - 订单请求的最终状态为失败。
可用选项:
PENDING,
PROCESSING,
SUCCESS,
FAILED