API 文档 - 易支付协议_彩虹易支付_轮询支付_聚合代付_一码多付接口

1. 快速开始

商户后台获取 pid 与 key 后，即可调用多通道收款平台统一网关：

# 统一网关（部署后替换域名）
https://your-domain.com/submit.php    # 页面跳转支付
https://your-domain.com/mapi.php      # API 支付
https://your-domain.com/api.php?act=order  # 订单查询

签名规则与易支付一致：参数 ASCII 升序拼接 + 商户密钥，MD5 后转大写。

2. 易支付协议

参数	必填	说明
`pid`	是	商户 ID
`type`	否	wxpay / alipay / bank；留空由轮询引擎选路
`out_trade_no`	是	商户订单号（唯一）
`notify_url`	是	异步回调地址
`name` / `money`	是	商品名 / 金额（元）
`sign` / `sign_type`	是	MD5 签名 / MD5

Node.js 示例

const crypto = require('crypto');
const p = { pid: '3001', out_trade_no: 'XS20261009001', money: '99.00', notify_url: 'https://your-site/notify' };
const qs = Object.keys(p).sort().map(k => k + '=' + p[k]).join('&');
const sign = crypto.createHash('md5').update(qs + key).digest('hex').toUpperCase();

回调携带 trade_status=TRADE_SUCCESS，验签通过输出 success，否则按 1/2/5/10 分钟重试。

3. 彩虹易支付兼容

完整兼容彩虹易支付 V7：商户 API、订单查询、退款查询参数一致；/pay/ 收银台路径兼容；码支付与免签监听插件可直接复用，迁移成本几乎为零。

4. 轮询分发配置

通道	默认权重	说明
易支付通道	40	主力收款
码支付通道	30	小额高频
彩虹易支付通道	20	备份
免签支付通道	10	兜底

三因子调度：权重 × 限额 × 实时成功率；异常通道自动熔断，恢复自动回归，切换约 3 秒。

5. 码支付 / 免签支付

POST /api/codepay/create
{ "pid": 3001, "money": "39.90",
"out_trade_no": "XS20261009002",
"notify_url": "https://your-site/notify", "sign": "..." }

免签监听采用金额指纹 + 订单指纹双校验；金额碰撞时自动追加分位差异化。

6. 一码多付

接口	说明
`/api/qrcode/one`	订单模式聚合码（固定金额）
`/api/qrcode/static`	商家静态码（金额用户输入）
`/api/qrcode/batch`	批量生成门店码 / 员工码

7. 聚合代付

POST /api/transfer/create
{ "pid": 3001, "out_biz_no": "XSDP20261009001",
"payee_account": "6222xxxxxxxx8866", "payee_name": "王五",
"money": "860.00", "notify_url": "https://your-site/dp", "sign": "..." }

批量上限 200 笔/次；状态回调 SUCCESS / FAIL，流水自动进入对账系统。

8. 商户聚合对账系统报表 API

接口	说明
`/api/recon/summary?date=`	按日通道汇总（笔数 / 金额 / 差异）
`/api/recon/detail?date=`	逐笔三方勾兑明细
`/api/recon/diff`	差异订单列表（人工复核）
`/api/recon/export`	CSV 报表导出（日 / 周 / 月）

9. 错误码

code	含义	建议
`0`	成功	—
`1001`	签名错误	检查密钥与排序规则
`2001`	无可用通道	检查轮询配置与余额
`2004`	订单已支付	勿重复发起
`3002`	代付限额不足	调整当日额度

※ 接口为演示样例，正式以平台文档为准。