ePay V2 接口文档整理

1. 协议规则

2. V2 升级说明

1. V2 全面使用 RSA 签名，V1 保留 MD5 签名。
2. V2 改用新的接口地址，支持退款、代付等能力。
3. V2 增加 timestamp 参数和返回值，用于时间戳校验。
4. V1/V2 下单接口均支持可选参数 channel_id：传入后指定支付通道，不传时按商户路由策略轮询选路。

3. RSA 密钥对

• 在商户后台的 API 信息页面生成商户 RSA 密钥对。
• 商户需要妥善保管私钥。
• 对接时通常会同时使用平台公钥和商户私钥。

4. 签名规则

4.1 请求签名

1. 取所有非空参数。
2. 排除 sign、sign_type。
3. 排除数组、文件、二进制等非普通字段。
4. 按参数名 ASCII 升序排序。
5. 以 k=v&k2=v2... 的方式拼接原文。
6. 使用商户私钥进行 SHA256WithRSA 签名。

4.2 验签规则

1. 按相同规则整理原文。
2. 使用平台公钥验证签名。
3. 请求和响应都应做签名校验。

5. 支付方式列表

5.1 通联收银宝通道（已开通）

平台已对接通联收银宝统一下单 / H5 收银台。下单时通过 type + channel_id 指定产品形态（部分商户关闭了轮询，必须传 channel_id）。

• 在线联调：V1 mapi 测试工具（可直接展示二维码 / H5 链接）· 订单查询（V1/V2）
• channel_id 以商户后台「可用通道」为准；上表为正式环境当前平台通道编号
• 云闪付码需用云闪付 App 扫；微信扫码码需用微信扫；H5 链接建议在微信/支付宝内打开

# 云闪付 U01 示例（V1 mapi）
curl -X POST "https://api.speed-pay.org/mapi.php" \
  -d "pid=1001" \
  -d "type=unionpay" \
  -d "channel_id=5" \
  -d "out_trade_no=ORDER20261108001" \
  -d "name=云闪付测试" \
  -d "money=0.01" \
  -d "notify_url=https://merchant.example.com/notify" \
  -d "return_url=https://h5.speed-pay.org/" \
  -d "clientip=127.0.0.1" \
  -d "sign_type=MD5" \
  -d "sign=YOUR_MD5_SIGN"

# 通联 H5 收银台示例
curl -X POST "https://api.speed-pay.org/mapi.php" \
  -d "pid=1001" \
  -d "type=wxpay" \
  -d "channel_id=7" \
  -d "out_trade_no=ORDER20261108002" \
  -d "name=H5支付测试" \
  -d "money=0.01" \
  -d "notify_url=https://merchant.example.com/notify" \
  -d "return_url=https://h5.speed-pay.org/" \
  -d "clientip=127.0.0.1" \
  -d "sign_type=MD5" \
  -d "sign=YOUR_MD5_SIGN"
# 成功时返回 payurl=https://api.speed-pay.org/allinpay/h5/PAY...

6. 设备类型列表

7. 接口总览

8. 页面跳转支付

8.1 接口说明

• URL：https://api.speed-pay.org/api/pay/submit
• 用途：前台页面跳转支付
• 请求方式：POST
• type 可不传，不传时进入收银台
• channel_id 可不传，不传时按商户路由策略轮询选路

8.2 请求参数

9. API 创建订单

9.1 接口说明

• URL：https://api.speed-pay.org/api/pay/create
• 用途：服务器端统一创建订单
• 请求方式：POST
• channel_id 可不传，不传时按商户路由策略轮询选路

9.2 请求参数

9.3 返回结果

9.4 pay_type 说明

9.5 Speed Pay 身份授权扩展

当前 Speed Pay 实现中，V2 创建订单如果路由到需要用户身份的产品，例如微信公众号、微信小程序、支付宝小程序，但请求没有传 openid、mini_openid、buyer_id 等字段，会返回身份承接地址：

{
  "code": 0,
  "msg": "identity_required",
  "trade_no": "",
  "pay_type": "identity",
  "pay_info": "http://example.com/cashier/identity/xxx",
  "identity_required": 1,
  "identity_url": "http://example.com/cashier/identity/xxx",
  "resume_token": "xxx",
  "timestamp": "1778810000",
  "sign": "...",
  "sign_type": "RSA"
}

调用方收到 identity_required=1 后，应跳转 identity_url。页面跳转支付 /api/pay/submit 遇到身份缺失时会直接重定向到该承接页。

10. 订单查询

10.1 接口说明

• URL：https://api.speed-pay.org/api/pay/query
• 请求方式：POST

10.2 请求参数

10.3 返回结果

11. 支付通知

11.1 通知类型

• 异步通知：notify_url
• 页面跳转通知：return_url

11.2 请求参数

11.3 回调响应

• 收到异步通知后，返回 success
• 通知时要校验签名，并确认 trade_status == TRADE_SUCCESS

12. 退款

12.1 接口说明

• URL：https://api.speed-pay.org/api/pay/refund
• 请求方式：POST

12.2 请求参数

12.3 返回结果

13. 退款查询

13.1 接口说明

• URL：https://api.speed-pay.org/api/pay/refundquery
• 请求方式：POST

13.2 请求参数

13.3 返回结果

14. 关闭订单

14.1 接口说明

• URL：https://api.speed-pay.org/api/pay/close
• 请求方式：POST
• 仅支持部分支付插件

14.2 请求参数

14.3 返回结果

15. 商户信息

15.1 接口说明

• URL：https://api.speed-pay.org/api/merchant/info
• 请求方式：POST

15.2 请求参数

15.3 返回结果

16. 商户订单

16.1 接口说明

• URL：https://api.speed-pay.org/api/merchant/orders
• 请求方式：POST

16.2 请求参数

16.3 返回结果

17. 转账提交

17.1 接口说明

• URL：https://api.speed-pay.org/api/transfer/submit
• 请求方式：POST

17.2 请求参数

17.3 返回结果

18. 转账查询

18.1 接口说明

• URL：https://api.speed-pay.org/api/transfer/query
• 请求方式：POST

18.2 请求参数

18.3 返回结果

19. 转账余额

19.1 接口说明

• URL：https://api.speed-pay.org/api/transfer/balance
• 请求方式：POST

19.2 请求参数

19.3 返回结果