API 中心

OpenAPI 文档下载

两份文件均可直接导入 Bruno 或其他兼容 OpenAPI 的工具，用于调试与集合管理。

如何选择文档

代理商户

使用 unipay-agent.yaml。上游渠道对代理商户透明，请求不传 channel，后端按所属 ISV 的启用渠道配置自动选路。

特殊商户

使用 unipay-special.yaml。特殊商户可以显式配置并选择上游渠道，支付、转账、转账预查询请求需要传 channel。

接口分组

统一交易接口

POST /unipay/pay
POST /unipay/refund
POST /unipay/close
POST /unipay/inqury
POST /unipay/transfer

统一查询接口

POST /unipay/query/payOrder
POST /unipay/query/refundOrder
POST /unipay/query/transferOrder

统一同步接口

POST /unipay/sync/order/pay
POST /unipay/sync/order/refund

文档覆盖内容

请求/响应签名规则
公共请求字段与响应信封
每个接口的请求示例、成功示例、失败示例
通用错误码与支付域错误码

补充说明见签名与安全与错误码。