首页 / 接入文档

接入文档

兼容易支付标准协议,老系统只需修改网关地址与密钥即可切换到智汇付。

QUICK START

三步完成收款接入

以下为易支付标准协议示例,本站为演示样例,参数以正式环境文档为准。

1. 创建订单(页面跳转支付)

请求地址:GET /submit.php

pid        = 1001                    // 商户ID
type       = wxpay | alipay          // 支付方式(部分通道可留空自动识别)
out_trade_no = 20261003180000001     // 商户订单号,唯一
notify_url = https://your-site.com/notify  // 异步通知地址
return_url = https://your-site.com/return  // 同步跳转地址
name       = 商品名称
money      = 19.90                   // 金额,保留两位小数
sign       = MD5(排序参数串+KEY)      // 签名,见下方规则
sign_type  = MD5

2. 签名规则

// 1. 将参数按 ASCII 升序排序(排除 sign、sign_type、空值)
// 2. 拼接为 a=1&b=2&c=3 形式
// 3. 末尾拼接商户密钥 KEY 后做 MD5,取小写
sign = md5("money=19.90&name=demo&...&" + KEY)

3. 异步通知(notify)处理

支付成功后系统会 POST/GET 请求 notify_url,验证通过请原样输出 success,否则将按 1/2/5/10 分钟间隔重试 5 次。

trade_status = TRADE_SUCCESS   // 交易状态
out_trade_no = 20261003180000001
trade_no     = PH20261003xxxx  // 智汇付平台订单号
money        = 19.90
sign         = ...             // 请在服务端验签后再处理业务

4. 轮询支付说明

在商户后台「通道配置」中为各通道设置权重与启用状态即可开启轮询;请求方无需修改任何参数,系统自动完成分流与失败改道。

5. 聚合代付接口(摘要)

POST /mapi.php?act=transfer
appid      = 1001
trade_no   = DF20261003001     // 代付批次号
payee      = 收款账户信息(视通道要求)
amount     = 500.00
notify_url = https://your-site.com/df-notify
sign       = ...

完整字段与错误码表请下载正式版文档(占位)。⚠️ 本站为前端演示,不含任何真实接口。

FAQ FOR DEV

开发者常见问题

验签一直失败怎么办?
检查参数排序是否为 ASCII 升序、是否误将 sign/sign_type/空值参与签名、KEY 是否与后台一致、MD5 是否转小写。
支持 RSA 签名吗?
支持。后台「密钥设置」中切换为 RSA 后,按彩虹易支付 RSA 规则上传公钥即可。
一码多付如何指定通道?
默认自动识别客户端路由;如需强制指定,可在下单时传入 type=wxpay 或 type=alipay 覆盖自动识别。
代付出款失败会退回余额吗?
会。代付失败金额将自动退回商户余额,并推送失败通知,可在后台查看失败原因。