创建卡片 - CBPay

授权

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>

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

可用选项:

USD,

USDT,

USDC,

BTC,

GOLD,

SILVER,

PLATINUM

limits

object

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

Show child attributes

cardholder

object

持卡人数据。账户首次开卡时会在发卡方创建持卡人:身份数据与文件会从账户已通过的身份验证自动填充(显式字段优先);你只需补充发卡方特有的字段(occupation 目录代码、salary_usd)。可选的 first_name 和 last_name 会覆盖卡面印刷姓名，合计不得超过 22 个 UTF-8 字节。后续开卡时可省略:直接复用已验证的持卡人。企业账户还可以设置 kind "person" 加上该人已通过 KYC 的 verification_id,为指定人员开卡(其身份与文件来自该验证)。

Show child attributes

响应

卡片已创建。

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/SILVER/PLATINUM 按每笔事件当时价格转换。默认 USD。修改仅影响之后的消费。

可用选项:

USD,

USDT,

USDC,

BTC,

GOLD,

SILVER,

PLATINUM

limits

object

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

Show child attributes

creation_fee

string

cancellation_fee

string

created_at

string<date-time>

updated_at

string<date-time>