开发文档

协议规则

• 请求数据格式：application/x-www-form-urlencoded

• 返回数据格式：JSON

• 签名算法：MD5

• 字符编码：UTF-8

页面跳转支付

该接口适用于前端页面发起支付，支持 Form 表单跳转或 URL 拼接跳转。 接口地址：https://域名/submit.php请求方式：POST 或 GET（推荐 POST，降低劫持、屏蔽风险）

请求参数

表格

API 接口支付

后端服务端调用接口，返回支付跳转链接、二维码链接或小程序唤起地址。 接口地址：https://域名/mapi.php请求方式：POST

请求参数

表格

接口返回 JSON

表格

备注：payurl、qrcode、urlscheme 同一请求只会返回其中一个字段

支付结果通知

通知分为两类：服务器异步通知notify_url、前端页面跳转通知return_url请求方式：GET

回调参数

表格

重要：收到异步通知，业务处理完成后，页面直接输出字符串 success，代表接收成功。

MD5 签名算法

1. 将待签名全部参数，按照参数名 ASCII 码升序 (a-z)排序；sign、sign_type、空值参数不参与签名

2. 排序后拼接为 URL 键值对格式：a=b&c=d&e=f，参数值不要 URL 编码

3. 将拼接字符串末尾拼接商户密钥 KEY，执行 MD5，结果转为小写。公式：sign = md5(参数串 + KEY)

提示：+代表字符串拼接，不是文本加号字符

4. 签名示例、各语言 Demo 代码，可以前往【软件下载】获取 SDK。

渠道与设备枚举

支付方式列表

表格

设备类型列表

表格

API：查询商户信息

接口地址：https://域名/api.php?act=query&pid={商户ID}&key={商户密钥}

请求参数

表格

返回结果

表格

API：查询单个订单

接口地址：https://域名/api.php?act=order&pid={商户ID}&key={商户密钥}&out_trade_no={商户订单号}

请求参数

表格

提示：trade_no、out_trade_no二选一即可；两个同时传入，优先使用平台订单号trade_no

返回结果

表格

API：批量查询订单

接口地址：https://域名/api.php?act=orders&pid={商户ID}&key={商户密钥}

请求参数

表格

返回结果

表格