接口地址：https://zpayz.cn/

测试商户ID（PID）：20220726190052

测试商户密钥（KEY）：vg9ZRZN4FOKtDM06UfqH69GDJoG4gGIJ

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

说明：进入会员中心，依次点击“支付渠道”-“API安全”即可查看自己的API接口信息。

请求URL

https://zpayz.cn/submit.php

---

请求方法

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

---

请求参数

---

用法举例

https://zpayz.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://zpayz.cn/mapi.php

---

请求方法

POST（方式为form-data）

---

请求参数

---

成功返回

---

失败返回

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

第一步：使用“API接口支付”获取到O_id参数

第二步：跳转 ZPAY 收银台小程序 appid 为: wx0723cca859965758

    小程序具体跳转代码：
    wx.navigateToMiniProgram({
        appId: 'wx0723cca859965758',
        path: 'pages/index/index?type=wxapp&O_id=123456', //请将123456替换为第一步获取到的O_id
        fail(res) {
            wx.showToast({
                title: res.errMsg,
                icon: 'none',
            });
        },
        success(res) {
            wx.showToast({
                title: 'ok',
                icon: 'none',
            });
        },
    });

支付成功或者取消，会跳回你的小程序，并携带参数:

    支付成功：
    extraData: {
        status: 'success'
    }

    支付取消：
    extraData: {
        status: 'cancel'
    }

请求URL

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

---

请求方法

GET

---

请求参数

---

返回结果

请求URL

https://zpayz.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查看。