把六条金融业务线接进你自己的产品
一把 API Key、一套签名、一份幂等纪律。会员与 KYC、入金与提现、跨境汇款、 扫码付、虚拟卡与实体卡、兑换与转账、理财 —— 全部走同一份契约, 共 93 个端点。
按业务线开始
会员与 KYC建档 · 等级 · 处置 · 结论回查 · 11 个端点
GET
/membersPOST/membersGET/members/{id}PATCH/members/{id}
看全部 11 个 →
汇款收款人建档 · 报价 · 下单 · 补件 · 12 个端点
GET
/remittances/{id}GET/remittancesPOST/remittancesPOST/remittances/{id}/cancel
看全部 12 个 →
扫码付解码 · 报价 · 支付 · 6 个端点
GET
/qrpay/orders/{id}POST/qrpay/decodePOST/qrpay/quotesPOST/qrpay/payments
看全部 6 个 →
发卡开卡 · 充值 · 冻结解冻 · 实体卡 · 19 个端点
GET
/cards/productsGET/cardsPOST/cards/applicationsGET/cards/applications/{id}
看全部 19 个 →
兑换 · 转账 · 理财原子成交,无中间态 · 16 个端点
GET
/exchange/pairsPOST/exchange/quotesGET/exchange/ordersPOST/exchange/orders
看全部 16 个 →
先读这几篇
鉴权与签名一把 Key 两个值;PATH 必须进签名串
幂等什么时候沿用同一把键,什么时候必须换新
Webhook验签、去重、重投;事件体只带 ID 与状态
错误契约按
code 分支,不要按 HTTP 码分支
先读这三条,能省掉大半的接入返工
- 金额一律字符串定点,位数 = 该资产
ledger_scale。BSC 的 18 位小数超过2^53,用 JSON number 解析即精度事故。 - 504 用同一把幂等键重试(我方可能已经处理完);业务失败要换新键(同键会原样返回那次失败)。
- 未知状态值按未知处理并告警,不要 fallback 成「处理中」。我方承诺新增枚举前在变更日志登记。