一、接口概述
易付派支付系统提供标准化的API接口,支持多种支付渠道,所有接口均通过HTTPS加密传输,确保数据安全。
- 基础请求地址:
https://payex.cc/
- 字符编码:UTF-8
- 数据格式:JSON
- 签名方式:MD5签名验证
二、基础接入流程
1. 申请商户账号
联系管理员开通商户账号,获取商户ID(pid)和商户密钥(key)。
2. 发起支付请求
通过POST方式向支付接口提交订单信息,生成支付链接。
POST /api.php?act=pay HTTP/1.1
Host: payex.cc
Content-Type: application/x-www-form-urlencoded
pid=你的商户ID&out_trade_no=商户订单号&money=订单金额&name=商品名称¬ify_url=异步通知地址&return_url=同步跳转地址&sign=签名
3. 处理支付结果
支付完成后,系统会向你的notify_url发送异步通知,同时用户会跳转到return_url。
三、签名算法说明
签名用于验证请求的合法性,防止数据被篡改,算法如下:
// 签名生成步骤
// 1. 将所有参数(不包含sign)按ASCII码从小到大排序
// 2. 拼接成key=value&key=value的格式
// 3. 在末尾加上商户密钥key
// 4. 进行MD5加密,得到32位小写字符串即为签名
sign = strtolower(md5("pid=1001&out_trade_no=20260511001&money=100.00&name=测试商品" + "你的商户密钥"));
四、异步通知说明
支付成功后,系统会向你的notify_url发送POST通知,参数如下:
- pid:商户ID
- out_trade_no:商户订单号
- trade_no:系统订单号
- money:支付金额
- status:支付状态(1为成功)
- sign:签名验证
注意:收到通知后必须返回字符串success,否则系统会重复发送通知。
五、常见问题
1. 支付请求报错怎么办?
检查商户ID和密钥是否正确,参数是否齐全,签名是否生成正确。
2. 收不到异步通知?
确保你的notify_url可以被公网访问,且服务器防火墙没有拦截来自我们服务器的请求。
3. 签名验证失败?
检查参数是否有多余空格,排序是否正确,密钥是否与商户后台一致。