开发与接入

开发与接入指南: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 报表供财务对账与费用明细。

先了解,再开始。

关于服务范围、结算与出款差异,以及接入前准备。

API 适合哪些商户?

适合平台型、高频交易、需要自动建单、同步付款状态、批量出款或接入内部财务系统的商户。

是否一定要完成审核才提供 API 文件?

公开页说明核心接入能力;完整字段说明、沙盒环境、事件命名及权限配置,于商户审核通过后按服务范围提供。

Webhook 需要做签名验证吗?

建议使用签名验证、重试处理及幂等设计,避免重复入账或错误状态同步。

可以只接入 Dashboard 不接 API 吗?

可以。低频商户可先使用 Dashboard、Payment Link 或 Invoice,高频或平台型商户再接入 API。

商户咨询

准备查询?请一次带齐基本资料

公司、地区、用途与预计规模写清楚,回复会更快。证件可按审核清单稍后补交;初次无需附影本。

开始商户咨询