Selaa lähdekoodia

修改接口文档

tao.zhou 6 vuotta sitten
vanhempi
commit
28e6b9d0be

+ 14 - 16
AllPay_Customs_Integration_Specification_CH.md

@@ -4,27 +4,25 @@
 >- 版本信息:中文 V5.0.0
 >- 更新时间:2018 年12 月
 
-
-
-#### 1. 概述
+## 1. 概述
 
 本文档规定了商户与AllPay之间的海关申报产品进行联机交易时使用的报文接口。
 
-#### 2. 验签说明 
+## 2. 验签说明 
 
 ```
 1.对于发送到 AllPay 系统的 POST 请求报文,其中所有传入参数(除 signature 参数外)按照字段名的 ASCII 码从小到大排序后(字典序),使用 URL 键值对的格式(即 key1=value1&key2=value2...)拼接成字符串 String1。
 
-2.在 String1 最后直接拼接(不需要用“&”连接)双方约定的签名密钥 Key(接入 AllPay 时分配),得到 stringSignTemp 字符串,并对 stringSignTemp 进行 md5 运算,得到 signature 的值。
+2.在 String1 最后直接拼接(不需要用“&”连接)双方约定的签名密钥 Key(接入 AllPay 时分配),得到 stringSignTemp 字符串,并对 stringSignTemp 进行加密运算,得到 signature 的值。
 
 3.示例签名串 IDCard=411422199808080415&acqID=99020344&charSet=UTF-8&customerAccount=ab123456&customs_code=3302462548&customs_name=AAAA&customs_place=CUSTOMSHEADOFFICE&merID=000000000000015&merReserve=dd&name=shi kai feng&orderCurrency=CNY&orderNum=kfvWipRWHEboJPh71m7lXkUILutt&origOrderNum=VzVJhPdX18tDu3vgGfNOIgh71LjY&paymentSchema=UP&productPrice=80&signType=MD5&transTime=20181229171552&transType=DECL&transportPrice=10&version=VER0000000052f2c77e3718c47cfb47a89a6fbc9d361
 ```
 
-#### 3. 通用API说明 
+## 3. 通用API说明 
 
 商户服务器和 AllPay 网关对接的海关申报相关接口,包括申报、申报查询、申报更新。
 
-##### 3.1. 通用API 接入地址 
+### 3.1 通用 API 接入地址 
 
 | 交易名称 | 开发调试地址                               | 生产交易地址                               |
 | ------- | ----------------------------------------- | ------------------------------------------ |
@@ -32,7 +30,7 @@
 | 申报查询 | https://testapi.allpayx.com/custom/query   | https://api.allpayx.com/custom/query       |
 | 申报更新 | https://testapi.allpayx.com/custom/update | https://api.allpayx.com/custom/update |
 
-##### 3.2. 申报接口
+### 3.2 申报接口
 
 1.请求报文格式
 
@@ -83,7 +81,7 @@
 | signType       | String(10)  | M    | MD5或SHA256                                   |
 | signature      | String(32)  | M    | 采用 MD5或SHA256 签名                         |
 
-##### 3.3. 申报查询接口
+### 3.3 申报查询接口
 
 1.请求报文格式
 
@@ -122,7 +120,7 @@
 | signType       | String(10)  | M    | MD5或SHA256                                  |
 | signature      | String(32)  | M    | 采用 MD5或SHA256 签名                     |
 
-##### 3.4. 申报更新接口
+### 3.4 申报更新接口
 
 1.请求报文格式
 
@@ -173,9 +171,9 @@
 | signType       | String(10)  | M    | MD5或SHA256                                   |
 | signature      | String(32)  | M    | 采用 MD5或SHA256 签名                         |
 
-#### 4.	附件 1 海关列表
+## 4. 附件 1 海关列表
 
-##### 4.1 支付宝海关列表
+### 4.1 支付宝海关列表
 
 | 海关名称                                                     | 海关编码               |
 | ------------------------------------------------------------ | ---------------------- |
@@ -194,7 +192,7 @@
 | 苏州海关                                                     | ZONGSHU                |
 | 广州黄埔海关                                                 | GUANGZHOU_HUANGPU      |
 
-##### 4.2 微信海关列表
+### 4.2 微信海关列表
 
 | 海关名称                                                     | 海关编码        |
 | ------------------------------------------------------------ | --------------- |
@@ -212,7 +210,7 @@
 | 天津                                                         | TIANJIN         |
 | 北京                                                         | BEIJING         |
 
-##### 4.3 银联海关列表
+### 4.3 银联海关列表
 
 | 海关名称       | 海关编码          |
 | -------------- | ----------------- |
@@ -227,7 +225,7 @@
 
 以上海关列表为各渠道支持通过 API 报关的海关,实际支持情况以各渠道更新为准。
 
-#### 5. 附件 2 应答码
+## 5. 附件 2 应答码
 
 | 应答码 | 描述       |
 | ------ | ----------- |
@@ -249,6 +247,6 @@
 
 *注意:银联渠道申请报关后应答码为04处理中,需要过段时间调用申报查询接口确定最终状态。
 
-#### 6. 技术支持
+## 6. 技术支持
 
 如果您有任何问题,请邮件联系support@allpayx.com

+ 34 - 34
AllPay_Integration_Specification_CH.md

