Browse Source

修改文档

benson 5 years ago
parent
commit
e0a2df1790
16 changed files with 507 additions and 391 deletions
  1. 4 4
      docs/.vuepress/config.js
  2. 0 23
      docs/wx/2.md
  3. 0 150
      docs/wx/3.md
  4. 0 19
      docs/wx/4.md
  5. 188 0
      docs/wx/common.md
  6. 0 0
      docs/wx/overview.md
  7. 49 0
      docs/wx/purc.md
  8. 13 0
      docs/wx/sign.md
  9. 0 23
      docs/zh/wx/2.md
  10. 0 150
      docs/zh/wx/3.md
  11. 0 19
      docs/zh/wx/4.md
  12. 3 3
      docs/zh/wx/README.md
  13. 188 0
      docs/zh/wx/common.md
  14. 0 0
      docs/zh/wx/overview.md
  15. 49 0
      docs/zh/wx/purc.md
  16. 13 0
      docs/zh/wx/sign.md

+ 4 - 4
docs/.vuepress/config.js

@@ -146,10 +146,10 @@ function genSidebar(name, title) {
     ],
     wx: [
       '',
-      '1',
-      '2',
-      '3',
-      '4',
+      'overview',
+      'sign',
+      'purc',
+      'common',
     ],
 
     expup: [

+ 0 - 23
docs/wx/2.md

@@ -1,23 +0,0 @@
-# 2.通用API说明
-
-商户服务器和 AllPay 网关对接的通用接口,每个渠道都具有的功能,包括:消费,退款,查询接口。
-
-## 2.1. 验签说明 
-
-1.对于发送到 ALLPAY 系统的 POST 请求报文,其中所有传入参数(除 signature 参数外)按照字段名的 ASCII 码从小到大排序后(字典序),使用 URL 键值对的格式(即 key1=value1&key2=value2...)拼接成字符串 String1。
-
-2.在 String1 最后直接拼接(不需要用“&”连接)双方约定的签名密钥 K1(接入时 ALLPAY 时分配),得到 stringSignTemp 字符串,并对 stringSignTemp 进行 md5 运算,得到 signature 的值。
-
-3.示例签名串
-
-```js
-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 接入地址
-
- 交易名称  |开发调试地址|生产交易地址  
- ------- |-----------|-------
- 消费接口 |<https://testapi.allpayx.com/gw/wap/pay/v1> |<https://api.allpayx.com/gw/wap/pay/v1>
- 查询接口 |<https://testapi.allpayx.com/pay/v1> |<https://api.allpayx.com/pay/v1>
- 退款接口 |<https://testapi.allpayx.com/pay/v1> |<https://api.allpayx.com/pay/v1>

+ 0 - 150
docs/wx/3.md

@@ -1,150 +0,0 @@
-# 3. API接口
-
-## 3.1. 消费交易接口
-
-1. 请求报文格式
-
- 序号 |名称  |长度|类型|参数名称|备注 
- -----|-----|----|----|------|------
- 1|版本号|12|文本|version |统一填写为“VER000000002” 
- 2|字符集编码 |6|文本|charSet  |统一填写为“UTF-8” 
- 3|交易类型  |4|文本|transType |消费交易填写“PURC” 
- 4|订单号   |60|文本|orderNum  |商户自行定义,需保证同一商户号下订单号不能重复 
- 5|交易模式|10|文本|mode |"applet"
- 6|SDK 版本 |10|文本|jssdk|"1.0" 
- 7|授权码|60|文本|code   |微信小程序 login 接口获得的授权码 
- 8|订单金额 |12|文本|orderAmount   |如 100 元,表示为 100 或 100.00 
- 9|订单币种   |3|文本|orderCurrency |人民币填写“CNY”,美元填写"USD" 
- 10|前端 URL 地址 |400|文本|frontURL  |支付结果前端通知到该地址 
- 11|后端 URL 地址 |400|文本|backURL   |支付结果异步通知到该地址 
- 12|商户预留字段  |1024 |文本|merReserve    |商户预留内容,可传任意内容,如购买商品信息、员号等,但不要传特殊符号,如逗号。 
- 13|商户代码   |15 |文本|merID     |商户 ID,由AllPay 分配 
- 14|收单行 ID    |11  |文本|acqID      |收单行 ID "99020344" 
- 15|支付渠道代码    |10  |文本|paymentSchema| "WX"
- 16|商品信息    |60  |文本|goodsInfo       | 商品信息
- 17|交易时间    |14  |文本|transTime       |交易时间,格式:"yyyyMMddHHmmss" 
- 18|签名类型     |3  |文本|signType        |MD5 
- 19|签名      |32  |文本|signature         |采用 MD5 签名 
- 
-2. 返回数据格式
-
- ```js
-{
-  'timeStamp': '',
-  'nonceStr': '',
-  'package': '',
-  'signType': 'MD5',
-  'paySign': ''
-}
- ```
-
-将上述返回数据放入微信小程序支付接口,即可调起微信小程序支付,具体方法,参考[微信小程序 API ](https://developers.weixin.qq.com/miniprogram/dev/api/api-pay.html#wxrequestpaymentobject)
-
-## 3.2. 异步通知报文
-
- 序号 |名称  |长度|类型|参数名称|备注 
- -----|-----|----|----|------|------
- 1|版本号|12|文本|version |统一填写为“VER000000002” 
- 2|字符集编码 |6|文本|charSet  |统一填写为“UTF-8” 
- 3|交易类型  |4|文本|transType |消费交易填写“PURC” 
- 4|订单号   |60|文本|orderNum  |商户自行定义,需保证同一商户号下订单号不能重复 
- 5|订单金额 |12|文本|orderAmount   |如 100 元,表示为 100 或 100.00 
- 6|订单币种   |3|文本|orderCurrency |人民币填写“CNY”,美元填写"USD" 
- 7|清算金额  |12 |文本|settAmount   |如 100 元,表示为 100 或 100.00  
- 8|清算币种  |3|文本|settCurrency    |符合 ISO 标准,填写数字类型 
- 9|清算汇率   |7|文本|rate     |实际汇率,7 位有效数字  
- 10|商户预留字段  |1024 |文本|merReserve    |商户预留内容,可传任意内容,如购买商品信息、员号等,但不要传特殊符号,如逗号。 
- 11|GW 交易 ID  |32|文本|transID    |GW 系统生成的交易 ID,每笔交易保持唯一
- 12|商户代码   |15 |文本|merID     |商户 ID,由AllPay 分配 
- 13|收单行 ID    |11  |文本|acqID      |收单行 ID "99020344" 
- 14|支付渠道代码    |10  |文本|paymentSchema|渠道代码:"WX
- 15|交易应答码   |2  |文本|RespCode       |应答码 00-成功  
- 16|应答文字信息    |20  |文本|RespMsg        |应答消息,全部为英文字符 
- 17|交易时间    |14  |文本|transTime       |交易时间,格式:"yyyyMMddHHmmss" 
- 18|GW 处理时间 |14  |文本|GWTime |YYYYMMDDHHMMSS,为 GW 时间,目前为本地交易时间
- 19|签名类型     |3  |文本|signType        |MD5 
- 20|签名      |32  |文本|signature         |采用 MD5 签名 
-
-## 3.3. 查询交易接口
-
-1. 接口说明
-
- 该接口为接入商家提供交易查询的功能。
-
-2. 请求报文格式 
-
- 序号 |名称  |长度|类型|参数名称|备注 
- -----|-----|----|----|------|------
- 1|版本号|12|文本|version |统一填写为“VER000000002” 
- 2|字符集编码 |6|文本|charSet  |统一填写为“UTF-8” 
- 3|交易类型  |4|文本|transType |查询填写“INQY”  
- 4|订单号   |60|文本|orderNum  |商户自行定义,需保证同一商户号下订单号不能重复 
- 5|商户预留字段  |1024 |文本|merReserve    |商户保留 
- 6|商户代码   |15 |文本|merID     |商户 ID,由AllPay 分配 
- 7|收单行 ID    |11  |文本|acqID      |收单行 ID "99020344" 
- 8|支付渠道代码    |10  |文本|paymentSchema|渠道代码:"WX
- 9|交易时间    |14  |文本|transTime       |交易时间,格式:"yyyyMMddHHmmss" 
- 10|签名类型     |3  |文本|signType        |MD5 
- 11|签名      |32  |文本|signature         |采用 MD5 签名 
-
-
-3. 响应报文格式
-
-
-  序号 |名称  |长度|类型|参数名称|备注 
- -----|-----|----|----|------|------
- 1|版本号|12|文本|version |统一填写为“VER000000002” 
- 2|字符集编码 |6|文本|charSet  |统一填写为“UTF-8” 
- 3|交易类型  |4|文本|transType |查询交易填写为“INQY 
- 4|订单号   |60|文本|orderNum  |商户自行定义,需保证同一商户号下订单号不能重复 
- 5|GW 交易 ID  |32|文本|transID    |GW 系统生成的交易 ID,每笔交易保持唯一  
- 6|商户代码   |15 |文本|merID     |商户 ID,由AllPay 分配 
- 7|收单行 ID    |11  |文本|acqID      |收单行 ID "99020344" 
- 8|交易应答码   |2  |文本|RespCode       |应答码 00-成功  
- 9|应答文字信息    |20  |文本|RespMsg        |应答消息,全部为英文字符 
- 10|交易时间    |14  |文本|transTime       |交易时间,格式:"yyyyMMddHHmmss" 
- 11|GW 处理时间 |14  |文本|GWTime |YYYYMMDDHHMMSS,为 GW 时间,目前为本地交易时间 
- 12|签名类型     |3  |文本|signType        |MD5 
- 13|签名      |32  |文本|signature         |采用 MD5 签名 
-
-## 3.4. 退款交易接口
-
-1.接口功能说明 
-
-该接口为接入商家提供交易退款的功能。 
-
-2.请求报文格式 
-
-  序号 |名称  |长度|类型|参数名称|备注 
- -----|-----|----|----|------|------
- 1|版本号|12|文本|version |统一填写为“VER000000002” 
- 2|字符集编码 |6|文本|charSet  |统一填写为“UTF-8” 
- 3|交易类型  |4|文本|transType |退款填写“REFD” 
- 4|订单号   |60|文本|orderNum  |商户自行定义,需保证同一商户号下订单号不能重复 
- 5|退款金额  |12|文本|returnAmount    |如 100 元,表示为 100 或 100.00 
- 6|订单币种   |3|文本|orderCurrency |人民币填写“CNY”,美元填写"USD" 
- 7|商户预留字段  |1024 |文本|merReserve    |商户预留内容,可传任意内容,如购买商品信息、员号等,但不要传特殊符号,如逗号。 
- 8|商户代码   |15 |文本|merID     |商户 ID,由AllPay 分配 
- 9|收单行 ID    |11  |文本|acqID      |收单行 ID "99020344" 
- 10|支付渠道代码    |10  |文本|paymentSchema|渠道代码:"WX
- 11|交易时间    |14  |文本|transTime       |交易时间,格式:"yyyyMMddHHmmss" 
- 12|签名类型     |3  |文本|signType        |MD5 
- 13|签名      |32  |文本|signature         |采用 MD5 签名 
-
-3.响应报文格式
-
-  序号 |名称  |长度|类型|参数名称|备注 
- -----|-----|----|----|------|------
- 1|版本号|12|文本|version |统一填写为“VER000000002” 
- 2|字符集编码 |6|文本|charSet  |统一填写为“UTF-8” 
- 3|交易类型  |4|文本|transType |退款填写“REFD” 
- 4|订单号   |60|文本|orderNum  |商户自行定义,需保证同一商户号下订单号不能重复 
- 5|GW 交易 ID  |32|文本|transID    |GW 系统生成的交易 ID,每笔交易保持唯一  
- 6|商户代码   |15 |文本|merID     |商户 ID,由AllPay 分配 
- 7|收单行 ID    |11  |文本|acqID      |收单行 ID "99020344" 
- 8|交易应答码   |2  |文本|RespCode       |应答码 00-成功  
- 9|应答文字信息    |20  |文本|RespMsg        |应答消息,全部为英文字符 
- 10|交易时间    |14  |文本|transTime       |交易时间,格式:"yyyyMMddHHmmss" 
- 11|GW 处理时间 |14  |文本|GWTime |YYYYMMDDHHMMSS,为 GW 时间,目前为本地交易时间 
- 12|签名类型     |3  |文本|signType        |MD5 
- 13|签名      |32  |文本|signature         |采用 MD5 签名 

+ 0 - 19
docs/wx/4.md

@@ -1,19 +0,0 @@
-# 4. 错误码
-
-若商户请求AllPay网关时,请求的参数错误或参数缺失时,AllPay网关会将错误信息以JSON格式返回给客户端,供商户解析调用,以下是相关错误信息返回参数的说明
-
-| 参数应答码code | 对应应答信息msg                            |
-| -------------- | ------------------------------------------ |
-| U1             | Clientid not found                         |
-| U2             | Signature error                            |
-| V1             | Parameter missing                          |
-| E1             | Exceed the limit                           |
-| R1             | Orderno repeat                             |
-| C1             | Order currency is not set                  |
-| P1             | paychannel error                           |
-| I1             | Illegal request address                    |
-| T1             | Parameter missing(version或tranType)     |
-| T2             | Txntype error                              |
-| T3             | transaction is not exist or fail           |
-| T4             | The maximum amount exceeds the upper limit |
-| 99             | System error  

+ 188 - 0
docs/wx/common.md

@@ -0,0 +1,188 @@
+# 4. 通用接口
+
+## 4.1. 接口地址
+
+
+
+通用接口包括 交易异步通知,交易查询,退款,退款查询接口
+
+
+
+接口名称   |测试地址 |生产地址
+ ------- |-----------|-------
+ 交易查询接口 |<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>
+
+## 4.2. 异步通知报文
+
+AllPay服务器通过get方式,异步发送到消费接口中上送的backURL地址,商户根据收到的报文来确定交易的支付结果
+
+| 参数          | 类型         | 属性 | 描述                                                         |
+| ------------- | ------------ | ---- | ------------------------------------------------------------ |
+| version       | String(12)   | M    | 统一填写为“VER000000002”                                     |
+| charSet       | String(6)    | M    | 统一填写为“UTF-8”                                            |
+| transType     | String(4)    | M    | 消费交易填写“PURC”                                           |
+| orderNum      | String(60)   | M    | 订单号                                                       |
+| orderAmount   | String(12)   | M    | 订单金额:如 100 元,表示为 100 或 100.00                    |
+| orderCurrency | String(3)    | M    | 订单币种:ISO标准 如:人民币填写“CNY”,美元填写"USD"          |
+| settAmount    | String(12)   | M    | 清算金额:如 100 元,表示为 100 或 100.00                    |
+| settCurrency  | String(3)    | M    | 清算币种:符合 ISO 标准                                      |
+| rate          | String(7)    | M    | 实际汇率,7 位有效数字                                       |
+| merReserve    | String(1024) | 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.3. 查询交易接口 
+
+
+
+1. 接口说明
+
+ 该接口为接入商家提供交易查询的功能。
+
+2. 请求报文格式 
+
+  
+
+| 参数          | 类型         | 属性 | 描述                                                         |
+| ------------- | ------------ | ---- | ------------------------------------------------------------ |
+| version       | String(12)   | M    | 统一填写为“VER000000002”                                     |
+| charSet       | String(6)    | M    | 统一填写为“UTF-8”                                            |
+| transType     | String(4)    | M    | 查询填写“INQY”                                               |
+| orderNum      | 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    | 查询填写“INQY”                                               |
+| orderNum      | 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. 退款交易接口
+
+1.接口功能说明 
+
+该接口为接入商家提供交易退款的功能。 
+
+2.请求报文格式 
+
+
+
+| 参数          | 类型         | 属性 | 描述                                                         |
+| ------------- | ------------ | ---- | ------------------------------------------------------------ |
+| version       | String(12)   | M    | 统一填写为“VER000000002”                                     |
+| charSet       | String(6)    | M    | 统一填写为“UTF-8”                                            |
+| transType     | String(4)    | M    | 退款填写“REFD”                                               |
+| orderNum      | String(60)   | M    | 原交易订单号                                                 |
+| refundNum     | String(60)   | M    | 退款订单号:商户自行定义,需保证同一商户号下退款订单号不能重复 |
+| returnAmount  | String(12)   | M    | 退款金额:如 100 元,表示为 100 或 100.00                    |
+| orderCurrency | String(3)    | M    | 订单币种:ISO标准 如:人民币填写“CNY”,美元填写"USD"          |
+| 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"                           |
+| 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.5. 退款查询接口
+
+1. 1. 接口说明
+
+    该接口为接入商家提供退款查询的功能。
+
+   1. 请求报文格式 
+
+     
+
+   | 参数          | 类型         | 属性 | 描述                                                         |
+   | ------------- | ------------ | ---- | ------------------------------------------------------------ |
+   | 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 签名                                                |
+
+
+
+   1. 响应报文格式
+
+| 参数          | 类型       | 属性 | 描述                                                         |
+| ------------- | ---------- | ---- | ------------------------------------------------------------ |
+| 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                                                    |

docs/wx/1.md → docs/wx/overview.md


+ 49 - 0
docs/wx/purc.md

@@ -0,0 +1,49 @@
+# 3.消费交易
+
+## 3.1. 消费交易地址 
+
+ 交易名称  |测试地址|生产地址  
+ ------- |-----------|-------
+ 消费接口 |<https://testapi.allpayx.com/gw/wap/pay> |<https://api.allpayx.com/gw/wap/pay>
+
+
+
+## 3.2. 消费交易接口
+
+1. 请求报文格式
+
+| 序号 | 名称          | 长度 | 类型 | 参数名称      | 备注                                                         |
+| ---- | ------------- | ---- | ---- | ------------- | ------------------------------------------------------------ |
+| 1    | 版本号        | 12   | 文本 | version       | 统一填写为“VER000000002”                                     |
+| 2    | 字符集编码    | 6    | 文本 | charSet       | 统一填写为“UTF-8”                                            |
+| 3    | 交易类型      | 4    | 文本 | transType     | 消费交易填写“PURC”                                           |
+| 4    | 订单号        | 60   | 文本 | orderNum      | 商户自行定义,需保证同一商户号下订单号不能重复               |
+| 5    | 交易模式      | 10   | 文本 | mode          | "applet"                                                     |
+| 6    | SDK 版本      | 10   | 文本 | jssdk         | "1.0"                                                        |
+| 7    | 授权码        | 60   | 文本 | code          | 微信小程序 login 接口获得的授权码                            |
+| 8    | 订单金额      | 12   | 文本 | orderAmount   | 如 100 元,表示为 100 或 100.00                              |
+| 9    | 订单币种      | 3    | 文本 | orderCurrency | 人民币填写“CNY”,美元填写"USD"                                |
+| 10   | 前端 URL 地址 | 400  | 文本 | frontURL      | 支付结果前端通知到该地址                                     |
+| 11   | 后端 URL 地址 | 400  | 文本 | backURL       | 支付结果异步通知到该地址                                     |
+| 12   | 商户预留字段  | 1024 | 文本 | merReserve    | 商户预留内容,可传任意内容,如购买商品信息、员号等,但不要传特殊符号,如逗号。 |
+| 13   | 商户代码      | 15   | 文本 | merID         | 商户 ID,由AllPay 分配                                       |
+| 14   | 收单行 ID     | 11   | 文本 | acqID         | 收单行 ID "99020344"                                         |
+| 15   | 支付渠道代码  | 10   | 文本 | paymentSchema | "WX"                                                         |
+| 16   | 商品信息      | 60   | 文本 | goodsInfo     | 商品信息                                                     |
+| 17   | 交易时间      | 14   | 文本 | transTime     | 交易时间,格式:"yyyyMMddHHmmss"                               |
+| 18   | 签名类型      | 3    | 文本 | signType      | MD5                                                          |
+| 19   | 签名          | 32   | 文本 | signature     | 采用 MD5 签名                                                |
+
+1. 返回数据格式
+
+```js
+{
+  'timeStamp': '',
+  'nonceStr': '',
+  'package': '',
+  'signType': 'MD5',
+  'paySign': ''
+}
+```
+
+将上述返回数据放入微信小程序支付接口,即可调起微信小程序支付,具体方法,参考[微信小程序 API ](

+ 13 - 0
docs/wx/sign.md

@@ -0,0 +1,13 @@
+# 3.签名
+
+1.对于发送到 ALLPAY 系统的 POST 请求报文,其中所有传入参数(除 signature 参数外)按照字段名的 ASCII 码从小到大排序后(字典序),使用 URL 键值对的格式(即 key1=value1&key2=value2...)拼接成字符串 String1。
+
+2.在 String1 最后直接拼接(不需要用“&”连接)双方约定的签名密钥 K1(接入时 ALLPAY 时分配),得到 stringSignTemp 字符串,并对 stringSignTemp 进行 md5 运算,得到 signature 的值。
+
+3.示例签名串
+
+```js
+acqID=99020344&backURL=https://www.baidu.com&charSet=UTF-8&frontURL=nil&goodsInfo=iPhone x&merID=800039253992510&merReserve=&orderAmount=1.00&orderCurrency=INR&orderNum=ap0180417163142&paymentSchema=EB&signType=MD5&transTime=20180417163142&transType=PURC&trxn_email_id=benson.zhang@allpayx.com&trxn_firstname=benson zhang&trxn_is_coupon_enabled=1&trxn_phone=15026528888&unique_id=abcde12345&version=VER000000002f3e0e436cd24430aa4aaaed597450f26 
+```
+
+## 

+ 0 - 23
docs/zh/wx/2.md

@@ -1,23 +0,0 @@
-# 2.通用API说明
-
-商户服务器和 AllPay 网关对接的通用接口,每个渠道都具有的功能,包括:消费,退款,查询接口。
-
-## 2.1. 验签说明 
-
-1.对于发送到 ALLPAY 系统的 POST 请求报文,其中所有传入参数(除 signature 参数外)按照字段名的 ASCII 码从小到大排序后(字典序),使用 URL 键值对的格式(即 key1=value1&key2=value2...)拼接成字符串 String1。
-
-2.在 String1 最后直接拼接(不需要用“&”连接)双方约定的签名密钥 K1(接入时 ALLPAY 时分配),得到 stringSignTemp 字符串,并对 stringSignTemp 进行 md5 运算,得到 signature 的值。
-
-3.示例签名串
-
-```js
-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 接入地址
-
- 交易名称  |开发调试地址|生产交易地址  
- ------- |-----------|-------
- 消费接口 |<https://testapi.allpayx.com/gw/wap/pay/v1> |<https://api.allpayx.com/gw/wap/pay/v1>
- 查询接口 |<https://testapi.allpayx.com/pay/v1> |<https://api.allpayx.com/pay/v1>
- 退款接口 |<https://testapi.allpayx.com/pay/v1> |<https://api.allpayx.com/pay/v1>

+ 0 - 150
docs/zh/wx/3.md

@@ -1,150 +0,0 @@
-# 3. API接口
-
-## 3.1. 消费交易接口
-
-1. 请求报文格式
-
- 序号 |名称  |长度|类型|参数名称|备注 
- -----|-----|----|----|------|------
- 1|版本号|12|文本|version |统一填写为“VER000000002” 
- 2|字符集编码 |6|文本|charSet  |统一填写为“UTF-8” 
- 3|交易类型  |4|文本|transType |消费交易填写“PURC” 
- 4|订单号   |60|文本|orderNum  |商户自行定义,需保证同一商户号下订单号不能重复 
- 5|交易模式|10|文本|mode |"applet"
- 6|SDK 版本 |10|文本|jssdk|"1.0" 
- 7|授权码|60|文本|code   |微信小程序 login 接口获得的授权码 
- 8|订单金额 |12|文本|orderAmount   |如 100 元,表示为 100 或 100.00 
- 9|订单币种   |3|文本|orderCurrency |人民币填写“CNY”,美元填写"USD" 
- 10|前端 URL 地址 |400|文本|frontURL  |支付结果前端通知到该地址 
- 11|后端 URL 地址 |400|文本|backURL   |支付结果异步通知到该地址 
- 12|商户预留字段  |1024 |文本|merReserve    |商户预留内容,可传任意内容,如购买商品信息、员号等,但不要传特殊符号,如逗号。 
- 13|商户代码   |15 |文本|merID     |商户 ID,由AllPay 分配 
- 14|收单行 ID    |11  |文本|acqID      |收单行 ID "99020344" 
- 15|支付渠道代码    |10  |文本|paymentSchema| "WX"
- 16|商品信息    |60  |文本|goodsInfo       | 商品信息
- 17|交易时间    |14  |文本|transTime       |交易时间,格式:"yyyyMMddHHmmss" 
- 18|签名类型     |3  |文本|signType        |MD5 
- 19|签名      |32  |文本|signature         |采用 MD5 签名 
- 
-2. 返回数据格式
-
- ```js
-{
-  'timeStamp': '',
-  'nonceStr': '',
-  'package': '',
-  'signType': 'MD5',
-  'paySign': ''
-}
- ```
-
-将上述返回数据放入微信小程序支付接口,即可调起微信小程序支付,具体方法,参考[微信小程序 API ](https://developers.weixin.qq.com/miniprogram/dev/api/api-pay.html#wxrequestpaymentobject)
-
-## 3.2. 异步通知报文
-
- 序号 |名称  |长度|类型|参数名称|备注 
- -----|-----|----|----|------|------
- 1|版本号|12|文本|version |统一填写为“VER000000002” 
- 2|字符集编码 |6|文本|charSet  |统一填写为“UTF-8” 
- 3|交易类型  |4|文本|transType |消费交易填写“PURC” 
- 4|订单号   |60|文本|orderNum  |商户自行定义,需保证同一商户号下订单号不能重复 
- 5|订单金额 |12|文本|orderAmount   |如 100 元,表示为 100 或 100.00 
- 6|订单币种   |3|文本|orderCurrency |人民币填写“CNY”,美元填写"USD" 
- 7|清算金额  |12 |文本|settAmount   |如 100 元,表示为 100 或 100.00  
- 8|清算币种  |3|文本|settCurrency    |符合 ISO 标准,填写数字类型 
- 9|清算汇率   |7|文本|rate     |实际汇率,7 位有效数字  
- 10|商户预留字段  |1024 |文本|merReserve    |商户预留内容,可传任意内容,如购买商品信息、员号等,但不要传特殊符号,如逗号。 
- 11|GW 交易 ID  |32|文本|transID    |GW 系统生成的交易 ID,每笔交易保持唯一
- 12|商户代码   |15 |文本|merID     |商户 ID,由AllPay 分配 
- 13|收单行 ID    |11  |文本|acqID      |收单行 ID "99020344" 
- 14|支付渠道代码    |10  |文本|paymentSchema|渠道代码:"WX
- 15|交易应答码   |2  |文本|RespCode       |应答码 00-成功  
- 16|应答文字信息    |20  |文本|RespMsg        |应答消息,全部为英文字符 
- 17|交易时间    |14  |文本|transTime       |交易时间,格式:"yyyyMMddHHmmss" 
- 18|GW 处理时间 |14  |文本|GWTime |YYYYMMDDHHMMSS,为 GW 时间,目前为本地交易时间
- 19|签名类型     |3  |文本|signType        |MD5 
- 20|签名      |32  |文本|signature         |采用 MD5 签名 
-
-## 3.3. 查询交易接口
-
-1. 接口说明
-
- 该接口为接入商家提供交易查询的功能。
-
-2. 请求报文格式 
-
- 序号 |名称  |长度|类型|参数名称|备注 
- -----|-----|----|----|------|------
- 1|版本号|12|文本|version |统一填写为“VER000000002” 
- 2|字符集编码 |6|文本|charSet  |统一填写为“UTF-8” 
- 3|交易类型  |4|文本|transType |查询填写“INQY”  
- 4|订单号   |60|文本|orderNum  |商户自行定义,需保证同一商户号下订单号不能重复 
- 5|商户预留字段  |1024 |文本|merReserve    |商户保留 
- 6|商户代码   |15 |文本|merID     |商户 ID,由AllPay 分配 
- 7|收单行 ID    |11  |文本|acqID      |收单行 ID "99020344" 
- 8|支付渠道代码    |10  |文本|paymentSchema|渠道代码:"WX
- 9|交易时间    |14  |文本|transTime       |交易时间,格式:"yyyyMMddHHmmss" 
- 10|签名类型     |3  |文本|signType        |MD5 
- 11|签名      |32  |文本|signature         |采用 MD5 签名 
-
-
-3. 响应报文格式
-
-
-  序号 |名称  |长度|类型|参数名称|备注 
- -----|-----|----|----|------|------
- 1|版本号|12|文本|version |统一填写为“VER000000002” 
- 2|字符集编码 |6|文本|charSet  |统一填写为“UTF-8” 
- 3|交易类型  |4|文本|transType |查询交易填写为“INQY 
- 4|订单号   |60|文本|orderNum  |商户自行定义,需保证同一商户号下订单号不能重复 
- 5|GW 交易 ID  |32|文本|transID    |GW 系统生成的交易 ID,每笔交易保持唯一  
- 6|商户代码   |15 |文本|merID     |商户 ID,由AllPay 分配 
- 7|收单行 ID    |11  |文本|acqID      |收单行 ID "99020344" 
- 8|交易应答码   |2  |文本|RespCode       |应答码 00-成功  
- 9|应答文字信息    |20  |文本|RespMsg        |应答消息,全部为英文字符 
- 10|交易时间    |14  |文本|transTime       |交易时间,格式:"yyyyMMddHHmmss" 
- 11|GW 处理时间 |14  |文本|GWTime |YYYYMMDDHHMMSS,为 GW 时间,目前为本地交易时间 
- 12|签名类型     |3  |文本|signType        |MD5 
- 13|签名      |32  |文本|signature         |采用 MD5 签名 
-
-## 3.4. 退款交易接口
-
-1.接口功能说明 
-
-该接口为接入商家提供交易退款的功能。 
-
-2.请求报文格式 
-
-  序号 |名称  |长度|类型|参数名称|备注 
- -----|-----|----|----|------|------
- 1|版本号|12|文本|version |统一填写为“VER000000002” 
- 2|字符集编码 |6|文本|charSet  |统一填写为“UTF-8” 
- 3|交易类型  |4|文本|transType |退款填写“REFD” 
- 4|订单号   |60|文本|orderNum  |商户自行定义,需保证同一商户号下订单号不能重复 
- 5|退款金额  |12|文本|returnAmount    |如 100 元,表示为 100 或 100.00 
- 6|订单币种   |3|文本|orderCurrency |人民币填写“CNY”,美元填写"USD" 
- 7|商户预留字段  |1024 |文本|merReserve    |商户预留内容,可传任意内容,如购买商品信息、员号等,但不要传特殊符号,如逗号。 
- 8|商户代码   |15 |文本|merID     |商户 ID,由AllPay 分配 
- 9|收单行 ID    |11  |文本|acqID      |收单行 ID "99020344" 
- 10|支付渠道代码    |10  |文本|paymentSchema|渠道代码:"WX
- 11|交易时间    |14  |文本|transTime       |交易时间,格式:"yyyyMMddHHmmss" 
- 12|签名类型     |3  |文本|signType        |MD5 
- 13|签名      |32  |文本|signature         |采用 MD5 签名 
-
-3.响应报文格式
-
-  序号 |名称  |长度|类型|参数名称|备注 
- -----|-----|----|----|------|------
- 1|版本号|12|文本|version |统一填写为“VER000000002” 
- 2|字符集编码 |6|文本|charSet  |统一填写为“UTF-8” 
- 3|交易类型  |4|文本|transType |退款填写“REFD” 
- 4|订单号   |60|文本|orderNum  |商户自行定义,需保证同一商户号下订单号不能重复 
- 5|GW 交易 ID  |32|文本|transID    |GW 系统生成的交易 ID,每笔交易保持唯一  
- 6|商户代码   |15 |文本|merID     |商户 ID,由AllPay 分配 
- 7|收单行 ID    |11  |文本|acqID      |收单行 ID "99020344" 
- 8|交易应答码   |2  |文本|RespCode       |应答码 00-成功  
- 9|应答文字信息    |20  |文本|RespMsg        |应答消息,全部为英文字符 
- 10|交易时间    |14  |文本|transTime       |交易时间,格式:"yyyyMMddHHmmss" 
- 11|GW 处理时间 |14  |文本|GWTime |YYYYMMDDHHMMSS,为 GW 时间,目前为本地交易时间 
- 12|签名类型     |3  |文本|signType        |MD5 
- 13|签名      |32  |文本|signature         |采用 MD5 签名 

+ 0 - 19
docs/zh/wx/4.md

@@ -1,19 +0,0 @@
-# 4. 错误码
-
-若商户请求AllPay网关时,请求的参数错误或参数缺失时,AllPay网关会将错误信息以JSON格式返回给客户端,供商户解析调用,以下是相关错误信息返回参数的说明
-
-| 参数应答码code | 对应应答信息msg                            |
-| -------------- | ------------------------------------------ |
-| U1             | Clientid not found                         |
-| U2             | Signature error                            |
-| V1             | Parameter missing                          |
-| E1             | Exceed the limit                           |
-| R1             | Orderno repeat                             |
-| C1             | Order currency is not set                  |
-| P1             | paychannel error                           |
-| I1             | Illegal request address                    |
-| T1             | Parameter missing(version或tranType)     |
-| T2             | Txntype error                              |
-| T3             | transaction is not exist or fail           |
-| T4             | The maximum amount exceeds the upper limit |
-| 99             | System error  

+ 3 - 3
docs/zh/wx/README.md

@@ -1,6 +1,6 @@
-# 微信小程序支付接入规范文档4.2.1
+# 微信小程序支付接入规范文档4.3.0
 
 [上海偶可贝网络科技有限公司](https://www.allpayx.com)
 
-* 版本信息:中文 V4.2.1
-* 更新时间:2018 年6
+* 版本信息:中文 V4.3.0
+* 更新时间:2018 年11

+ 188 - 0
docs/zh/wx/common.md

@@ -0,0 +1,188 @@
+# 4. 通用接口
+
+## 4.1. 接口地址
+
+
+
+通用接口包括 交易异步通知,交易查询,退款,退款查询接口
+
+
+
+接口名称   |测试地址 |生产地址
+ ------- |-----------|-------
+ 交易查询接口 |<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>
+
+## 4.2. 异步通知报文
+
+AllPay服务器通过get方式,异步发送到消费接口中上送的backURL地址,商户根据收到的报文来确定交易的支付结果
+
+| 参数          | 类型         | 属性 | 描述                                                         |
+| ------------- | ------------ | ---- | ------------------------------------------------------------ |
+| version       | String(12)   | M    | 统一填写为“VER000000002”                                     |
+| charSet       | String(6)    | M    | 统一填写为“UTF-8”                                            |
+| transType     | String(4)    | M    | 消费交易填写“PURC”                                           |
+| orderNum      | String(60)   | M    | 订单号                                                       |
+| orderAmount   | String(12)   | M    | 订单金额:如 100 元,表示为 100 或 100.00                    |
+| orderCurrency | String(3)    | M    | 订单币种:ISO标准 如:人民币填写“CNY”,美元填写"USD"          |
+| settAmount    | String(12)   | M    | 清算金额:如 100 元,表示为 100 或 100.00                    |
+| settCurrency  | String(3)    | M    | 清算币种:符合 ISO 标准                                      |
+| rate          | String(7)    | M    | 实际汇率,7 位有效数字                                       |
+| merReserve    | String(1024) | 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.3. 查询交易接口 
+
+
+
+1. 接口说明
+
+ 该接口为接入商家提供交易查询的功能。
+
+2. 请求报文格式 
+
+  
+
+| 参数          | 类型         | 属性 | 描述                                                         |
+| ------------- | ------------ | ---- | ------------------------------------------------------------ |
+| version       | String(12)   | M    | 统一填写为“VER000000002”                                     |
+| charSet       | String(6)    | M    | 统一填写为“UTF-8”                                            |
+| transType     | String(4)    | M    | 查询填写“INQY”                                               |
+| orderNum      | 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    | 查询填写“INQY”                                               |
+| orderNum      | 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. 退款交易接口
+
+1.接口功能说明 
+
+该接口为接入商家提供交易退款的功能。 
+
+2.请求报文格式 
+
+
+
+| 参数          | 类型         | 属性 | 描述                                                         |
+| ------------- | ------------ | ---- | ------------------------------------------------------------ |
+| version       | String(12)   | M    | 统一填写为“VER000000002”                                     |
+| charSet       | String(6)    | M    | 统一填写为“UTF-8”                                            |
+| transType     | String(4)    | M    | 退款填写“REFD”                                               |
+| orderNum      | String(60)   | M    | 原交易订单号                                                 |
+| refundNum     | String(60)   | M    | 退款订单号:商户自行定义,需保证同一商户号下退款订单号不能重复 |
+| returnAmount  | String(12)   | M    | 退款金额:如 100 元,表示为 100 或 100.00                    |
+| orderCurrency | String(3)    | M    | 订单币种:ISO标准 如:人民币填写“CNY”,美元填写"USD"          |
+| 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"                           |
+| 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.5. 退款查询接口
+
+1. 1. 接口说明
+
+    该接口为接入商家提供退款查询的功能。
+
+   1. 请求报文格式 
+
+     
+
+   | 参数          | 类型         | 属性 | 描述                                                         |
+   | ------------- | ------------ | ---- | ------------------------------------------------------------ |
+   | 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 签名                                                |
+
+
+
+   1. 响应报文格式
+
+| 参数          | 类型       | 属性 | 描述                                                         |
+| ------------- | ---------- | ---- | ------------------------------------------------------------ |
+| 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                                                    |

docs/zh/wx/1.md → docs/zh/wx/overview.md


+ 49 - 0
docs/zh/wx/purc.md

@@ -0,0 +1,49 @@
+# 3.消费交易
+
+## 3.1. 消费交易地址 
+
+ 交易名称  |测试地址|生产地址  
+ ------- |-----------|-------
+ 消费接口 |<https://testapi.allpayx.com/gw/wap/pay> |<https://api.allpayx.com/gw/wap/pay>
+
+
+
+## 3.2. 消费交易接口
+
+1. 请求报文格式
+
+| 序号 | 名称          | 长度 | 类型 | 参数名称      | 备注                                                         |
+| ---- | ------------- | ---- | ---- | ------------- | ------------------------------------------------------------ |
+| 1    | 版本号        | 12   | 文本 | version       | 统一填写为“VER000000002”                                     |
+| 2    | 字符集编码    | 6    | 文本 | charSet       | 统一填写为“UTF-8”                                            |
+| 3    | 交易类型      | 4    | 文本 | transType     | 消费交易填写“PURC”                                           |
+| 4    | 订单号        | 60   | 文本 | orderNum      | 商户自行定义,需保证同一商户号下订单号不能重复               |
+| 5    | 交易模式      | 10   | 文本 | mode          | "applet"                                                     |
+| 6    | SDK 版本      | 10   | 文本 | jssdk         | "1.0"                                                        |
+| 7    | 授权码        | 60   | 文本 | code          | 微信小程序 login 接口获得的授权码                            |
+| 8    | 订单金额      | 12   | 文本 | orderAmount   | 如 100 元,表示为 100 或 100.00                              |
+| 9    | 订单币种      | 3    | 文本 | orderCurrency | 人民币填写“CNY”,美元填写"USD"                                |
+| 10   | 前端 URL 地址 | 400  | 文本 | frontURL      | 支付结果前端通知到该地址                                     |
+| 11   | 后端 URL 地址 | 400  | 文本 | backURL       | 支付结果异步通知到该地址                                     |
+| 12   | 商户预留字段  | 1024 | 文本 | merReserve    | 商户预留内容,可传任意内容,如购买商品信息、员号等,但不要传特殊符号,如逗号。 |
+| 13   | 商户代码      | 15   | 文本 | merID         | 商户 ID,由AllPay 分配                                       |
+| 14   | 收单行 ID     | 11   | 文本 | acqID         | 收单行 ID "99020344"                                         |
+| 15   | 支付渠道代码  | 10   | 文本 | paymentSchema | "WX"                                                         |
+| 16   | 商品信息      | 60   | 文本 | goodsInfo     | 商品信息                                                     |
+| 17   | 交易时间      | 14   | 文本 | transTime     | 交易时间,格式:"yyyyMMddHHmmss"                               |
+| 18   | 签名类型      | 3    | 文本 | signType      | MD5                                                          |
+| 19   | 签名          | 32   | 文本 | signature     | 采用 MD5 签名                                                |
+
+1. 返回数据格式
+
+```js
+{
+  'timeStamp': '',
+  'nonceStr': '',
+  'package': '',
+  'signType': 'MD5',
+  'paySign': ''
+}
+```
+
+将上述返回数据放入微信小程序支付接口,即可调起微信小程序支付,具体方法,参考[微信小程序 API ](

+ 13 - 0
docs/zh/wx/sign.md

@@ -0,0 +1,13 @@
+# 3.签名
+
+1.对于发送到 ALLPAY 系统的 POST 请求报文,其中所有传入参数(除 signature 参数外)按照字段名的 ASCII 码从小到大排序后(字典序),使用 URL 键值对的格式(即 key1=value1&key2=value2...)拼接成字符串 String1。
+
+2.在 String1 最后直接拼接(不需要用“&”连接)双方约定的签名密钥 K1(接入时 ALLPAY 时分配),得到 stringSignTemp 字符串,并对 stringSignTemp 进行 md5 运算,得到 signature 的值。
+
+3.示例签名串
+
+```js
+acqID=99020344&backURL=https://www.baidu.com&charSet=UTF-8&frontURL=nil&goodsInfo=iPhone x&merID=800039253992510&merReserve=&orderAmount=1.00&orderCurrency=INR&orderNum=ap0180417163142&paymentSchema=EB&signType=MD5&transTime=20180417163142&transType=PURC&trxn_email_id=benson.zhang@allpayx.com&trxn_firstname=benson zhang&trxn_is_coupon_enabled=1&trxn_phone=15026528888&unique_id=abcde12345&version=VER000000002f3e0e436cd24430aa4aaaed597450f26 
+```
+
+##