首页 / 开发文档

开发文档

兼容易支付 / 彩虹易支付协议；覆盖轮询分发、码支付与免签回调、一码多付、聚合代付与对账报表。以下均为演示示例。

1. 快速开始

入驻获取 pid 与密钥 key，统一网关（部署后替换域名）：

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

2. 易支付协议

2.1 下单参数

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

2.2 签名（Python 示例）

import hashlib
params = {'pid':'4001', 'money':'99.00', 'out_trade_no':'JS20261009001'}
qs = '&'.join(f'{k}={params[k]}' for k in sorted(params))
sign = hashlib.md5((qs + key).encode()).hexdigest().upper()

回调携带 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": 4001, "money": "39.90",
"out_trade_no": "JS20261009002", "sign": "..." }

金额指纹 + 订单指纹双校验，金额碰撞自动分位差异化。

6. 一码多付

接口	说明
`/api/qrcode/one`	订单模式聚合码（固定金额）
`/api/qrcode/static`	商家静态码，可绑定门店 / 员工

7. 聚合代付

POST /api/transfer/create
{ "pid": 4001, "out_biz_no": "JSDP20261009001",
"payee_account": "6222xxxxxxxx8866", "money": "860.00",
"notify_url": "https://your-site/dp", "sign": "..." }

批量上限 200 笔/次；出款流水自动计入对账账本。

8. 对账账本接口

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

9. 错误码

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

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