接口地址：https://z-pay.cn/

测试商户ID（PID）：20220726190052

测试商户密钥（KEY）：vg9ZRZN4FOKtDM06UfqH69GDJoG4gGIJ

以上商户信息仅供测试使用，请勿直接用于正式环境，如果需要退还测试金额请于24小时内使用退款API发起

请求URL

https://z-pay.cn/submit.php

---

请求方法

POST 或 GET（推荐POST，不容易被劫持或屏蔽）
此接口可用于用户前台直接发起支付，使用form表单跳转或拼接成url跳转。

---

请求参数

---

用法举例

https://z-pay.cn/submit.php?name=iphone xs Max 一台&money=0.03&out_trade_no=201911914837526544601&notify_url=http://www.aaa.com/notify_url.php&pid=201901151314084206659771&param=金色 256G&return_url=http://www.baidu.com&sign=28f9583617d9caf66834292b6ab1cc89&sign_type=MD5&type=alipay

---

成功返回

直接跳转到付款页面
说明：该页面为收银台，直接访问这个url即可进行付款

---

失败返回

{"code":"error","msg":"具体的错误信息"}

请求URL

https://z-pay.cn/mapi.php

---

请求方法

POST（方式为form-data）

---

请求参数

---

成功返回

字段名	变量名	类型	示例值	描述
返回状态码	code	Int	1	1为成功，其它值为失败
返回信息	msg	String		失败时返回原因
订单号	trade_no	String	20160806151343349	支付订单号
支付跳转url	payurl	String	https://xxx.cn/pay/wxpay/202010903/	如果返回该字段，则直接跳转到该url支付
二维码链接	qrcode	String	https://xxx.cn/pay/wxpay/202010903/	如果返回该字段，则根据该url生成二维码
二维码图片	img	String	https://z-pay.cn/qrcode/123.jpg	该字段为付款二维码的图片地址

---

失败返回

{"code":"error","msg":"具体的错误信息"}

请求URL

https://z-pay.cn/api.php?act=order&pid={商户ID}&key={商户密钥}&out_trade_no={商户订单号}

---

请求方法

GET

---

请求参数

---

返回结果

请求URL

https://z-pay.cn/api.php?act=refund

---

请求方法

POST

---

请求参数

---

返回结果

请求URL

服务器异步通知（notify_url）、页面跳转通知（return_url）

---

请求方法

GET

---

请求参数

---

如何验证

请根据签名算法，验证自己生成的签名与参数中传入的签名是否一致，如果一致则说明是由官方向您发送的真实信息

---

注意事项

1.收到回调信息后请返回“success”，否则程序将判定您的回调地址未正确通知到。

2.同样的通知可能会多次发送给商户系统。商户系统必须能够正确处理重复的通知。

3.推荐的做法是，当收到通知进行处理时，首先检查对应业务数据的状态，判断该通知是否已经处理过，如果没有处理过再进行处理，如果处理过直接返回结果成功。在对业务数据进行状态检查和处理之前，要采用数据锁进行并发控制，以避免函数重入造成的数据混乱。

4.特别提醒：商户系统对于支付结果通知的内容一定要做签名验证,并校验返回的订单金额是否与商户侧的订单金额一致，防止数据泄漏导致出现“假通知”，造成资金损失。

5.对后台通知交互时，如果平台收到商户的应答不是纯字符串success或超过5秒后返回时，平台认为通知失败，平台会通过一定的策略（通知频率为0/15/15/30/180/1800/1800/1800/1800/3600，单位：秒）间接性重新发起通知，尽可能提高通知的成功率，但不保证通知最终能成功。

1、将发送或接收到的所有参数按照参数名ASCII码从小到大排序（a-z），sign、sign_type、和空值不参与签名！

2、将排序后的参数拼接成URL键值对的格式，例如 a=b&c=d&e=f，参数值不要进行url编码。

3、再将拼接好的字符串与商户密钥KEY进行MD5加密得出sign签名参数，sign = md5 ( a=b&c=d&e=f + KEY ) （注意：+ 为各语言的拼接符，不是字符！），md5结果为小写。

4、具体签名与发起支付的示例代码可下载SDK查看。