API 参考
119 个端点。每个端点一页，含参数表、响应示例与三种语言的调用样例。
发卡
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}/merchant-rules
读这张卡的商户 / MCC 名单
PUT
/v1/cards/{id}/merchant-rules
整份替换商户 / MCC 名单（白名单或黑名单，二选一）
DELETE
/v1/cards/{id}/merchant-rules
清空这张卡的名单（恢复成不受限）
PATCH
/v1/cards/{id}/billing-address
改账单地址（美国线上商户 AVS 校验的对象）
POST
/v1/cards/{id}/lost
挂失 / 报盗卡（不可逆，仅实体卡）
GET
/v1/cards/{id}/close-check
销卡预检（必须先清空卡内资金）
POST
/v1/cards/{id}/close
销卡（不可逆）
POST
/v1/cards/bind
绑定实体卡（三要素；不挂强认证）
POST
/v1/cards/{id}/activate
激活实体卡（挂强认证且不可逆）
POST
/v1/cards/{id}/pin
改 / 重置 PIN（忘了旧 PIN 走 CVV 那一支）
POST
/v1/cards/{id}/replacements
补/换卡申请（余额不在新旧卡之间直接转）
GET
/v1/cards/applications/{id}/shipment
实体卡物流（四条状态轴之一，不由其余派生）
沙盒
GET
/v1/sandbox/card-scenarios
沙盒 · 可模拟的卡交易场景清单
POST
/v1/sandbox/cards/{id}/simulate
沙盒 · 让上游推一笔卡交易过来
动钱
POST
/v1/sandbox/faucet
沙盒 · 给你的沙盒预付账户补钱
动钱
GET
/v1/sandbox/upstream-behaviors
沙盒 · 当前为各条业务线预置了什么行为
POST
/v1/sandbox/upstream-behavior
沙盒 · 预置某家上游的返回行为
POST
/v1/sandbox/reset
沙盒 · 清掉投递记录与调用日志
接入
商户经营面
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
申请预付充值地址（按 币×网络 复用）
GET
/v1/merchant/conversion-pairs
预付资产内部调剂 · 可换的方向与当前参考价
GET
/v1/merchant/conversions
内部调剂的成交记录
POST
/v1/merchant/conversions
预付资产内部调剂（原子 · 不可逆 · 无中间态）
动钱
GET
/v1/merchant/payout-addresses
你的提现地址簿（只读，没有 POST）
GET
/v1/merchant/payouts
你提过的提现单（只读，没有发起口）
GET
/v1/merchant/topups
预付充值单（链上到账 + 线下结算两条腿）
POST
/v1/merchant/topups
申报一笔预付充值（主要用于线下结算）
资产目录
会员
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 层级
POST
/v1/kyc/sessions
发起一次 L1 实名（我方托管屏，返回一条链接）
GET
/v1/kyc/supplements
待补件请求与我方托管的填写链接
Webhook
GET
/v1/webhooks/deliveries
Webhook 投递记录（不含 payload）
POST
/v1/webhooks/deliveries/{id}/redeliver
重投（只有 dead / failed / no_subscriber 可重投）
对账报表
GET
/v1/reports
我的导出任务列表
POST
/v1/reports
建一个对账报表导出任务（异步 · 出 CSV）
GET
/v1/reports/{id}
单个导出任务的状态（这是轮询口）
GET
/v1/reports/{id}/content
取导出件（响应体是 CSV，不是 JSON）
汇款 · 收款人
GET
/v1/remit/corridors
可用走廊（按商户授权过滤）
GET
/v1/remit/rates
牌价（不建单、不要收款人）
GET
/v1/remit/conversion-dates
可交割日（「几号到」的预告）
GET
/v1/remit/swift-search
银行目录搜索（BIC / 行名 → 行名 + 地址）
GET
/v1/remit/payee-form-schema
该走廊要填哪些字段（先验走廊再给表单）
GET
/v1/remit/payees
收款人列表（含 name_mismatch 风控位）
POST
/v1/remit/payees
新建或关联收款人（建档不碰上游）
GET
/v1/remit/payees/{id}
单条收款人（含 upstream_status）
DELETE
/v1/remit/payees/{id}
解除关联（删的是关联不是主体）
POST
/v1/remit/payees/{id}/verify
提前把收款人送去上游建档（不动一分钱）
GET
/v1/remit/products
汇款两条线的下单前置（用途码 / 滑点 / 最低起汇额 / 限额）
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/quotes
报价（收银台确认页的数字；建上游待支付单，不锁钱）
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
兑换报价（默认只读；带 lock 才锁价）
GET
/v1/exchange/orders
兑换订单列表（游标分页）
POST
/v1/exchange/orders
兑换成交（原子 · 不可逆 · 无中间态）
动钱
GET
/v1/exchange/orders/{id}
兑换单详情（按 id 查一笔）
站内转账
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）
余额
流水
入金
提现
GET
/v1/withdrawals
提现列表（游标分页 + 四个筛选）
POST
/v1/withdrawals
提现扣账（available → withdrawing）
动钱
GET
/v1/withdrawals/{id}
提现详情
POST
/v1/withdrawals/{id}/confirm
商户完成链上出款后确认
动钱
POST
/v1/withdrawals/{id}/fail
上链失败，全额退回可用
动钱