接入流程
获取商户号与密钥后,按以下三步即可发起首笔收款。
1
获取密钥
商户后台获取 pid 与 key
2
签名下单
MD5 签名后提交支付请求
3
处理回调
校验异步通知并返回 success
1. 发起支付(GET/POST)
请求地址:https://your-domain.com/submit.php,参数与易支付协议保持一致。
GET /submit.php?pid=1001&type=wxpay&out_trade_no=20261003001
¬ify_url=https://your-site.com/notify.php
&return_url=https://your-site.com/return.php
&name=VIP会员&money=29.90&sign=【MD5签名】&sign_type=MD5
2. 签名规则
将参与签名的参数按 ASCII 升序拼接为 a=b&c=d 形式,末尾拼接商户密钥后取 MD5,即:
sign = md5( money=29.90&name=VIP会员¬ify_url=...&out_trade_no=20261003001
&pid=1001&return_url=...&type=wxpay + KEY )
3. 异步回调(notify_url)
支付成功后平台会向 notify_url 发起 POST 通知,商户验签通过后输出 success 即表示接收完成,否则平台将按策略重试通知。
POST notify.php trade_status = TRADE_SUCCESS out_trade_no = 20261003001 money = 29.90 sign = 【MD5签名】 // 验签通过后响应 echo "success";
4. 聚合代付接口
调用 /mapi.php 的 transfer 服务发起代付,支持单笔与批量出款,出款结果通过异步通知回传。
POST /mapi.php pid = 1001 service = transfer out_biz_no = DF20261003001 payee_account = 收款账号 payee_name = 收款人 money = 500.00 sign = 【MD5签名】
5. 通道轮询说明
下单时无需指定具体通道(type 可传 auto),平台将按商户配置的通道权重执行轮询支付调度;也可以显式指定 type=wxpay / alipay / qqpay 走固定通道。