|
@@ -16,24 +16,25 @@ AllPay为基于微信小程序开发的接口,以帮助客户实现快速、
|
|
```
|
|
```
|
|
1.对于发送到 ALLPAY 系统的 POST 请求报文,其中所有传入参数(除 signature 参数外)按照字段名的 ASCII 码从小到大排序后(字典序),使用 URL 键值对的格式(即 key1=value1&key2=value2...)拼接成字符串 String1。
|
|
1.对于发送到 ALLPAY 系统的 POST 请求报文,其中所有传入参数(除 signature 参数外)按照字段名的 ASCII 码从小到大排序后(字典序),使用 URL 键值对的格式(即 key1=value1&key2=value2...)拼接成字符串 String1。
|
|
|
|
|
|
-2.在 String1 最后直接拼接(不需要用“&”连接)双方约定的签名密钥 K1(接入时 ALLPAY 时分配),得到 stringSignTemp 字符串,并对 stringSignTemp 进行 md5 运算,得到 signature 的值。
|
|
|
|
|
|
+2.在 String1 最后直接拼接(不需要用“&”连接)双方约定的签名密钥 K1(接入时 ALLPAY 时分配),得到 stringSignTemp 字符串,并对 stringSignTemp 进行 md5 运算,得到 signature 的值。
|
|
|
|
|
|
3.示例签名串 acqID=99020344&backURL=http://example.com/example&charSet=UTF- 8&frontURL=nil&merID=000000000000015&merReserve=nil&orderAmount=0.01&orderCurre ncy=CNY&orderNum=869873851812&paymentSchema=APMP&signType=MD5&transTime= 20151112151356&transType=PURC&version=VER0000000022f2c77e3718c47cfb47a89a6fbc9d361
|
|
3.示例签名串 acqID=99020344&backURL=http://example.com/example&charSet=UTF- 8&frontURL=nil&merID=000000000000015&merReserve=nil&orderAmount=0.01&orderCurre ncy=CNY&orderNum=869873851812&paymentSchema=APMP&signType=MD5&transTime= 20151112151356&transType=PURC&version=VER0000000022f2c77e3718c47cfb47a89a6fbc9d361
|
|
|
|
|
|
```
|
|
```
|
|
-##### 2.2. 通用API 接入地址
|
|
|
|
|
|
+##### 2.2. 通用API接入地址
|
|
|
|
|
|
- 交易名称 |开发调试地址|生产交易地址
|
|
|
|
- ------- |-----------|-------
|
|
|
|
- 消费接口 |https://testapi.allpayx.com/gw/wap/pay |https://api.allpayx.com/gw/wap/pay
|
|
|
|
- 查询接口 |https://testapi.allpayx.com/pay |https://api.allpayx.com/pay
|
|
|
|
- 退款接口 |https://testapi.allpayx.com/pay |https://api.allpayx.com/pay
|
|
|
|
|
|
+| 接口名称 | 测试地址 | 生产地址 |
|
|
|
|
+| ------------ | ----------------------------------------- | ------------------------------------- |
|
|
|
|
+| 消费接口 | <https://testapi.allpayx.com/gw/wap/pay> | <https://api.allpayx.com/gw/wap/pay> |
|
|
|
|
+| 交易查询接口 | <https://testapi.allpayx.com/pay> | <https://api.allpayx.com/pay> |
|
|
|
|
+| 退款接口 | <https://testapi.allpayx.com/refund> | <https://api.allpayx.com/refund> |
|
|
|
|
+| 退款查询接口 | <https://testapi.allpayx.com/refundquery> | <https://api.allpayx.com/refundquery> |
|
|
|
|
|
|
|
|
|
|
#### 3. API接口
|
|
#### 3. API接口
|
|
-##### 3.1. 消费交易接口
|
|
|
|
|
|
+##### 3.1. 消费接口
|
|
|
|
|
|
-1. 请求报文格式
|
|
|
|
|
|
+1.请求报文格式
|
|
|
|
|
|
序号 |名称 |长度|类型|参数名称|备注
|
|
序号 |名称 |长度|类型|参数名称|备注
|
|
-----|-----|----|----|------|------
|
|
-----|-----|----|----|------|------
|
|
@@ -56,20 +57,19 @@ AllPay为基于微信小程序开发的接口,以帮助客户实现快速、
|
|
17|签名类型 |3 |文本|signType |MD5
|
|
17|签名类型 |3 |文本|signType |MD5
|
|
18 |签名 |32 |文本|signature |采用 MD5 签名
|
|
18 |签名 |32 |文本|signature |采用 MD5 签名
|
|
|
|
|
|
-2. 返回数据格式
|
|
|
|
|
|
+2.返回数据格式
|
|
|
|
|
|
```
|
|
```
|
|
{'timeStamp': '',
|
|
{'timeStamp': '',
|
|
-'nonceStr': '',
|
|
|
|
- 'package': '',
|
|
|
|
-'signType': 'MD5',
|
|
|
|
- 'paySign': ''}
|
|
|
|
|
|
+ 'nonceStr': '',
|
|
|
|
+ 'package': '',
|
|
|
|
+ 'signType': 'MD5',
|
|
|
|
+ 'paySign': ''}
|
|
|
|
|
|
```
|
|
```
|
|
将上述返回数据放入微信小程序支付接口,即可调起微信小程序支付,具体方法,参考[微信小程序 API ](https://developers.weixin.qq.com/miniprogram/dev/api/api-pay.html#wxrequestpaymentobject)
|
|
将上述返回数据放入微信小程序支付接口,即可调起微信小程序支付,具体方法,参考[微信小程序 API ](https://developers.weixin.qq.com/miniprogram/dev/api/api-pay.html#wxrequestpaymentobject)
|
|
|
|
|
|
-##### 3.2. 异步通知报文
|
|
|
|
-
|
|
|
|
|
|
+3.异步通知报文
|
|
|
|
|
|
序号 |名称 |长度|类型|参数名称|备注
|
|
序号 |名称 |长度|类型|参数名称|备注
|
|
-----|-----|----|----|------|------
|
|
-----|-----|----|----|------|------
|
|
@@ -94,15 +94,15 @@ AllPay为基于微信小程序开发的接口,以帮助客户实现快速、
|
|
19|签名类型 |3 |文本|signType |MD5
|
|
19|签名类型 |3 |文本|signType |MD5
|
|
20|签名 |32 |文本|signature |采用 MD5 签名
|
|
20|签名 |32 |文本|signature |采用 MD5 签名
|
|
|
|
|
|
-##### 3.3. 查询交易接口
|
|
|
|
|
|
+##### 3.2. 交易查询接口
|
|
|
|
|
|
|
|
|
|
|
|
|
|
-1. 接口说明
|
|
|
|
|
|
+1.接口说明
|
|
|
|
|
|
该接口为接入商家提供交易查询的功能。
|
|
该接口为接入商家提供交易查询的功能。
|
|
|
|
|
|
-2. 请求报文格式
|
|
|
|
|
|
+2.请求报文格式
|
|
|
|
|
|
|
|
|
|
序号 |名称 |长度|类型|参数名称|备注
|
|
序号 |名称 |长度|类型|参数名称|备注
|
|
@@ -120,7 +120,7 @@ AllPay为基于微信小程序开发的接口,以帮助客户实现快速、
|
|
11|签名 |32 |文本|signature |采用 MD5 签名
|
|
11|签名 |32 |文本|signature |采用 MD5 签名
|
|
|
|
|
|
|
|
|
|
-3. 响应报文格式
|
|
|
|
|
|
+3.响应报文格式
|
|
|
|
|
|
|
|
|
|
序号 |名称 |长度|类型|参数名称|备注
|
|
序号 |名称 |长度|类型|参数名称|备注
|
|
@@ -139,9 +139,9 @@ AllPay为基于微信小程序开发的接口,以帮助客户实现快速、
|
|
12|签名类型 |3 |文本|signType |MD5
|
|
12|签名类型 |3 |文本|signType |MD5
|
|
13|签名 |32 |文本|signature |采用 MD5 签名
|
|
13|签名 |32 |文本|signature |采用 MD5 签名
|
|
|
|
|
|
-##### 3.4. 退款交易接口
|
|
|
|
|
|
+##### 3.3. 退款接口
|
|
|
|
|
|
-1.接口功能说明
|
|
|
|
|
|
+1.接口说明
|
|
|
|
|
|
该接口为接入商家提供交易退款的功能。
|
|
该接口为接入商家提供交易退款的功能。
|
|
|
|
|
|
@@ -182,6 +182,51 @@ AllPay为基于微信小程序开发的接口,以帮助客户实现快速、
|
|
12|签名类型 |3 |文本|signType |MD5
|
|
12|签名类型 |3 |文本|signType |MD5
|
|
13|签名 |32 |文本|signature |采用 MD5 签名
|
|
13|签名 |32 |文本|signature |采用 MD5 签名
|
|
|
|
|
|
|
|
+##### 3.4. 退款查询接口
|
|
|
|
+
|
|
|
|
+1.接口说明
|
|
|
|
+
|
|
|
|
+ 该接口为接入商家提供退款查询的功能。
|
|
|
|
+
|
|
|
|
+2.请求报文格式
|
|
|
|
+
|
|
|
|
+
|
|
|
|
+
|
|
|
|
+| 参数 | 类型 | 属性 | 描述 |
|
|
|
|
+| ------------- | ------------ | ---- | ------------------------------------------------------------ |
|
|
|
|
+| version | String(12) | M | 统一填写为“VER000000002” |
|
|
|
|
+| charSet | String(6) | M | 统一填写为“UTF-8” |
|
|
|
|
+| transType | String(4) | M | 查询填写“RFQY” |
|
|
|
|
+| refundNum | String(60) | M | 退款订单号 |
|
|
|
|
+| merReserve | String(1024) | M | 商户预留内容,可传任意内容,如购买商品信息、员号等,但不要传特殊符号,如逗号。 |
|
|
|
|
+| merID | String(15) | M | 商户 ID,由AllPay 分配 |
|
|
|
|
+| acqID | String(11) | M | 收单行 ID "99020344" |
|
|
|
|
+| paymentSchema | String(10) | M | 渠道代码:[点击这里](https://git.allpayx.com/OpenAPI/b2c_pc_payment/src/master/paymentSchema.md) |
|
|
|
|
+| transTime | String(14) | M | 交易时间,格式:"yyyyMMddHHmmss" |
|
|
|
|
+| signType | String(3) | M | MD5 |
|
|
|
|
+| signature | String(32) | M | 采用 MD5 签名 |
|
|
|
|
+
|
|
|
|
+
|
|
|
|
+
|
|
|
|
+3.响应报文格式
|
|
|
|
+
|
|
|
|
+| 参数 | 类型 | 属性 | 描述 |
|
|
|
|
+| ------------- | ---------- | ---- | ------------------------------------------------------------ |
|
|
|
|
+| version | String(12) | M | 统一填写为“VER000000002” |
|
|
|
|
+| charSet | String(6) | M | 统一填写为“UTF-8” |
|
|
|
|
+| transType | String(4) | M | 查询填写“REFD” |
|
|
|
|
+| refundNum | String(60) | M | 退款订单号 |
|
|
|
|
+| transID | String(32) | M | GW 系统生成的交易 ID,每笔交易保持唯一 |
|
|
|
|
+| merID | String(15) | M | 商户 ID,由AllPay 分配 |
|
|
|
|
+| acqID | String(11) | M | 收单行 ID "99020344" |
|
|
|
|
+| paymentSchema | String(10) | M | 渠道代码:[点击这里](https://git.allpayx.com/OpenAPI/b2c_pc_payment/src/master/paymentSchema.md) |
|
|
|
|
+| RespCode | String(2) | M | 应答码 00-成功 |
|
|
|
|
+| RespMsg | String(20) | M | 应答消息,全部为英文字符 |
|
|
|
|
+| transTime | String(14) | M | 交易时间,格式:"yyyyMMddHHmmss" |
|
|
|
|
+| GWTime | String(14) | M | YYYYMMDDHHMMSS,为 GW 时间,目前为本地交易时间 |
|
|
|
|
+| signType | String(3) | M | MD5 |
|
|
|
|
+| signature | String(32) | M | signature |
|
|
|
|
+
|
|
#### 4. 错误码
|
|
#### 4. 错误码
|
|
|
|
|
|
若商户请求AllPay网关时,请求的参数错误或参数缺失时,AllPay网关会将错误信息以JSON格式返回给客户端,供商户解析调用,以下是相关错误信息返回参数的说明
|
|
若商户请求AllPay网关时,请求的参数错误或参数缺失时,AllPay网关会将错误信息以JSON格式返回给客户端,供商户解析调用,以下是相关错误信息返回参数的说明
|