接口说明及规范
接口请求请使用部署后的正式域名，当前示例接口域名为 https://pay.example.com，可在后台修改。
提交数据格式application/x-www-form-urlencoded
返回数据格式JSON
字符编码UTF-8
签名算法SHA256WithRSA
V2 接口说明
- V2 接口统一使用 RSA 签名，适合退款、代付、查询等高安全场景。
- 每次请求建议携带
timestamp，服务端可据此校验请求时效。 - 业务系统收到异步通知后，需要校验签名并返回
success。
签名规则
签名生成前请排除 sign、sign_type 和空值字段，再按参数名升序拼接。
01排序字段按参数名 ASCII 升序排列。
02拼接字符串格式为
a=b&c=d，参数值不做 URL 编码。03私钥签名使用商户私钥执行 SHA256WithRSA 签名。
04平台验签平台使用商户公钥验证请求合法性。
merchant_no=M202605060001
out_trade_no=ORDER_20260506_10086
amount=19900
timestamp=2026-05-09T12:00:00+08:00页面跳转支付
用于用户前台发起收银台支付，适合网站、H5、简单业务系统直接跳转。
POST / GEThttps://pay.example.com/submit.php
| 字段 | 必填 | 说明 |
|---|---|---|
| merchant_no | 是 | 商户编号 |
| out_trade_no | 是 | 商户系统订单号，需保持唯一 |
| name | 是 | 商品或服务名称 |
| amount | 是 | 订单金额，单位可按系统配置约定 |
| notify_url | 是 | 服务器异步通知地址 |
| return_url | 否 | 页面跳转通知地址 |
| sign | 是 | 请求签名 |
统一下单接口
后端服务调用统一下单接口后，可根据返回的支付链接、二维码或小程序链接引导用户完成支付。
POSThttps://pay.example.com/api/pay/create
{
"merchant_no": "M202605060001",
"out_trade_no": "ORDER_20260506_10086",
"channel": "wechat",
"amount": 19900,
"notify_url": "https://your-domain.com/pay/notify",
"return_url": "https://your-domain.com/pay/return",
"timestamp": "2026-05-09T12:00:00+08:00",
"sign": "SHA256_WITH_RSA"
}| 返回字段 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码，0 表示请求成功 |
| message | string | 失败时返回原因 |
| trade_no | string | 平台支付订单号 |
| pay_url | string | 支付跳转地址 |
| qr_code | string | 二维码内容或链接 |
订单查询
用于业务系统主动查询订单状态，建议支付完成页、客服后台、补单任务中使用。
GET / POSThttps://pay.example.com/api/pay/query
| 字段 | 必填 | 说明 |
|---|---|---|
| merchant_no | 是 | 商户编号 |
| trade_no | 二选一 | 平台订单号 |
| out_trade_no | 二选一 | 商户订单号 |
| timestamp | 是 | 请求时间戳 |
| sign | 是 | 请求签名 |
支付结果通知
平台会向下单时传入的 notify_url 推送支付结果。业务系统需先验签，再更新订单。
处理要求
验签成功并完成业务处理后，请输出
success。如果返回其它内容，平台可能按策略重试通知。
| 字段 | 说明 |
|---|---|
| trade_no | 平台支付订单号 |
| out_trade_no | 商户订单号 |
| channel | 支付渠道 |
| amount | 订单金额 |
| trade_status | 支付状态，成功状态为 TRADE_SUCCESS |
| sign | 平台通知签名 |
订单退款
退款接口适合订单售后、部分退款和运营后台退款流程。正式调用前请在商户后台开启退款权限。
POSThttps://pay.example.com/api/pay/refund
| 字段 | 必填 | 说明 |
|---|---|---|
| merchant_no | 是 | 商户编号 |
| trade_no | 二选一 | 平台支付订单号 |
| out_trade_no | 二选一 | 商户订单号 |
| refund_amount | 是 | 退款金额 |
| refund_reason | 否 | 退款原因 |
| sign | 是 | 请求签名 |
商户接口
商户接口用于查询账户状态、余额、订单列表和结算信息。
GET/api/merchant/info查询商户信息与可用余额
GET/api/merchant/orders分页查询订单列表
GET/api/merchant/settlements查询结算记录
支付方式列表
wechat微信支付
alipay支付宝
unionpay银联支付
cashier平台收银台
SDK 下载
正式项目可在后台补充 PHP、Java、Node.js 等 SDK 下载地址。当前页面先保留接入说明与示例代码。