开发文档 - 易支付协议_彩虹易支付_轮询支付_码支付_聚合代付接入指南

1. 快速开始

入驻后获取 pid 与商户密钥 key，网关地址（部署后替换域名）：

# 多通道收款平台统一网关
https://your-domain.com/submit.php    # 页面跳转支付
https://your-domain.com/mapi.php      # API 接口支付
https://your-domain.com/api.php?act=order  # 订单查询

签名方式为 MD5，参数按 ASCII 升序拼接后追加商户密钥取大写。

2. 易支付协议

2.1 下单参数

参数	必填	说明
`pid`	是	商户 ID
`type`	否	wxpay / alipay / bank；留空走轮询支付自动选路
`out_trade_no`	是	商户订单号，唯一
`notify_url`	是	异步回调地址
`return_url`	否	同步跳转地址
`name` / `money`	是	商品名 / 金额（元，两位小数）
`sign` / `sign_type`	是	MD5 签名

2.2 签名示例（PHP）

$str = 'money=99.00&name=会员套餐&notify_url=...&out_trade_no=HL20261009001&pid=2001';
$sign = strtoupper(md5($str . $key));

2.3 回调通知

支付成功后平台 GET 请求 notify_url，携带 trade_status=TRADE_SUCCESS 与签名；验签通过输出 success，失败按 1/2/5/10 分钟重试。

3. 彩虹易支付兼容

完整兼容彩虹易支付 V7 商户接口与插件体系：

能力	兼容情况
商户 API / 订单查询 / 退款查询	参数与彩虹易支付一致
收银台路径 `/pay/`	支持模板级兼容
码支付 / 免签监听插件	可直接复用

4. 轮询支付分发配置

轮询支付引擎按「权重 × 限额 × 实时成功率」三因子分发订单：

通道	权重	单笔限额	建议用途
易支付通道	40	¥5,000	主力收款
码支付通道	30	¥1,000	小额高频
彩虹易支付通道	20	¥2,000	备份通道
免签支付通道	10	¥500	兜底通道

通道连续失败达到阈值后自动降权，恢复后回归轮询池；切换耗时约 3 秒。

5. 码支付 / 免签支付

POST /api/codepay/create
{
  "pid": 2001,
  "money": "39.90",
  "out_trade_no": "HL20261009002",
  "notify_url": "https://your-site/notify",
  "sign": "签名"
}

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

6. 一码多付

调用一次接口生成聚合码，微信 / 支付宝 / 云闪付通用：

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

7. 聚合代付

POST /api/transfer/create
{
  "pid": 2001,
  "out_biz_no": "HLDP20261009001",
  "payee_account": "6222xxxxxxxx8866",
  "payee_name": "李四",
  "money": "1200.00",
  "notify_url": "https://your-site/dp-notify",
  "sign": "签名"
}

支持单笔与批量（单次最多 200 笔），出款状态异步回调，流水自动进入对账系统。

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

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

9. 错误码

code	含义	建议
`0`	成功	—
`1001`	签名错误	检查密钥与排序
`1003`	订单号重复	更换 out_trade_no
`2001`	无可用通道	检查轮询配置
`3002`	代付限额不足	调整当日额度

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