跳转到主要内容
POST

授权

Authorization
string
header
必填

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

请求头

Idempotency-Key
string

idempotency_key 请求体字段的替代方式。

请求体

application/json
amount
string
必填

正数十进制字符串,不超过该货币的小数位数(USDT/USDC/GOLD 为 6 位,BTC 为 8 位)。

示例:

"10.500000"

to_account_id
string<uuid>
to_email
string<email>
to_phone
string

目标账户的 E.164 手机号。只有 OTP 已验证手机号的账户能被解析(否则 404 recipient_not_found;若多个账户共用该号码则 422 recipient_ambiguous)。

to_contact_id
string<uuid>

直接发送给通讯录中的联系人(使用其关联的 CBPay 账户,或其已验证的手机号)。

to_qr_token
string

目标账户的个人资料二维码令牌(从其 CBPay 二维码扫描)。也接受扩展的结账二维码载荷(cbpay:pay?to=…&checkout=…)——嵌入的结账令牌会自动生效。

checkout_token
string

可选的通用收款链接令牌,用于直接支付该链接。目的账户被强制为链接的账户,金额必须覆盖服务端以所选资产报价的应付额(否则返回 422 checkout_amount_mismatch 并附最新应付额)。完成后链接结清并自动兑换为其 settlement_asset

asset
enum<string>
默认值:USDT

要划转的余额币种;接收方以同一币种入账。

可用选项:
USDT,
USDC,
BTC,
GOLD
description
string
idempotency_key
string
save_contact
boolean
默认值:true

收款目的地会自动保存为联系人;传 false 可跳过。

响应

幂等重放。

transfer_id
string<uuid>
from_account_id
string<uuid>
to_account_id
string<uuid>
asset
string
示例:

"USDT"

amount
string
description
string
status
string
示例:

"completed"

created_at
string<date-time>
idempotency_hit
boolean
最后修改于 2026年7月19日