开发与接入
开发与接入指南:Payment、Settlement 与账单付款 API,对账与 Webhook 一并设计
Payment API 处理多渠道收款;结算与账单付款 API 分别对应大额兑换与中小型出款。Webhook 与报表让三类流程在商户系统内可追踪、可对账。
开始商户咨询
SECURE INTEGRATION
接入前先确认权限、签名与对账规则
公开网站说明核心接入能力;完整 API 文件、沙盒环境、事件命名及状态流转,于商户审核通过后按服务范围提供。
- API key 权限需按用途区分,避免收款与出款权限混用。
- Webhook 建议使用签名验证、重试处理及幂等设计。
- 财务系统需按交易、费用、结算与出款四类资料对账。
- 高风险交易或大额出款可进入人工审核流程。
API 边界
三类 API:谁呼叫、什么事件、谁对账
为真实营运设计,而不只是付款按钮。
- Payment API:建单、取得付款地址、查询状态、处理付款确认事件。
- Settlement API:申请大额结算报价、查询兑换或保留加密货币的状态及费用。
- 账单付款 API:发起出款、查询状态及失败原因。
- Webhook 与 Dashboard:接收事件,供营运与财务统一查看。
接入设计要点
除接口外,还需处理对账、状态同步、错链、出款失败与费用核算。
- 支援 idempotency key,避免重复建单或出款。
- Webhook 须签名验证并支援重试。
- 高风险/大额可返回 review_required。
- CSV 报表供财务对账与费用明细。
FAQ常见问题
先了解,再开始。
关于服务范围、结算与出款差异,以及接入前准备。
API 适合哪些商户?
适合平台型、高频交易、需要自动建单、同步付款状态、批量出款或接入内部财务系统的商户。
是否一定要完成审核才提供 API 文件?
公开页说明核心接入能力;完整字段说明、沙盒环境、事件命名及权限配置,于商户审核通过后按服务范围提供。
Webhook 需要做签名验证吗?
建议使用签名验证、重试处理及幂等设计,避免重复入账或错误状态同步。
可以只接入 Dashboard 不接 API 吗?
可以。低频商户可先使用 Dashboard、Payment Link 或 Invoice,高频或平台型商户再接入 API。
商户咨询
准备查询?请一次带齐基本资料
公司、地区、用途与预计规模写清楚,回复会更快。证件可按审核清单稍后补交;初次无需附影本。
开始商户咨询