Assign Card
Card Lifecycle
Assign Card
将实体卡或批量创建的虚拟卡绑定给持卡人。
POST
Assign Card
授权
由 UQPay 提供的登录 API Token。
请求头
指定代表哪个子账户发起请求。应设置为 account_id,该值可通过 List Connected Accounts 接口获取。若省略或为空,则请求以主账户身份执行。
更多信息参见 关联账户。
用于维持操作幂等性的唯一标识符(UUID),确保同一操作的重复执行不会产生意外影响或重复。它有助于在网络错误、重试或失败的情况下保持数据一致性。
请求体
application/json
响应
200 - application/json
成功绑定卡片。
卡片的唯一标识符。
示例:
"c0cef051-29c5-4796-b86a-cd5b684bfad7"
卡订单的 ID。
示例:
"c0cef051-29c5-4796-b86a-cd5ee34bfad7"
对象的创建时间。
示例:
"2024-03-21T17:17:32+08:00"
卡片状态枚举。更多信息参见卡生命周期与状态指南。
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"
此字段包含请求处理后的状态。
PENDING- 订单请求的初始状态。PROCESSING- 此状态将通过 webhooks 通知。SUCCESS- 订单请求的最终状态为成功。FAILED- 订单请求的最终状态为失败。
可用选项:
PENDING, PROCESSING, SUCCESS, FAILED 
