创建卡片
发行一张卡片(虚拟或实体),以 Just-In-Time 方式从账户中央余额按卡片的消费资产扣款(spending_asset:USDT/USDC 与 USD 1:1,或 BTC/GOLD 按每笔事件当时价格转换;默认 USDT)——无需预充值:每笔消费都实时对照可用余额和卡片自身限额授权。个人账户可持有 1 张虚拟卡 + 1 张实体卡;企业账户可创建不限数量的卡片,为企业本身或指定人员(例如员工,传入其身份文件)。若配置了 card_creation_virtual / card_creation_physical 费用则在发卡时计费(0 = 免费);发卡失败自动退款。实体卡初始状态为 pending_activation,直到持卡人确认收到。
授权
会话 JWT(来自注册/登录)或 API key(pk_...)。
也接受 X-API-Key: <token> 作为替代请求头。
请求体
必填(也接受 Idempotency-Key 请求头)。使用相同键重试会返回原始卡片,绝不重复收取开卡费。
卡片消费扣款的余额。USDT/USDC 与 USD 等价(精确 1:1,无转换费)。BTC/GOLD 按每笔事件当时的有效价格转换,并在授权时预留缓冲(fail-closed 定价,单笔及 24 小时波动限额与 payouts 共享)。
USDT, USDC, BTC, GOLD 可选的 USD 消费限额(授权时执行;0 或省略 = 无限制)。
持卡人数据。账户首次开卡时会在发卡方创建持卡人:身份数据与文件会从账户已通过的身份验证自动填充(显式字段优先);你只需补充发卡方特有的字段(occupation 目录代码、salary_usd)。后续开卡时可省略:直接复用已验证的持卡人。企业账户还可以设置 kind "person" 加上该人已通过 KYC 的 verification_id,为指定人员开卡(其身份与文件来自该验证)。
响应
卡片已创建。
account, person pending_activation, active, frozen, cancelled 卡片消费扣款的余额。USDT/USDC 与 USD 1:1;BTC/GOLD 按每笔事件当时价格转换。默认 USDT。修改仅影响之后的消费。
USDT, USDC, BTC, GOLD 消费限额,始终以 USD 计,与消费资产无关。