跳转到主要内容
本指南将引导你在沙盒环境中签发一张虚拟卡。完成之后，你将拥有一位持卡人和一张已激活的虚拟卡，可用于模拟交易。
前置条件
  • 已启用 Card Issuance 的 UQPAY 沙盒账户
  • 通过 Access Token 接口获取的 API Token
  • 已安装 UQPAY CLI（推荐），或 curl
1

创建持卡人

持卡人代表将使用这张卡的人。用姓名、邮箱、手机号和国家代码创建一个持卡人。
响应：
保存 cardholder_id —— 创建卡片时需要用到它。
某些卡产品需要 Enhanced KYC。如果 cardholder_status 返回 PENDING，持卡人需要先完成身份验证才能签发卡片。参见 KYC 验证。
2

查找卡产品

卡产品定义了 BIN、卡组织、资金模式和支持的币种。列出你账户下可用的卡产品。
找一个 card_form 包含 VIR（虚拟）的卡产品。沙盒模拟场景下，使用 BIN 为 40963608 的卡产品 —— 这是唯一支持 Simulate Authorization 接口的 BIN。卡产品示例（节选）：
保存 product_id，下一步会用到。
3

创建一张虚拟卡

使用你选中的卡产品，为持卡人签发一张虚拟卡。
响应：
卡片初始状态为 PENDING。几秒后，状态将变为 ACTIVE，同时触发 card.create.succeeded webhook。虚拟卡不需要激活。
4

验证卡片

查询卡片，确认它已激活。
响应：
卡片状态为 ACTIVE，可用余额为 1000.00 USD。可以用于模拟交易。

​
下一步

模拟交易

使用 Simulator API 测试授权和冲正流程。

核心概念

了解卡形态、资金模式和配置选项。

消费限额

设置单笔限额和商户类别限制。

卡生命周期

冻结、解除冻结或注销卡片。