跳转到主要内容
POST

授权

Authorization
string
header
必填

会话 JWT(来自注册/登录)或 API key(pk_...)。 也接受 X-API-Key: <token> 作为替代请求头。

请求体

application/json
idempotency_key
string
必填

必填(也接受 Idempotency-Key 请求头)。使用相同键重试会返回原始卡片,绝不重复收取开卡费。

physical
boolean
默认值:false
spending_asset
enum<string>
默认值:USDT

卡片消费扣款的余额。USDT/USDC 与 USD 等价(精确 1:1,无转换费)。BTC/GOLD 按每笔事件当时的有效价格转换,并在授权时预留缓冲(fail-closed 定价,单笔及 24 小时波动限额与 payouts 共享)。

可用选项:
USDT,
USDC,
BTC,
GOLD
limits
object

可选的 USD 消费限额(授权时执行;0 或省略 = 无限制)。

cardholder
object

持卡人数据。账户首次开卡时会在发卡方创建持卡人:身份数据与文件会从账户已通过的身份验证自动填充(显式字段优先);你只需补充发卡方特有的字段(occupation 目录代码、salary_usd)。后续开卡时可省略:直接复用已验证的持卡人。企业账户还可以设置 kind "person" 加上该人已通过 KYC 的 verification_id,为指定人员开卡(其身份与文件来自该验证)。

响应

卡片已创建。

card_id
string
account_id
string
physical
boolean
cardholder_kind
enum<string>
可用选项:
account,
person
cardholder_name
string
status
enum<string>
可用选项:
pending_activation,
active,
frozen,
cancelled
spending_asset
enum<string>

卡片消费扣款的余额。USDT/USDC 与 USD 1:1;BTC/GOLD 按每笔事件当时价格转换。默认 USDT。修改仅影响之后的消费。

可用选项:
USDT,
USDC,
BTC,
GOLD
limits
object

消费限额,始终以 USD 计,与消费资产无关。

creation_fee
string
cancellation_fee
string
created_at
string<date-time>
updated_at
string<date-time>
最后修改于 2026年7月18日