API 参考
89 个端点。每个端点一页，含参数表、响应示例与三种语言的调用样例。
发卡
GET
/v1/cards/products
可申请的卡产品（按商户授权的 BIN 过滤）
GET
/v1/cards
卡列表（前六后四，永不含完整卡号）
POST
/v1/cards/applications
提交开卡申请（虚拟/实体经 form_factor 区分）
动钱
GET
/v1/cards/applications/{id}
申请状态
POST
/v1/cards/{id}/secure-session
换取一次性卡密查看票据
GET
/v1/cards/{id}
卡详情（前六后四，永不含完整卡号）
GET
/v1/cards/{id}/transactions
卡消费流水（游标分页）
POST
/v1/cards/{id}/topup-quotes
充值到卡试算（不外呼上游）
POST
/v1/cards/{id}/topups
充值到卡（两段异步：到卡以 webhook 为准）
动钱
POST
/v1/cards/{id}/withdrawals
卡内资金转出到钱包（≠ 链上提现）
动钱
POST
/v1/cards/{id}/freeze
冻结卡片（过渡态 freezing）
POST
/v1/cards/{id}/unfreeze
解冻卡片（过渡态 unfreezing，与冻结分开的端点）
PATCH
/v1/cards/{id}/limits
设置用户自定义限额（0 = 未自设，落到产品上限）
GET
/v1/cards/{id}/close-check
销卡预检（必须先清空卡内资金）
POST
/v1/cards/{id}/close
销卡（不可逆）
POST
/v1/cards/bind
绑定实体卡（三要素；不挂强认证）
POST
/v1/cards/{id}/activate
激活实体卡（挂强认证且不可逆）
POST
/v1/cards/{id}/replacements
补/换卡申请（余额不在新旧卡之间直接转）
GET
/v1/cards/applications/{id}/shipment
实体卡物流（四条状态轴之一，不由其余派生）
接入
商户经营面
GET
/v1/merchant
商户资料、被授权产品、生效限额
GET
/v1/merchant/balances
商户资金账户（可用 / 冻结 / 待结算 / 托管声明）
GET
/v1/merchant/lines
本商户开通了哪几条业务线（含低水位自动停售状态）
GET
/v1/merchant/pending
因预付不足而排队的订单（笔数 / 逐资产 / 最早一笔）
GET
/v1/merchant/statements
业务扣款记录（每单最终从预付扣了多少）
GET
/v1/merchant/custody
托管核对（balanced=false = 有余额没有你的声明背书）
GET
/v1/merchant/deposit-addresses
预付充值地址清单
POST
/v1/merchant/deposit-addresses
申请预付充值地址（按 币×网络 复用）
沙盒
POST
/v1/sandbox/faucet
沙盒 · 给你的沙盒预付账户补钱
动钱
GET
/v1/sandbox/upstream-behaviors
沙盒 · 当前为各家上游预置了什么行为
POST
/v1/sandbox/upstream-behavior
沙盒 · 预置某家上游的返回行为
POST
/v1/sandbox/reset
沙盒 · 清掉投递记录与调用日志
资产目录
会员
GET
/v1/members
会员列表（游标分页）
POST
/v1/members
建会员
GET
/v1/members/{id}
会员详情（KYC 层级、处置态）
PATCH
/v1/members/{id}
改商户侧属性（昵称、语言）
POST
/v1/members/{id}/suspend
商户级停用（不影响该人在其他商户）
POST
/v1/members/{id}/sessions/revoke
强制会员下线（不是封禁，可立刻重登）
GET
/v1/members/{id}/limits
该会员的额度占用（只读，不下发上限）
KYC
GET
/v1/kyc
KYC 结论（level + 最小字段，无影像、无档案）
GET
/v1/kyc/requirements
各业务线要求的 KYC 层级
GET
/v1/kyc/supplements
待补件请求与我方托管的填写链接
Webhook
GET
/v1/webhooks/deliveries
Webhook 投递记录（不含 payload）
POST
/v1/webhooks/deliveries/{id}/redeliver
重投（只有 dead / failed / no_subscriber 可重投）
汇款 · 收款人
GET
/v1/remit/corridors
可用走廊（按商户授权过滤）
GET
/v1/remit/payee-form-schema
该走廊要填哪些字段（先验走廊再给表单）
GET
/v1/remit/payees
收款人列表（含 name_mismatch 风控位）
POST
/v1/remit/payees
新建或关联收款人（建档不碰上游）
DELETE
/v1/remit/payees/{id}
解除关联（删的是关联不是主体）
POST
/v1/remit/quotes
汇款试算（不建单不冻结；必读 applied_rate）
汇款
GET
/v1/remittances/{id}
汇款订单详情
GET
/v1/remittances
汇款订单列表
POST
/v1/remittances
下单（付款重试沿用同一把幂等键）
动钱
POST
/v1/remittances/{id}/cancel
取消（只有 needs_reconfirm 可撤）
动钱
POST
/v1/remittances/{id}/reconfirm
接受涨价并补冻（4 小时时效）
动钱
GET
/v1/remittances/{id}/pending-action
这单在等用户做什么（重新确认 / 补件 / 无）
扫码付
GET
/v1/qrpay/orders/{id}
扫码付订单详情
POST
/v1/qrpay/decode
解码收款码（纯读，不建单不锁钱）
POST
/v1/qrpay/payments
扫码付款（先锁钱再放行；processing = 结果不明，等 webhook）
动钱
GET
/v1/qrpay/orders
扫码付订单列表
GET
/v1/qrpay/schemes
可用码制（随上游同步，不是静态常量）
兑换
GET
/v1/exchange/pairs
币对（按方向配：A→B 与 B→A 是两条独立记录）
POST
/v1/exchange/quotes
兑换报价（只读，不建单、不锁钱）
GET
/v1/exchange/orders
兑换订单列表（游标分页）
POST
/v1/exchange/orders
兑换成交（原子 · 不可逆 · 无中间态）
动钱
站内转账
GET
/v1/transfers/recipient-types
收款人标识方式白名单（由服务端下发）
POST
/v1/transfers/resolve
解析收款人（返回脱敏昵称供二次确认）
GET
/v1/transfers
转账列表（收发两侧都在内，游标分页）
POST
/v1/transfers
发起站内转账（一步到账，没有待审态）
动钱
GET
/v1/transfers/{id}
站内转账详情（原子、不可逆、无中间态）
理财
GET
/v1/earn/products
理财产品（按 grant_scope + 授权表过滤）
GET
/v1/earn/positions
持仓与累计收益
GET
/v1/earn/products/{id}
理财产品详情
POST
/v1/earn/subscriptions
申购（活期余额包 / 定期一单一行）
动钱
POST
/v1/earn/redemptions
活期赎回（LIFO；定期不可提前赎回）
动钱
GET
/v1/earn/orders
定期订单列表（利率是下单那一刻的快照）
PATCH
/v1/earn/orders/{id}/rollover
改到期处理方式（枚举 principal_interest，不是 both）
余额
流水
入金
提现
POST
/v1/withdrawals
提现扣账（available → withdrawing）
动钱
GET
/v1/withdrawals/{id}
提现详情
POST
/v1/withdrawals/{id}/confirm
商户完成链上出款后确认
动钱
POST
/v1/withdrawals/{id}/fail
上链失败，全额退回可用
动钱