接口说明及规范

协议规则

提交数据格式	application/x-www-form-urlencoded
返回数据格式	JSON
字符编码	UTF-8
签名算法	MD5（V1接口） / RSA（V2接口）

V2升级说明

1. V2接口全面使用 RSA 签名算法；V1接口使用 MD5 签名算法
2. V2接口改用全新的接口地址，支持退款、代付等功能；V1接口使用 submit.php 和 mapi.php 提交订单
3. V2接口新增 timestamp 入参和返回值用于校验时间戳

获取密钥

V1接口文档（MD5签名）

1. 统一下单

接口地址：

POST https://yzf.bwxt88.com/submit.php

请求参数：

参数名	类型	必填	说明
pid	int	是	商户ID
type	string	是	支付方式：alipay（支付宝）/ wxpay（微信支付）/ qqpay（QQ钱包）
out_trade_no	string	是	商户订单号
notify_url	string	是	异步回调地址
return_url	string	是	支付完成跳转地址
name	string	是	商品名称
money	string	是	付款金额
sign	string	是	签名字符串
sign_type	string	是	签名类型：MD5

2. 签名算法（V1 MD5）

将所有请求参数按参数名ASCII码从小到大排序，拼接成URL键值对格式，再加上商户密钥，最后进行MD5加密。

示例：

// 待签名字符串
money=1.00&name=测试商品¬ify_url=http://www.example.com/notify&out_trade_no=20210101123456&pid=1000&return_url=http://www.example.com/return&type=alipay

// 拼接商户密钥
money=1.00&name=测试商品¬ify_url=http://www.example.com/notify&out_trade_no=20210101123456&pid=1000&return_url=http://www.example.com/return&type=alipay你的商户密钥

// MD5加密后即为 sign 值
sign = md5(上述字符串)

3. 支付回调

支付成功后，系统会向 notify_url 发送 POST 请求，商户服务器收到后需返回 success。

回调参数：

参数名	说明
pid	商户ID
trade_no	平台订单号
out_trade_no	商户订单号
type	支付方式
name	商品名称
money	付款金额
trade_status	交易状态：TRADE_SUCCESS 为成功
sign	签名字符串（验签方式同上）

4. 订单查询

接口地址：

POST https://yzf.bwxt88.com/api.php?act=order

请求参数：

参数名	类型	必填	说明
pid	int	是	商户ID
out_trade_no	string	是	商户订单号
sign	string	是	签名字符串
sign_type	string	是	签名类型：MD5

---

V2接口文档（RSA签名）

1. 统一下单

接口地址：

POST https://yzf.bwxt88.com/v2/api/unifiedorder

请求参数：

参数名	类型	必填	说明
pid	int	是	商户ID
type	string	是	支付方式：alipay / wxpay / qqpay
out_trade_no	string	是	商户订单号
notify_url	string	是	异步回调地址
return_url	string	否	支付完成跳转地址
name	string	是	商品名称
money	string	是	付款金额
timestamp	string	是	当前时间戳
sign	string	是	RSA签名字符串
sign_type	string	是	签名类型：RSA

2. 签名算法（V2 RSA）

将所有请求参数按参数名ASCII码从小到大排序，拼接成URL键值对格式，使用商户私钥进行RSA签名。

// 待签名字符串（示例）
money=1.00&name=测试商品¬ify_url=http://www.example.com/notify&out_trade_no=20210101123456&pid=1000×tamp=1609459200&type=alipay

// 使用商户私钥进行RSA签名
sign = RSA.sign(上述字符串, 商户私钥)

3. 支付回调

支付成功后，系统会向 notify_url 发送 POST 请求。验签时需使用平台公钥验证签名。

---

错误码说明

错误码	说明
0	成功
-1	签名错误
-2	商户不存在
-3	商户被禁用
-4	支付方式不存在
-5	订单金额错误

---