跳转到主要内容
POST
Assign Card

授权

x-auth-token
string
header
必填

由 UQPay 提供的登录 API Token。

请求头

x-on-behalf-of
string

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

x-idempotency-key
string<uuid>
必填

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

请求体

application/json
cardholder_id
string<uuid>
必填

持卡人的唯一标识符。

示例:

"5135e6cc-28b6-4889-81dc-3b86a09e1395"

card_number
string
必填

卡号。

示例:

"4096360800133951"

card_currency
string
必填

分配给该卡片的币种。

示例:

"USD"

card_mode
enum<string>
必填

卡模式。

可用选项:
SINGLE,
SHARE
示例:

"SINGLE"

响应

200 - application/json

成功绑定卡片。

card_id
string
必填

卡片的唯一标识符。

示例:

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

card_order_id
string
必填

卡订单的 ID。

示例:

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

create_time
string
必填

对象的创建时间。

示例:

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

card_status
enum<string>
必填

卡片状态枚举。更多信息参见卡生命周期与状态指南。

  • PENDING:创建卡片的请求已收到,正在审核中。
  • ACTIVE:创建卡片的请求成功,卡片可以使用。
  • FROZEN:所有进入的授权请求都将被拒绝。卡片可以重新激活以接受新的授权。
  • BLOCKED:因可疑活动,卡片被 UQPAY 锁定。
  • PRE_CANCEL:卡片已被安排注销,处于等待期,期间所有进入的授权请求都将被拒绝。等待期结束后转为 CANCELLED
  • CANCELLED:卡片无法再从此状态重新激活,所有进入的授权请求都将被永久拒绝。
  • LOST:卡片已向 UQPAY 报失。
  • STOLEN:卡片已向 UQPAY 报被盗。
  • FAILED:使用 创建卡片 创建卡片的请求失败。
可用选项:
PENDING,
ACTIVE,
FROZEN,
BLOCKED,
PRE_CANCEL,
CANCELLED,
LOST,
STOLEN,
FAILED
示例:

"ACTIVE"

order_status
enum<string>
必填

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

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