接入流程
- 1
注册应用
在商户后台「API 接入」发起注册:填应用名与服务器 IP 白名单,密钥对在浏览器本地生成,下载并保管私钥。
- 2
拉取通道与试算
调用通道列表获取可用到账币种与字段要求;用试算接口在下单前拿到完整的扣款拆解。
- 3
下单
按币种要求提交收款人字段与到账金额。付款人资料由平台自动生成,无需传入。
- 4
轮询查单
按订单号轮询直到终态(成功 / 失败)。平台不推送回调。
签名与安全
- RSA-SHA256 请求签名:被签串包含 HTTP 方法、路径、时间戳与原始请求体
- 时间戳有效期校验,防重放
- IP 白名单:请求来源必须在应用登记的 IP 内
- 幂等:同一商户订单号重复提交返回同一订单
示例与文档
- 商户后台内置接入教程:Java / Python / PHP / Go / Node 示例,含签名实现
- 完整接口文档(参数、错误码、字段规则)在注册应用后于后台获取
- 错误码分层:参数、鉴权、资金、风控、上游各自独立区间,便于程序化处理
沙箱:平台提供独立的测试环境用于联调,测试凭证与地址在开通时提供。