@@ -1,24 +1,24 @@
-# AllPay在线支付接入规范文档5.0.0
+# AllPay在线支付接入规范文档V5.0.0
 [上海偶可贝网络科技有限公司](https://www.allpayx.com)
 
 * 版本信息:中文 V5.0.0
 * 更新时间:2019 年1 月
 
-#### 1.概述
+## 1.概述
 AllPay 为客户提供统一的API接入,以帮助客户实 现快速、安全、集中式的接入支付渠道。
-#### 2.交易流程 
+## 2.交易流程 
 ![image](https://git.allpayx.com/OpenAPI/b2c/raw/master/images/pc_flowsheet.png)
-#### 3.验签说明 
+## 3.验签说明 
 ```
 1.对于发送到 AllPay 系统的 POST 请求报文,其中所有传入参数(除 signature 参数外)按照字段名的 ASCII 码从小到大排序后(字典序),使用 URL 键值对的格式(即 key1=value1&key2=value2...)拼接成字符串 String1。
 
-2.在 String1 最后直接拼接(不需要用“&”连接)双方约定的签名密钥 Key(接入 AllPay 时分配),得到 stringSignTemp 字符串,并对 stringSignTemp 进行 MD5 运算,得到 signature 的值。
+2.在 String1 最后直接拼接(不需要用“&”连接)双方约定的签名密钥 Key(接入 AllPay 时分配),得到 stringSignTemp 字符串,并对 stringSignTemp 进行加密运算,得到 signature 的值。
 
 3.示例签名串	acqID=99020344&backURL=https://baidu.com&charSet=UTF-8&detailInfo=W3siZ29vZHNfbmFtZSI6IuWNjuS4ulAyMCIsInF1YW50aXR5IjoiMiJ9LHsiZ29vZHNfbmFtZSI6IuWNjuS4ulAyMCBwbHVzIiwicXVhbnRpdHkiOiI0In1d&frontURL=https://mchapi.allpayx.com/demo&goodsInfo=华为P20&merID=000000000000015&merReserve=你好&orderAmount=1&orderCurrency=HKD&orderNum=dKmdb4S9Tv1a9ZpkMjeDawV82MCJ&paymentSchema=AP&signType=MD5&transTime=20181206134515&transType=PURC&version=VER0000000052f2c77e3718c47cfb47a89a6fbc9d361
 ```
-#### 4.通用API说明
+## 4.通用API说明
 商户服务器和 AllPay 网关对接的通用接口,每个渠道都具有的功能,包括:消费,消费查询,退款,退款查询。
-##### 4.1.通用API 接入地址 
+### 4.1 通用 API 接入地址 
 
 | 交易名称 | 测试地址                                 | 生产地址                             |
 | ------- | ------------------------------------------- | --------------------------------------- |
@@ -27,7 +27,7 @@ AllPay 为客户提供统一的API接入,以帮助客户实 现快速、安全
 | 退款    | https://testapi.allpayx.com/api/refund       | https://api.allpayx.com/api/refund       |
 | 退款查询 | https://testapi.allpayx.com/api/refundquery  | https://api.allpayx.com/api/refundquery  |
 
-##### 4.2.消费交易接口
+### 4.2 消费交易接口
 
 1.接口说明
 
@@ -85,7 +85,7 @@ AllPay 为客户提供统一的API接入,以帮助客户实 现快速、安全
 | signType      | String(10)   | M    | MD5或SHA256                                                  |
 | signature     | String(32)   | M    | 采用 MD5或SHA256 签名                                        |
 
-##### 4.3. 消费查询交易接口 
+### 4.3 消费查询交易接口 
 
 1.接口说明
 
@@ -125,7 +125,7 @@ AllPay 为客户提供统一的API接入,以帮助客户实 现快速、安全
 | signType      | String(3)  | M    | MD5或SHA256                                                  |
 | signature     | String(32) | M    | 采用 MD5或SHA256 签名                                        |
 
-##### 4.4 退款交易接口
+### 4.4 退款交易接口
 
 1.接口功能说明 
 
@@ -168,7 +168,7 @@ AllPay 为客户提供统一的API接入,以帮助客户实 现快速、安全
 | signType  | String(10) | M    | MD5或SHA256                                   |
 | signature | String(32) | M    | 采用 MD5或SHA256 签名                          |
 
-##### 4.5.退款查询交易接口
+### 4.5 退款查询交易接口
 
 1.接口说明
 
@@ -208,11 +208,11 @@ AllPay 为客户提供统一的API接入,以帮助客户实 现快速、安全
 | signType      | String(10) | M    | MD5或SHA256                                                  |
 | signature     | String(32) | M    | 采用 MD5或SHA256 签名                                        |
 
-#### 5.渠道专属配置
+## 5.渠道专属配置
 
-##### 5.1 WX渠道
+### 5.1 WX渠道
 
-###### 5.1.1 二维码无跳转模式
+#### 5.1.1 二维码无跳转模式
 
  该模式返回生成二维码的字符串,商户需要自己生成二维码。
 
@@ -230,7 +230,7 @@ AllPay 为客户提供统一的API接入,以帮助客户实 现快速、安全
 | RespMsg  | String | M    | 应答消息        |
 | code_url | String | O    | 二维码字符串。应答码为00返回该字段 |
 
-###### 5.1.2 二维码跳转模式
+#### 5.1.2 二维码跳转模式
 
 该模式会为商户跳转到AllPay生成好的二维码页面,无需商户自己生成。
 
@@ -240,7 +240,7 @@ AllPay 为客户提供统一的API接入,以帮助客户实 现快速、安全
 | --------- | ------ | ---- | ------- |
 | tradeFrom | String | M    | "QUICK" |
 
-###### 5.1.3 公众号支付
+#### 5.1.3 公众号支付
 
  消费接口专属字段
 
@@ -248,7 +248,7 @@ AllPay 为客户提供统一的API接入,以帮助客户实 现快速、安全
 | --------- | ------ | ---- | ------- |
 | tradeFrom | String | M    | "JSAPI" |
 
-###### 5.1.4 小程序支付
+#### 5.1.4 小程序支付
 
  消费接口专属字段
 
@@ -267,7 +267,7 @@ AllPay 为客户提供统一的API接入,以帮助客户实 现快速、安全
 
 将上述返回数据放入微信小程序支付接口,即可调起微信小程序支付,具体方法,参考微信小程序api
 
-###### 5.1.5 APP支付
+#### 5.1.5 APP支付
 
  消费接口专属字段
 
@@ -285,9 +285,9 @@ AllPay 为客户提供统一的API接入,以帮助客户实 现快速、安全
 
 获取到tn后,根据本文档第7节调用SDK进行支付。
 
-##### 5.2 AP渠道
+### 5.2 AP渠道
 
-###### 5.2.1 WebSite支付
+#### 5.2.1 WebSite支付
 
  消费接口专属字段
 
@@ -295,9 +295,9 @@ AllPay 为客户提供统一的API接入,以帮助客户实 现快速、安全
 | --------- | ------ | ---- | ----- |
 | tradeFrom | String | M    | "WEB" |
 
-##### 5.3 APMP渠道
+### 5.3 APMP渠道
 
-###### 5.3.1 H5支付
+#### 5.3.1 H5支付
 
  消费接口专属字段
 
@@ -305,7 +305,7 @@ AllPay 为客户提供统一的API接入,以帮助客户实 现快速、安全
 | --------- | ------ | ---- | ------- |
 | tradeFrom | String | M    | "JSAPI" |
 
-###### 5.3.2 APP支付
+#### 5.3.2 APP支付
 
  消费接口专属字段
 
@@ -323,7 +323,7 @@ AllPay 为客户提供统一的API接入,以帮助客户实 现快速、安全
 
 获取到tn后,根据本文档第7节调用SDK进行支付。
 
-###### 5.3.3 二维码无跳转模式
+#### 5.3.3 二维码无跳转模式
 
  该模式返回生成二维码的字符串,商户需要自己生成二维码。
 
@@ -341,9 +341,9 @@ AllPay 为客户提供统一的API接入,以帮助客户实 现快速、安全
 | RespMsg  | String | M    | 应答消息                           |
 | code_url | String | O    | 二维码字符串。应答码为00返回该字段 |
 
-##### 5.4 UP渠道
+### 5.4 UP渠道
 
-###### 5.4.1 H5支付,自适应PC和移动端
+#### 5.4.1 H5支付,自适应PC和移动端
 
  消费接口专属字段
 
@@ -351,7 +351,7 @@ AllPay 为客户提供统一的API接入,以帮助客户实 现快速、安全
 | --------- | ------ | ---- | ---- |
 | tradeFrom | String | M    | "H5" |
 
-###### 5.4.2 APP支付
+#### 5.4.2 APP支付
 
  消费接口专属字段
 
@@ -387,9 +387,9 @@ SMS Code on PC: 111111
 SMS Code on Mobile: 123456
 ```
 
-##### 5.5 Apple Pay渠道
+### 5.5 Apple Pay渠道
 
-###### 5.5.1 APP支付
+#### 5.5.1 APP支付
 
  消费接口专属字段
 
@@ -407,9 +407,9 @@ SMS Code on Mobile: 123456
 
 获取到tn后,根据本文档第7节调用SDK进行支付。
 
-##### 5.6 CA渠道
+### 5.6 CA渠道
 
-###### 5.6.1 APP支付
+#### 5.6.1 APP支付
 
  消费接口专属字段
 
@@ -427,7 +427,7 @@ SMS Code on Mobile: 123456
 
  获取到tn后,根据[Android对接文档](https://git.allpayx.com/OpenAPI/common/src/master/v5/android/Android_Integration_Specification_CH.md)调用SDK进行支付
 
-#### 6.应答码 
+## 6.应答码 
 
 | 应答码 | 描  述      |
 | ------ | --------- |
@@ -450,12 +450,12 @@ SMS Code on Mobile: 123456
 | P4     | 功能不支持  |
 | P5     | 渠道返回错误  |
 
-#### 7.APP模式对接文档
+## 7.APP模式对接文档
 
 Android对接文档:[点击这里](https://git.allpayx.com/OpenAPI/common/src/master/v5/android/Android_Integration_Specification_CH.md)
 
 iOS对接文档:[点击这里](https://git.allpayx.com/OpenAPI/common/src/master/v5/ios/iOS_Integration_Specification_CH.md)
 
-#### 8.技术支持
+## 8.技术支持
 
 如果您在调试时遇到问题,请与我们联系:support@allpayx.com

+ 32 - 32
AllPay_Integration_Specification_EN.md

@@ -4,11 +4,11 @@
 * Version:English V5.0.0
 * Update Time:2019/04
 
-#### 1.Overview
+## 1.Overview
 AllPay provides customers with unified API access to help them implement fast, secure and centralized access payment channels.
-#### 2.Transaction process 
+## 2.Transaction process 
 ![image](https://git.allpayx.com/OpenAPI/b2c/raw/master/images/pc_flowsheet.png)
-#### 3.Description of verifying the signature 
+## 3.Description of verifying the signature 
 
 1.For a POST request message sent to the AllPay system, in which all incoming parameters (except signature parameters) according to the field name of ASCII smallest sequence (dictionary), using the format of the URL key/value pair (key1 = value1 & key2 = value2... ) spliced into a string String1.
 
@@ -16,9 +16,9 @@ AllPay provides customers with unified API access to help them implement fast, s
 
 3.Sample signature string: acqID=99020344&backURL=https://www.allpayx.com&charSet=UTF-8&detailInfo=W3siZ29vZHNfbmFtZSI6IuiLueaenCIsInF1YW50aXR5IjoiMyJ9LHsiZ29vZHNfbmFtZSI6IuapmOWtkCIsInF1YW50aXR5IjoiNyJ9XQ==&frontURL=https://www.baidu.com&goodsInfo=apple&merID=000000000000015&merReserve=iPhone&orderAmount=0.01&orderCurrency=USD&orderNum=20190104022800&paymentSchema=AP&signType=MD5&transTime=20190104022800&transType=PURC&version=VER0000000022f2c77e3718c47cfb47a89a6fbc9d361
 
-#### 4.Common interface
+## 4.Common interface
 Common interface includes notification, asynchronous notification of transactions, transaction inquiry, refund, refund inquiry interface
-##### 4.1.General API access address 
+### 4.1.General API access address 
 
 | Interface Name | Test URL                                 | Production URL                             |
 | ------- | ------------------------------------------- | --------------------------------------- |
@@ -27,7 +27,7 @@ Common interface includes notification, asynchronous notification of transaction
 | Refund    | https://testapi.allpayx.com/api/refund       | https://api.allpayx.com/api/refund       |
 | Refund inquiry | https://testapi.allpayx.com/api/refundquery  | https://api.allpayx.com/api/refundquery  |
 
-##### 4.2.Purchase interface
+### 4.2.Purchase interface
 
 1.Interface specification
 
@@ -85,7 +85,7 @@ Parameters as follows:
 | signType      | String(10)   | M    | "MD5" or "SHA256"                                                  |
 | signature     | String(32)   | M    | MD5 or SHA256 signature                                        |
 
-##### 4.3. Inqiury interface 
+### 4.3. Inqiury interface 
 
 1.Interface specification
 
@@ -125,7 +125,7 @@ Parameters as follows:
 | signType      | String(3)  | M    | "MD5" or "SHA256"                                                  |
 | signature     | String(32) | M    | MD5 or SHA256 signature                                        |
 
-##### 4.4 Refund interface
+### 4.4 Refund interface
 
 1.Interface specification 
 
@@ -168,7 +168,7 @@ This interface provides the function of refund transaction for access merchants.
 | signType  | String(10) | M    | "MD5" or "SHA256"                                  |
 | signature | String(32) | M    | MD5 or SHA256 signature                          |
 
-##### 4.5.Refund Inqiury interface
+### 4.5.Refund Inqiury interface
 
 1.Interface specification
 
@@ -208,11 +208,11 @@ This interface provides the function of refund transaction for access merchants.
 | signType      | String(10) | M    | "MD5" or "SHA256"                                                  |
 | signature     | String(32) | M    | MD5 or SHA256 signature                                        |
 
-#### 5.Channel exclusive allocation
+## 5.Channel exclusive allocation
 
-##### 5.1 WX
+### 5.1 WX
 
-###### 5.1.1 QR code no jump mode
+#### 5.1.1 QR code no jump mode
 
  This mode returns the URL value of WeChat payment collection for parameter return, ask the merchant to convert it into QR code, generate the front interface of payment, and prompt the user to scan the code to pay.
 
@@ -230,7 +230,7 @@ Response message:
 | RespMsg  | String | M    | Response message        |
 | code_url | String | O    | Characters to generate QR code. When RespCode=00 returns it. |
 
-###### 5.1.2 QR code jump mode
+#### 5.1.2 QR code jump mode
 
 It's jump mode, open the front-end page provided by AllPay, which contains WeChat QR code.
 
@@ -240,7 +240,7 @@ It's jump mode, open the front-end page provided by AllPay, which contains WeCha
 | --------- | ------ | ---- | ------- |
 | tradeFrom | String | M    | "QUICK" |
 
-###### 5.1.3 WeChat Official Accounts payment
+#### 5.1.3 WeChat Official Accounts payment
 
  Purchase interface specific fields
 
@@ -248,7 +248,7 @@ It's jump mode, open the front-end page provided by AllPay, which contains WeCha
 | --------- | ------ | ---- | ------- |
 | tradeFrom | String | M    | "JSAPI" |
 
-###### 5.1.4 WeChat Mini Programs payment
+#### 5.1.4 WeChat Mini Programs payment
 
  Purchase interface specific fields
 
@@ -267,7 +267,7 @@ Response message:
 
 Parameter sdk_params is used to call up the WeChat Mini Programs payment. Please refer to the Mini Programs integration specification.
 
-###### 5.1.5 APP mode
+#### 5.1.5 APP mode
 
  Purchase interface specific fields
 
@@ -285,9 +285,9 @@ Response message:
 
 After getting tn, call the SDK to pay according to Section 7 of this document.
 
-##### 5.2 AP
+### 5.2 AP
 
-###### 5.2.1 WebSite mode
+#### 5.2.1 WebSite mode
 
  Purchase interface specific fields
 
@@ -295,9 +295,9 @@ After getting tn, call the SDK to pay according to Section 7 of this document.
 | --------- | ------ | ---- | ----- |
 | tradeFrom | String | M    | "WEB" |
 
-##### 5.3 APMP
+### 5.3 APMP
 
-###### 5.3.1 H5 mode
+#### 5.3.1 H5 mode
 
  Purchase interface specific fields
 
@@ -305,7 +305,7 @@ After getting tn, call the SDK to pay according to Section 7 of this document.
 | --------- | ------ | ---- | ------- |
 | tradeFrom | String | M    | "JSAPI" |
 
-###### 5.3.2 APP mode
+#### 5.3.2 APP mode
 
  Purchase interface specific fields
 
@@ -323,7 +323,7 @@ Response message:
 
 After getting tn, call the SDK to pay according to Section 7 of this document.
 
-###### 5.3.3 QR code no jump mode
+#### 5.3.3 QR code no jump mode
 
  This mode returns the URL value of WeChat payment collection for parameter return, ask the merchant to convert it into QR code, generate the front interface of payment, and prompt the user to scan the code to pay.
 
@@ -341,9 +341,9 @@ Response message:
 | RespMsg  | String | M    | Response message        |
 | code_url | String | O    | Characters to generate QR code. When RespCode=00 returns it. |
 
-##### 5.4 UP
+### 5.4 UP
 
-###### 5.4.1 H5 mode, adaptive PC and mobile
+#### 5.4.1 H5 mode, adaptive PC and mobile
 
  Purchase interface specific fields
 
@@ -351,7 +351,7 @@ Response message:
 | --------- | ------ | ---- | ---- |
 | tradeFrom | String | M    | "H5" |
 
-###### 5.4.2 APP mode
+#### 5.4.2 APP mode
 
  Purchase interface specific fields
 
@@ -387,9 +387,9 @@ SMS Code on PC: 111111
 SMS Code on Mobile: 123456
 ```
 
-##### 5.5 Apple Pay
+### 5.5 Apple Pay
 
-###### 5.5.1 APP mode
+#### 5.5.1 APP mode
 
  Purchase interface specific fields
 
@@ -407,9 +407,9 @@ Response message:
 
 After getting tn, call the SDK to pay according to Section 7 of this document.
 
-##### 5.6 CA
+### 5.6 CA
 
-###### 5.6.1 APP mode
+#### 5.6.1 APP mode
 
  Purchase interface specific fields
 
@@ -427,7 +427,7 @@ Response message:
 
  After you get tn,please integrate according to [Android Integration Specification](https://git.allpayx.com/OpenAPI/common/src/master/v5/android/Android_Integration_Specification_EN.md)
 
-#### 6.RespCode 
+## 6.RespCode 
 
 | RespCode | Description      |
 | ------ | --------- |
@@ -450,12 +450,12 @@ Response message:
 | P4     | Function is not supported  |
 | P5     | Channel returns "Error"  |
 
-#### 7.APP mode integration specification
+## 7.APP mode integration specification
 
 Android Integration Specification:[Click Here](https://git.allpayx.com/OpenAPI/common/src/master/v5/android/Android_Integration_Specification_EN.md)
 
 iOS Integration Specification:[Click Here](https://git.allpayx.com/OpenAPI/common/src/master/v5/ios/iOS_Integration_Specification_EN.md)
 
-#### 8.Technical support
+## 8.Technical support
 
 If you have problems with debugging, please contact us: support@allpayx.com

+ 11 - 11
AllPay_Other_Integration_Specification_CH.md

@@ -1,25 +1,25 @@
-# AllPay其他接口文档1.0.0
+# AllPay其他接口文档V1.0.0
 [上海偶可贝网络科技有限公司](https://www.allpayx.com)
 
 * 版本信息:中文 V1.0.0
 * 更新时间:2019 年2 月
 
-#### 1.概述
+## 1.概述
 
 AllPay 为客户提供统一的API接入,以帮助客户实 现快速、安全、集中式的接入支付渠道。
 
-#### 2. 验签说明 
+## 2.验签说明 
 ```
 1.对于发送到 AllPay 系统的 POST 请求报文,其中所有传入参数(除 signature 参数外)按照字段名的 ASCII 码从小到大排序后(字典序),使用 URL 键值对的格式(即 key1=value1&key2=value2...)拼接成字符串 String1。
 
-2.在 String1 最后直接拼接(不需要用“&”连接)双方约定的签名密钥 Key(接入 AllPay 时分配),得到 stringSignTemp 字符串,并对 stringSignTemp 进行 md5 运算,得到 signature 的值。
+2.在 String1 最后直接拼接(不需要用“&”连接)双方约定的签名密钥 Key(接入 AllPay 时分配),得到 stringSignTemp 字符串,并对 stringSignTemp 进行加密运算,得到 signature 的值。
 
 3.示例签名串  merID=000000000000015&signType=MD5&transID=MQkmUGAh3Gw2HEEi2f2c77e3718c47cfb47a89a6fbc9d361
 ```
 
-#### 3. API 说明
+## 3.API 说明
 
-##### 3.1. 汇率查询接口
+### 3.1 汇率查询接口
 
 该接口提供银联、微信、支付宝渠道汇率查询的功能。
 
@@ -48,7 +48,7 @@ AllPay 为客户提供统一的API接入,以帮助客户实 现快速、安全
 | conversion_currency | M    | 转换币种,取值:CNY(当前仅支持CNY)                  |
 | exchange_rate  | M    | 参考汇率值                            |
 
-##### 3.2. 获取渠道流水信息接口
+### 3.2 获取渠道流水信息接口
 
 该接口提供通过transID查询渠道流水的功能。
 
@@ -56,7 +56,7 @@ AllPay 为客户提供统一的API接入,以帮助客户实 现快速、安全
 | --------------------------------------------- | ----------------------------------------- |
 | https://testapi.allpayx.com/api/schemaTransId | https://api.allpayx.com/api/schemaTransId |
 
-1.请求报文格式
+1.请求参数
 
 | 参数      | 类型       | 属性 | 描述                                  |
 | --------- | ---------- | ---- | ------------------------------------- |
@@ -65,7 +65,7 @@ AllPay 为客户提供统一的API接入,以帮助客户实 现快速、安全
 | signType  | String(10) | M    | MD5或SHA256                            |
 | signature | String(60) | M    | 采用 MD5或SHA256 签名                  |
 
-2.响应报文格式
+2.响应参数
 
 | 参数           | 类型       | 属性 | 描述                                                         |
 | -------------- | ---------- | ---- | ------------------------------------------------------------ |
@@ -78,7 +78,7 @@ AllPay 为客户提供统一的API接入,以帮助客户实 现快速、安全
 | RespCode       | String(2)  | M    | 应答码 00-成功                                               |
 | RespMsg        | String(20) | M    | 应答消息                                                     |
 
-#### 4.应答码 
+## 4.应答码 
 
 | 应答码 | 描  述       |
 | ------ | ------------ |
@@ -94,7 +94,7 @@ AllPay 为客户提供统一的API接入,以帮助客户实 现快速、安全
 | U9     | 系统错误     |
 | P4     | 功能不支持   |
 
-#### 5.技术支持
+## 5.技术支持
 
 如果您在调试时遇到问题,请与我们联系:support@allpayx.com
 

+ 1 - 1
paymentSchema.md

@@ -1,4 +1,4 @@
-#### Channel list
+# Channel list
 Serial number |Channel name  |Channel ID|Remark 
  -----|-----|----|------
  1 | WeChat Pay |WX|WeChat Pay

+ 12 - 12
v5/android/Android_Integration_Specification_CH.md

@@ -1,20 +1,20 @@
-# Android端控件支付产品接口规范文档5.0.0
+# Android端控件支付产品接口规范文档V5.0.0
 
 [上海偶可贝网络科技有限公司](https://www.allpayx.com)
 
 * 版本信息:中文 V5.0.0
 * 更新时间:2019年4月
 
-#### 1.概述
+## 1.概述
 
 AllPay 为基于移动端 APP 支付的客户提供接入插件(下文简称“SDK”),以帮助客户实现快速、安全、集中式的接入支付渠道。
 
-#### 2.交易流程 
+## 2.交易流程 
   ![image](https://git.allpayx.com/OpenAPI/b2c/raw/master/images/moble_sdk_flowsheet.png)
 
-#### 3. Android 客户端接入步骤 
+## 3.Android 客户端接入步骤 
 
-##### 3.1. 接入说明 
+### 3.1 接入说明 
 
 商户网关将订单信息发送给 AllPay 网关,由 AllPay 网关进行处理后将交易流水号,即 tn,返回给商户网关,tn 作为调起手机 app 支付控件的参数。具体请参考[AllPay网关对接文档](https://git.allpayx.com/OpenAPI/common/src/master/AllPay_Integration_Specification_CH.md)
 
@@ -32,7 +32,7 @@ tn —— 交易流水号,作为调起 sdk 支付的参数,商户从 AllPay
 mode —— AllPay 后台环境标识,true表示从AllPay的正式环境发起交易,false表示从AllPay的测试环境发起交易
 :::
 
-##### 3.2. 添加 SDK 包
+### 3.2 添加 SDK 包
 
 1.把allpaysdk.arr 拷贝到项目的libs下面
 
@@ -48,7 +48,7 @@ repositories {
 }
 ```
 
-##### 3.3. 调用支付控件
+### 3.3 调用支付控件
 
 接着可以通过以下方式调用支付控件:
 
@@ -60,7 +60,7 @@ repositories {
 AllPayEngine.Pay(ShopCartActivity.this, tn, false);
 ```
 
-##### 3.4. 同步结果通知
+### 3.4 同步结果通知
 
 支付完成后,获取支付控件支付结果,并添加相应处理逻辑,只需实现调用 Activity 中的 onActivityResult()方法即可,实例代码如下:
 
@@ -95,9 +95,9 @@ pay_result,为 json 字符串,格式如下:
 - orderNum: 订单号
 - errorDetail: 错误详情
 
-#### 4.渠道专属配置
+## 4.渠道专属配置
 
-##### 4.1 WX渠道
+### 4.1 WX渠道
 
   在Application Module的build.gradle文件的dependencies下添加
 
@@ -105,10 +105,10 @@ pay_result,为 json 字符串,格式如下:
   compile 'com.tencent.mm.opensdk:wechat-sdk-android-without-mta:+'
   ```
 
-#### 5.SDK下载
+## 5.SDK下载
 
 [安卓SDK下载地址](https://git.allpayx.com/OpenAPI/common/raw/master/v5/android/android_sdk.zip)
 
-#### 6.技术支持
+## 6.技术支持
 
 如果您在调试时遇到问题,请与我们联系:support@allpayx.com

+ 11 - 11
v5/android/Android_Integration_Specification_EN.md

@@ -5,16 +5,16 @@
 * Version:English V5.0.0
 * Update Time:2019/04
 
-#### 1.Overview
+## 1.Overview
 
 AllPay provides access plug-ins (hereinafter referred to as "SDK") for customers based on mobile APP payments to help customers achieve fast, secure and centralized access to payment channels.
 
-#### 2.Transaction process 
+## 2.Transaction process 
   ![image](https://git.allpayx.com/OpenAPI/b2c/raw/master/images/moble_sdk_flowsheet.png)
 
-#### 3. Android client access steps 
+## 3.Android client access steps 
 
-##### 3.1. Access instructions 
+### 3.1 Access instructions 
 
 The merchant gateway sends the order information to the AllPay gateway, and the AllPay gateway processes the transaction serial number, ie tn, back to the merchant gateway, and tn is used as a parameter to adjust the mobile app payment control. Please refer to the specific [AllPay Gateway Docking Document](https://git.allpayx.com/OpenAPI/common/src/master/AllPay_Integration_Specification_EN.md)
 
@@ -32,7 +32,7 @@ tn - Transaction serial number. Required parameter for app payment. Merchants ge
 mode - AllPay background environment ID, true means to initiate a transaction from the AllPay formal environment, false means to initiate a transaction from the AllPay test environment.
 :::
 
-##### 3.2. Add SDK
+### 3.2 Add SDK
 
 1.Copy allpaysdk.arr to the project's libs.
 
@@ -48,7 +48,7 @@ repositories {
 }
 ```
 
-##### 3.3. Call payment control
+### 3.3 Call payment control
 
 Call the payment control in the following way:
 
@@ -60,7 +60,7 @@ Call the payment control in the following way:
 AllPayEngine.Pay(ShopCartActivity.this, tn, false);
 ```
 
-##### 3.4. Synchronization result notification
+### 3.4 Synchronization result notification
 
 After the payment is completed, obtain the payment control payment result, and add the corresponding processing logic, just implement the onActivityResult() method in the Activity, and the example code is as follows:
 
@@ -95,9 +95,9 @@ Message description:
 - orderNum: Order number
 - errorDetail: Error details
 
-#### 4.Channel specific configuration
+## 4.Channel specific configuration
 
-##### 4.1 WX channel
+### 4.1 WX channel
 
   Add in the dependencies of the build.gradle file in the Application Module
 
@@ -105,10 +105,10 @@ Message description:
   compile 'com.tencent.mm.opensdk:wechat-sdk-android-without-mta:+'
   ```
 
-#### 5.SDK download
+## 5.SDK download
 
 [Download link](https://git.allpayx.com/OpenAPI/common/raw/master/v5/android/android_sdk.zip)
 
-#### 6.Technical Support
+## 6.Technical Support
 
 If you have problems debugging, please contact us: support@allpayx.com

+ 14 - 14
v5/ios/iOS_Integration_Specification_CH.md

@@ -1,20 +1,20 @@
-# iOS端控件支付产品接口规范文档5.0.0
+# iOS端控件支付产品接口规范文档V5.0.0
 
 [上海偶可贝网络科技有限公司](https://www.allpayx.com)
 
 * 版本信息:中文 V5.0.0
 * 更新时间:2019年4月
 
-#### 1.概述
+## 1.概述
 
 AllPay 为基于移动端 APP 支付的客户提供接入插件(下文简称“SDK”),以帮助客户实现快速、安全、集中式的接入支付渠道。
 
-#### 2.交易流程 
+## 2.交易流程 
   ![image](https://git.allpayx.com/OpenAPI/b2c/raw/master/images/moble_sdk_flowsheet.png)
 
-#### 3. iOS 客户端接入步骤 
+## 3.iOS 客户端接入步骤 
 
-##### 3.1. 接入说明 
+### 3.1 接入说明 
 
 商户网关将订单信息发送给 AllPay 网关,由 AllPay 网关进行处理后将交易流水号,即 tn,返回给商户网关,tn 作为调起手机 app 支付控件的参数。[AllPay网关对接文档](https://git.allpayx.com/OpenAPI/common/src/master/AllPay_Integration_Specification_CH.md)
 
@@ -40,7 +40,7 @@ ViewController: 调用 SDK 时的 ViewController;
 onResult: 接收同步结果通知
 ```
 
-##### 3.2. 添加 SDK 包
+### 3.2 添加 SDK 包
 
 1.将  allpaysdk 下的 AllPaySDK.h,libAllPaySDK.a文件添加到项目中
 
@@ -68,7 +68,7 @@ onResult: 接收同步结果通知
 
 3.根据要使用的渠道的专属配置(见第4节),对项目进行配置。
 
-##### 3.3 同步结果通知 
+### 3.3 同步结果通知 
 
 ```c
 [AllPaySDK pay:[diction objectForKey:@"tn"] mode:NO scheme:@"com.xxx.xxx" ViewController:self onResult: ^(NSDictionary *resultDic) { 
@@ -96,9 +96,9 @@ resultDic,转为 json 字符串,格式如下:
 | orderNum      | 订单号 |
 | errorDetail   | 错误详情 |
 
-#### 4.渠道专属配置
+## 4.渠道专属配置
 
-##### 4.1 WX渠道
+### 4.1 WX渠道
 
 1.将allpaysdk/WXModule文件夹下的文件添加到项目中
 
@@ -132,7 +132,7 @@ resultDic,转为 json 字符串,格式如下:
    </dict>
    ```
 
-##### 4.2 APMP渠道
+### 4.2 APMP渠道
 
 1.将allpaysdk/AliModule文件夹下的文件添加到项目中
 
@@ -154,7 +154,7 @@ resultDic,转为 json 字符串,格式如下:
 
   ![image](https://git.allpayx.com/OpenAPI/common/raw/master/images/ios_wx_01.jpg)
 
-##### 4.3 UP渠道
+### 4.3 UP渠道
 
 1.将allpaysdk/UPModule文件夹下的文件添加到项目中
 
@@ -185,7 +185,7 @@ resultDic,转为 json 字符串,格式如下:
 
    在测试环境时,需要在工程对应的plist文件中添加NSAppTransportSecurity  Dictionary,并同时设置NSAllowsArbitraryLoads属性值为 YES。向App Store发布正式版本时请删除此设置。
 
-##### 4.4 Apple Pay渠道
+### 4.4 Apple Pay渠道
 
 1.将allpaysdk/AppleModule文件夹下的文件添加到项目中
 
@@ -203,10 +203,10 @@ resultDic,转为 json 字符串,格式如下:
    }
    ```
 
-#### 5.SDK下载
+## 5.SDK下载
 
 [iOS SDK下载地址](https://git.allpayx.com/OpenAPI/common/raw/master/v5/ios/ios_sdk.zip)
 
-#### 6.技术支持
+## 6.技术支持
 
 如果您在调试时遇到问题,请与我们联系:support@allpayx.com

+ 13 - 13
v5/ios/iOS_Integration_Specification_EN.md

@@ -5,16 +5,16 @@
 * Version:English V5.0.0
 * Update Time:2019/04
 
-#### 1.Overview
+## 1.Overview
 
 AllPay provides access plug-ins (hereinafter referred to as "SDK") for customers based on mobile APP payments to help customers achieve fast, secure and centralized access to payment channels.
 
-#### 2.Transaction process 
+## 2.Transaction process 
   ![image](https://git.allpayx.com/OpenAPI/b2c/raw/master/images/moble_sdk_flowsheet.png)
 
-#### 3. iOS client access steps 
+## 3.iOS client access steps 
 
-##### 3.1. Access instructions 
+### 3.1 Access instructions 
 
 The merchant gateway sends the order information to the AllPay gateway, and the AllPay gateway processes the transaction serial number, ie tn, back to the merchant gateway, and tn is used as a parameter to adjust the mobile app payment control. Please refer to the specific [AllPay Gateway Docking Document](https://git.allpayx.com/OpenAPI/common/src/master/AllPay_Integration_Specification_EN.md)
 
@@ -39,7 +39,7 @@ ViewController: The ViewController when the SDK is called.
 onResult: Receive sync result notifications.
 ```
 
-##### 3.2. Add SDK
+### 3.2 Add SDK
 
 1.Add the AllPaySDK.h, libAllPaySDK.a files in allpaysdk to the project.
 
@@ -67,7 +67,7 @@ onResult: Receive sync result notifications.
 
 3.Configure the project according to the exclusive configuration of the channel to be used (see Section 4).
 
-##### 3.3 Synchronization result notification 
+### 3.3 Synchronization result notification 
 
 ```c
 [AllPaySDK pay:[diction objectForKey:@"tn"] mode:NO scheme:@"com.xxx.xxx" ViewController:self onResult: ^(NSDictionary *resultDic) { 
@@ -95,9 +95,9 @@ Message description
 | orderNum      | Order number |
 | errorDetail   | Error details |
 
-#### 4.Channel specific configuration
+## 4.Channel specific configuration
 
-##### 4.1 WX channel
+### 4.1 WX channel
 
 1.Add the file under the allpaysdk/WXModule folder to the project.
 
@@ -131,7 +131,7 @@ Message description
    </dict>
    ```
 
-##### 4.2 APMP channel
+### 4.2 APMP channel
 
 1.Add the file under the allpaysdk/AliModule folder to the project.
 
@@ -153,7 +153,7 @@ Message description
 
   ![image](https://git.allpayx.com/OpenAPI/common/raw/master/images/ios_wx_01.jpg)
 
-##### 4.3 UP channel
+### 4.3 UP channel
 
 1.Add the file under the allpaysdk/UPModule folder to the project.
 
@@ -184,7 +184,7 @@ Message description
 
    In the environment test, you need to add NSAppTransportSecurity Dictionary to the project's corresponding plist file and set the NSAllowsArbitraryLoads property to YES. Please remove this setting when releasing the official version to App Store.
 
-##### 4.4 Apple Pay
+### 4.4 Apple Pay
 
 1.Add the file under the allpaysdk/AppleModule folder to the project.
 
@@ -202,10 +202,10 @@ Message description
    }
    ```
 
-#### 5.SDK download
+## 5.SDK download
 
 [Download link](https://git.allpayx.com/OpenAPI/common/raw/master/v5/ios/ios_sdk.zip)
 
-#### 6.Technical Support
+## 6.Technical Support
 
 If you have problems debugging, please contact us: support@allpayx.com