首页 / API 文档

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 升序拼 a=b&c=d + 商户密钥，MD5 转大写；sign 与 sign_type 不参与签名。

2. 易支付协议

Java 签名示例

TreeMap<String,String> p = new TreeMap<>();
p.put("pid", "5001"); p.put("money", "99.00");
p.put("out_trade_no", "LS20261009001");
String qs = String.join("&", entry -> entry.getKey() + "=" + entry.getValue());
String sign = DigestUtils.md5Hex(qs + key).toUpperCase();

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

回调携带 trade_status=TRADE_SUCCESS，验签通过输出 success；失败按 1/2/5/10 分钟重试 4 次。

3. 彩虹易支付兼容

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

4. 轮询分发配置

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

三因子调度：权重 × 限额 × 实时成功率；异常熔断秒级生效，恢复后自动回归轮询池。

5. 码支付 / 免签支付

POST /api/codepay/create
{ "pid": 5001, "money": "39.90",
"out_trade_no": "LS20261009002", "sign": "..." }

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

6. 一码多付

接口	说明
`/api/qrcode/one`	订单模式聚合码（固定金额）
`/api/qrcode/static`	商家静态码，可绑定门店 / 员工
`/api/qrcode/batch`	批量生成（连锁场景）

7. 聚合代付

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

单笔与批量（200 笔/次）；状态回调 SUCCESS / FAIL，流水自动进黑账板。

8. 对账报表 API

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

9. 错误码

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

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