kang.wang %!s(int64=6) %!d(string=hai) anos
achega
c44a877f2d
Modificáronse 59 ficheiros con 14868 adicións e 0 borrados
  1. 4 0
      .gitignore
  2. 14 0
      README.md
  3. 146 0
      docs/.vuepress/config.js
  4. BIN=BIN
      docs/.vuepress/public/favicon.ico
  5. BIN=BIN
      docs/.vuepress/public/logo.png
  6. 26 0
      docs/README.md
  7. 3 0
      docs/android/1.md
  8. 3 0
      docs/android/2.md
  9. 145 0
      docs/android/3.md
  10. 105 0
      docs/android/4.md
  11. 14 0
      docs/android/5.md
  12. 6 0
      docs/android/README.md
  13. 5 0
      docs/cart/README.md
  14. 3 0
      docs/h5/1.md
  15. 3 0
      docs/h5/2.md
  16. 161 0
      docs/h5/3.md
  17. 5 0
      docs/h5/README.md
  18. 3 0
      docs/ios/1.md
  19. 3 0
      docs/ios/2.md
  20. 145 0
      docs/ios/3.md
  21. 100 0
      docs/ios/4.md
  22. 29 0
      docs/ios/5.md
  23. 6 0
      docs/ios/README.md
  24. 3 0
      docs/pc/1.md
  25. 3 0
      docs/pc/2.md
  26. 161 0
      docs/pc/3.md
  27. 380 0
      docs/pc/4.md
  28. 22 0
      docs/pc/5.md
  29. 17 0
      docs/pc/6.md
  30. 5 0
      docs/pc/README.md
  31. 14 0
      docs/wx/README.md
  32. 26 0
      docs/zh/README.md
  33. 3 0
      docs/zh/android/1.md
  34. 3 0
      docs/zh/android/2.md
  35. 145 0
      docs/zh/android/3.md
  36. 105 0
      docs/zh/android/4.md
  37. 14 0
      docs/zh/android/5.md
  38. 6 0
      docs/zh/android/README.md
  39. 26 0
      docs/zh/cart/README.md
  40. 3 0
      docs/zh/h5/1.md
  41. 2 0
      docs/zh/h5/2.md
  42. 167 0
      docs/zh/h5/3.md
  43. 6 0
      docs/zh/h5/README.md
  44. 3 0
      docs/zh/ios/1.md
  45. 3 0
      docs/zh/ios/2.md
  46. 145 0
      docs/zh/ios/3.md
  47. 100 0
      docs/zh/ios/4.md
  48. 29 0
      docs/zh/ios/5.md
  49. 6 0
      docs/zh/ios/README.md
  50. 3 0
      docs/zh/pc/1.md
  51. 2 0
      docs/zh/pc/2.md
  52. 167 0
      docs/zh/pc/3.md
  53. 376 0
      docs/zh/pc/4.md
  54. 21 0
      docs/zh/pc/5.md
  55. 19 0
      docs/zh/pc/6.md
  56. 6 0
      docs/zh/pc/README.md
  57. 14 0
      docs/zh/wx/README.md
  58. 11912 0
      package-lock.json
  59. 22 0
      package.json

+ 4 - 0
.gitignore

@@ -0,0 +1,4 @@
+.idea/
+.vscode/
+/node_modules/
+/dist/

+ 14 - 0
README.md

@@ -0,0 +1,14 @@
+# b2c api文档
+
+``` bash
+# install
+npm i
+
+# start writing
+npm run dev
+
+# build to static files
+npm run build
+```
+
+VuePress requires Node.js >= 8.

+ 146 - 0
docs/.vuepress/config.js

@@ -0,0 +1,146 @@
+module.exports = {
+  dest: 'dist',
+  locales: {
+    '/': {
+      lang: 'en-US',
+      title: 'AllPay',
+      description: 'api docs'
+    },
+    '/zh/': {
+      lang: 'zh-CN',
+      title: 'AllPay',
+      description: 'api接入文档'
+    }
+  },
+  head: [
+    ['link', { rel: 'icon', href: `/favicon.ico` }],
+    ['meta', { name: 'theme-color', content: '#3eaf7c' }],
+  ],
+  themeConfig: {
+    repo: 'allpayx/allpayx.github.io',
+    editLinks: true,
+    docsDir: 'docs',
+    locales: {
+      '/': {
+        label: 'English',
+        selectText: 'Languages',
+        editLinkText: 'Edit this page on GitHub',
+        lastUpdated: 'Last Updated',
+        nav: [
+          {
+            text: 'PC Web',
+            link: '/pc/',
+          },
+          {
+            text: 'Android',
+            link: '/android/'
+          },
+          {
+            text: 'IOS',
+            link: '/ios/'
+          },
+          {
+            text: 'HTML5',
+            link: '/h5/'
+          },
+          {
+            text: 'shoppingCart plug-in',
+            link: '/cart/'
+          },
+          {
+            text: 'wechatMiniProgram',
+            link: '/wx/'
+          },
+        ],
+        sidebar: {
+          '/pc/':genSidebar('pc','PC'),
+          '/android/': genSidebar('android','Android'),
+          '/ios/': genSidebar('ios','IOS'),
+          '/h5/': genSidebar('h5','H5'),
+        }
+      },
+      '/zh/': {
+        label: '简体中文',
+        selectText: '选择语言',
+        editLinkText: '在 GitHub 上编辑此页',
+        lastUpdated: '上次更新',
+        nav: [
+          {
+            text: 'PC在线支付',
+            link: '/zh/pc/',
+          },
+          {
+            text: 'Android',
+            link: '/zh/android/'
+          },
+          {
+            text: 'IOS',
+            link: '/zh/ios/'
+          },
+          {
+            text: 'HTML5',
+            link: '/zh/h5/'
+          },
+          {
+            text: 'shoppingCart plug-in',
+            link: '/zh/cart/'
+          },
+          {
+            text: 'wechatMiniProgram',
+            link: '/zh/wx/'
+          },
+        ],
+        sidebar: {
+          '/zh/pc/':genSidebar('pc','PC在线支付'),
+          '/zh/android/': genSidebar('android','Android'),
+          '/zh/ios/': genSidebar('ios','IOS'),
+          '/zh/h5/': genSidebar('h5','H5'),
+        }
+      }
+    }
+  }
+}
+
+
+function genSidebar(name,title) {
+  var child = {
+    pc:[
+      '',
+      '1',
+      '2',
+      '3',
+      '4',
+      '5',
+      '6',
+    ], 
+    android: [
+      '',
+      '1',
+      '2',
+      '3',
+      '4',
+      '5',
+    ],
+    ios: [
+      '',
+      '1',
+      '2',
+      '3',
+      '4',
+      '5',
+    ],
+    h5: [
+      '',
+      '1',
+      '2',
+      '3',
+    ],
+  }
+  return [
+    {
+      title,
+      collapsable: false,
+      children: child[name]
+    }
+  ]
+}

BIN=BIN
docs/.vuepress/public/favicon.ico


BIN=BIN
docs/.vuepress/public/logo.png


+ 26 - 0
docs/README.md

@@ -0,0 +1,26 @@
+---
+home: true
+# heroImage: /hero.png
+actionText: Get Started →
+actionLink: /zh/pc/
+features:
+- title: Intergration Documents for PC
+  details:  Applicable for merchant to integrate UnionPay, Alipay,Tenpay and more cross border online payment.Applicable for Chinese domestic merchant to integrate UnionPay, Alipay, Wechat and credit card payment
+- title: Payment Intergration Documents for IOS
+  details: Applicable for merchant to integrate UnionPay, Alipay Tenpay and more cross border online payment.Applicable for Chinese domestic merchant to integrate UnionPay, Alipay, Wechat and credit card
+- title: Payment Intergration Documents for Android
+  details:  Applicable for overseas merchant to integrate UnionPay, Alipay,Tenpay and more cross border online payment.Applicable for Chinese domestic merchant to integrate UnionPay, Alipay, Wechat and credit card payment
+- title: Payment Intergration Documents for Mobile H5
+  details:  Applicable for merchant to integrate UnionPay, Alipay, Tenpay and more cross border online payment. Applicable for Chinese domestic merchant to integrate UnionPay, Alipay, Wechat and credit card
+- title: Shopping Cart Payment Module Packages
+  details:  Support following shopping carts:PrestaShop、Magento、WooCommerce、OpenCart
+- title: Payment Intergration Documents for Wechat MiniProgram
+  details:  Payment Integration Documents for Wechat MiniProgram
+footer: MIT Licensed | Copyright © 2018 AllPay
+---
+
+# Technical support
+
+::: tip TIP
+If you have problems with debugging, please contact us:support@allpayx.com
+:::

+ 3 - 0
docs/android/1.md

@@ -0,0 +1,3 @@
+# 1.概述
+
+AllPay 为基于移动端 APP 支付的客户提供接入插件(下文简称“SDK”),以帮助客户实 现快速、安全、集中式的接入支付渠道。

+ 3 - 0
docs/android/2.md

@@ -0,0 +1,3 @@
+# 2.交易流程
+
+  ![image](https://git.allpayx.com/OpenAPI/b2c/raw/master/images/moble_sdk_flowsheet.png)

+ 145 - 0
docs/android/3.md

@@ -0,0 +1,145 @@
+# 3.通用API说明
+
+商户服务器和 AllPay 网关对接的通用接口,每个渠道都具有的功能,包括:消费,退款,查询接口。
+
+## 3.1. 验签说明 
+
+1.对于发送到 ALLPAY 系统的 POST 请求报文,其中所有传入参数(除 signature 参数外)按照字段名的 ASCII 码从小到大排序后(字典序),使用 URL 键值对的格式(即 key1=value1&key2=value2...)拼接成字符串 String1。
+
+2.在 String1 最后直接拼接(不需要用“&”连接)双方约定的签名密钥 K1(接入时 ALLPAY 时分配),得到 stringSignTemp 字符串,并对 stringSignTemp 进行 md5 运算,得到 signature 的值。
+
+3.示例签名串 
+```
+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 
+```
+## 3.2. 通用API 接入地址 
+ 交易名称  |开发调试地址|生产交易地址  
+ ------- |-----------|-------
+ 消费接口 |https://testapi.allpayx.com/app/pay |https://api.allpayx.com/app/pay 
+ 查询接口 |https://testapi.allpayx.com/pay |https://api.allpayx.com/pay 
+ 退款接口 |https://testapi.allpayx.com/pay |https://api.allpayx.com/pay 
+
+## 3.3. 消费交易接口
+1. 接口说明
+
+  商户网关将订单信息发送给 ALLPAY 网关,由 ALLPAY 网关进行处理后将交易流水 号,即 tn,返回给商户网关,tn 作为调起手机 app 支付控件的参数。
+   
+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|前端 URL 地址 |400|文本|frontURL  |app 模式默认填"nil" 
+ 8|后端 URL 地址 |400|文本|backURL   |支付结果异步通知到该地址 
+ 9|商户预留字段  |1024 |文本|merReserve    |商户预留内容,可传任意内容,如购买商品信息、员号等,但不要传特殊符号,如逗号。 
+ 10|商户代码   |15 |文本|merID     |商户 ID,由AllPay 分配 
+ 11|收单行 ID    |11  |文本|acqID      |收单行 ID "99020344" 
+ 12|支付渠道代码    |10  |文本|paymentSchema       |支付宝:"APMP"; 微信:"WX"; 境外银联:"UP";  ApplePay 支付:"APP" ;印度本地支付:"EB"
+ 13|商品信息    |60  |文本|goodsInfo       | 商品信息
+ 14|交易时间    |14  |文本|transTime       |交易时间,格式:"yyyyMMddHHmmss" 
+ 15|签名类型     |3  |文本|signType        |MD5 
+ 16|签名      |32  |文本|signature         |采用 MD5 签名 
+ 
+3. 响应报文格式
+
+ 序号 |名称  |长度|类型|参数名称|备注 
+ -----|-----|----|----|------|------
+  1|应答码 |2|文本|code |应答码,00成功 
+  2|错误信息 |32|文本|msg |错误信息
+  3|交易流水号 |32|文本|tn |tn 作为调起 sdk 支付的参数,code等于"00"时返回该字段
+  
+## 3.4. 查询交易接口 
+
+
+ 
+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       |支付宝:"APMP"; 微信:"WX"; 境外银联:"UP";  ApplePay 支付:"APP" ;印度本地支付:"EB"
+ 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.5. 退款交易接口
+
+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       |支付宝:"APMP"; 微信:"WX"; 境外银联:"UP";  ApplePay 支付:"APP" ;印度本地支付:"EB"
+ 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 签名 
+ 

+ 105 - 0
docs/android/4.md

@@ -0,0 +1,105 @@
+# 4.ANDROID 客户端接入步骤 
+
+## 4.1. 接入说明 
+
+```
+启动支付控件的接口,接口定义如下:
+
+public static void pay(Activity activity,String tn,boolean mode)
+ 
+参数说明:
+
+activity —— 用于启动支付控件的活动对象
+
+tn——订单信息为交易流水号,即 TN,为商户后台从 AllPay 后台获取
+
+mode ——AllPay 后台环境标识,true 将在 AllPay 正式环境发起交易,false 将在 AllPay 测试环 境发起交易 
+
+```
+
+## 4.2. 添加 SDK 包 
+```
+1. 把allpaysdk当做Module导入到自己的工程
+2. 在Application Module的build.gradle文件的dependencies下添加compile project(':allpaysdk') 
+3. 在Application Module的build.gradle文件中添加
+repositories {
+
    flatDir {
+    
        dirs project(':allpaysdk').file('libs')
+        
    }
+    
}
+
+
+```
+
+
+
+## 4.3. 调用支付控件 
+```
+接着可以通过以下方式调用支付控件:
+//tn——交易流水号,即 TN,为商户后台从 AllPay 后台获取,获取方式参见 AllPay 网关对接文档
+AllPayEngine.Pay(ShopCartActivity.this, tn,false);//false 测试环境 
+```
+## 4.4. 同步结果通知 
+
+ ```
+ 支付完成后,获取支付控件支付结果,并添加相应处理逻辑,只需实现调用 Activity 
+中的 onActivityResult()方法即可,实例代码如下: 
+
+@Overrideprotected void onActivityResult(int requestCode, int resultCode, Intent data) 
+{ 
+if (data == null) { 
+return; 
+} 
+
+if (requestCode == AllPayConst.VTPAY_PAY_REQUESR_CODE&& resultCode == AllPayConst.VTPAY_PAY_RESULT_CODE) { 
+String result = data.getExtras().getString("pay_result"); } 
+} 
+
+pay_result,为 json 字符串,格式如下:
+ { 
+"state": "cancel",
+"paymentSchema": "UP", 
+"orderNum": "604337497032", 
+"errorDetail": "user cancel operation " 
+} 
+
+报文说明: 
+
+state: "success"代表成功, "cancel"代表用户取消操作,"fail"代表失败,"query"代表 app 需要调用查询接口来确认订单状态 
+paymentSchema:支付渠道, "APMP"代表支付宝, "WX"代表微信 
+orderNum:订单号
+errorDetail:错误详情 
+ ```
+
+
+## 4.5. 异步结果通知
+
+商户需要提供一个 http 协议的接口,包含在参数里传递给 SDK,即 backURL。AllPay 
+服务器在支付完成后,会以 Get 方式调用 backURL,通知支付结果。 
+
+参数如下表: 
+
+
+ 序号 |名称  |长度|类型|参数名称|备注 
+ -----|-----|----|----|------|------
+ 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       |支付宝:"APMP"; 微信:"WX"; 境外银联:"UP";  ApplePay 支付:"APP" ;印度本地支付:"EB"
+ 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 签名 
+ 

+ 14 - 0
docs/android/5.md

@@ -0,0 +1,14 @@
+# 5.渠道专属配置
+
+## 5.1 EB渠道
+
+* 消费接口专属字段
+	* 请求报文
+	
+	 序号 |名称  |长度|类型|参数名称|备注 
+ -----|-----|----|----|------|------
+  1| 姓名     |32  |文本|trxn_firstname         |This is name of the customer who is doing the transaction. 
+  2| 邮箱     |40  |文本|trxn_email_id         |this is email id of the customer who is doing transaction.
+  3|电话 |20  |文本|trxn_phone|Phone number of the customer.
+  4|优惠券选项 |1  |文本|trxn_is_coupon_enabled| If the value is 0 then customer will not be able to see the coupons. If the value is 1 then customer will be able see the coupons and able to select the coupons
+  5|客户id |10  |文本|unique_id|This is customer’s unique id.不能超过10位

+ 6 - 0
docs/android/README.md

@@ -0,0 +1,6 @@
+# Android端控件支付产品接口规范文档4.0.0
+
+[上海偶可贝网络科技有限公司](https://www.allpayx.com)
+
+* 版本信息:中文 V4.0.0
+* 更新时间:2018 年4 月

+ 5 - 0
docs/cart/README.md

@@ -0,0 +1,5 @@
+# PC Web Integration Specification V4.2.1
+[Shanghai AllPay Technology Co., Ltd.](https://www.allpayx.com)
+
+* Version:English V4.2.1
+* Update Time:April 2018

+ 3 - 0
docs/h5/1.md

@@ -0,0 +1,3 @@
+# 1.Overview
+
+AllPay provides customers with unified API access to help them implement fast, secure and centralized access payment channels.

+ 3 - 0
docs/h5/2.md

@@ -0,0 +1,3 @@
+# 2.General API specification
+
+Common interface between merchant server and AllPay gateway, each channel has functions including: Purchase, Refund, Inqiury interface.

+ 161 - 0
docs/h5/3.md

@@ -0,0 +1,161 @@
+# 3.General API specification
+
+Common interface between merchant server and AllPay gateway, each channel has functions including: Purchase, Refund, Inqiury interface.
+
+## 3.1. 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.
+
+2.At the end of String1, the signature key K1(assigned at ALLPAY upon access) agreed by both parties is spliced directly (no need to connect with "&"), resulting in a stringSignTemp string, and an md5 operation on stringSignTemp to get the value of signature.
+
+3.Sample signature string:
+
+```
+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 
+```
+
+## 3.2. General API access address
+
+ Transaction Type  |Test Address|Production Address  
+ ------- |-----------|-------
+ Purchase |https://testapi.allpayx.com/pay/v1 |https://api.allpayx.com/pay/v1 
+ Inqiury |https://testapi.allpayx.com/pay/v1 |https://api.allpayx.com/pay/v1 
+ Refund |https://testapi.allpayx.com/pay/v1 |https://api.allpayx.com/pay/v1 
+ 
+## 3.3. Purchase interface
+
+1. Request message format
+ 
+	This field is a list of common fields, sending, every channel needs some channel channel exclusive field, specific fields please go to the channel's exclusive canal to the fields that view. Consumer interface is divided into jump transformation and parameters return type, default to jump transformation, parameters return type will be explained in chapter 4 channels (exclusive) inside.
+
+ No. |Field Name  |Max.Length|Type|Parameter Name|Comment 
+ -----|-----|----|----|------|------
+ 1|Message Version|12|Text|version |"VER000000002" 
+ 2|Character set coding |6|Text|charSet  |"UTF-8" 
+ 3|Transaction type  |4|Text|transType |"PURC" 
+ 4|Order Number   |60|Text|orderNum  |The merchant shall define it by itself, and the order number of the same merchant number shall not be repeated 
+ 5|Order Amount |12|Text|orderAmount   |100 is displayed as 100 or 100.00 
+ 6|Order Currency   |3|Text|orderCurrency |Fill in "CNY" in RMB and "USD" in USD 
+ 7|Frontend URL Address |400|Text|frontURL  |Payment results are notified to this address front 
+ 8|Backend URL Address |400|Text|backURL   |Payment results are notified to this address asynchronously 
+ 9|Merchant Reserved  |1024 |Text|merReserve    |Merchant reserved content, can pass any content, such as purchase information, account number, etc., but do not pass special symbols, such as commas. 
+ 10|Merchant ID   |15 |Text|merID     |Merchant ID, assigned by AllPay 
+ 11|Acquirer ID    |11  |Text|acqID      |"99020344" 
+ 12|Payment Channel Code    |10  |Text|paymentSchema|Payment Channel Code:[Click here for details](https://git.allpayx.com/OpenAPI/b2c/src/master/pc_api/paymentSchema.md)
+ 13|Goods Information    |60  |Text|goodsInfo       |Goods Information
+ 14|Transaction Time    |14  |Text|transTime       |Transaction time, format :" yyymmddhhmmss" 
+ 15|Signature Type     |3  |Text|signType        |MD5 
+ 16|Signature Data      |32  |Text|signature         |MD5 signature 
+ 
+2. Jump transformation Purchase interface response message
+
+	The merchant needs to provide an HTTP/HTTPS protocol interface that is included in the parameters passed to the SDK, the backURL. After the payment is complete, the AllPay server will call the backURL as a Get, informing the payment result. 
+
+The parameters are as follows: 
+
+ No. |Field Name  |Max.Length|Type|Parameter name|Comment 
+ -----|-----|----|----|------|------
+ 1|Message Version|12|Text|version |"VER000000002" 
+ 2|Character set coding |6|Text|charSet  |"UTF-8" 
+ 3|Transaction type  |4|Text|transType |"PURC" 
+ 4|Order Number   |60|Text|orderNum  |The merchant shall define it by itself, and the order number of the same merchant number shall not be repeated 
+ 5|Order Amount |12|Text|orderAmount   |100 is displayed as 100 or 100.00 
+ 6|Order Currency   |3|Text|orderCurrency |Fill in "CNY" in RMB and "USD" in USD 
+ 7|Settlement Amount  |12 |Text|settAmount   |100 is displayed as 100 or 100.00  
+ 8|Settlement Currency  |3|Text|settCurrency    |Comply with ISO standards and fill in the number type 
+ 9|Settlement FX Rate   |7|Text|rate     |Real exchange rate, 7 digits  
+ 10|Merchant Reserved  |1024 |Text|merReserve    |Merchant reserved content, can pass any content, such as purchase information, account number, etc., but do not pass special symbols, such as commas. 
+ 11|Gateway Transaction ID  |32|Text|transID    |The unique transaction id generated by the gateway.
+ 12|Merchant ID   |15 |Text|merID     |Merchant ID, assigned by AllPay 
+ 13|Acquirer ID    |11  |Text|acqID      |"99020344" 
+ 14|Payment Channel Code    |10  |Text|paymentSchema|Payment Channel Code:[Click here for details](https://git.allpayx.com/OpenAPI/b2c_pc_payment/src/master/paymentSchema.md)
+ 15|Response Code   |2  |Text|RespCode       |00 stands for success; 01 stands for fail.  
+ 16|Response Message    |20  |Text|RespMsg        |Response message, all English characters 
+ 17|Transaction Time    |14  |Text|transTime       |Transaction time, format :" yyymmddhhmmss" 
+ 18|Gateway process time |14  |Text|GWTime |YYYYMMDDHHMMSS this should be a GWtime, currently is local transaction time
+ 19|Signature Type     |3  |Text|signType        |MD5 
+ 20|Signature Data      |32  |Text|signature         |MD5 signature 
+
+## 3.4. Inqiury interface 
+ 
+1. Interface specification
+ 
+ This interface provides the function of inqiury transaction for access merchants.
+
+2. Request message format 
+
+ No. |Field Name  |Max.Length|Type|Parameter name|Comment 
+ -----|-----|----|----|------|------
+ 1|Message Version|12|Text|version |"VER000000002" 
+ 2|Character set coding |6|Text|charSet  |"UTF-8" 
+ 3|Transaction type  |4|Text|transType |"INQY"  
+ 4|Order Number   |60|Text|orderNum  |The merchant shall define it by itself, and the order number of the same merchant number shall not be repeated 
+ 5|Merchant Reserved  |1024 |Text|merReserve    |Merchant reserved content 
+ 6|Merchant ID   |15 |Text|merID     |Merchant ID, assigned by AllPay 
+ 7|Acquirer ID    |11  |Text|acqID      |"99020344" 
+ 8|Payment Channel Code    |10  |Text|paymentSchema|Payment Channel Code:[Click here for details](https://git.allpayx.com/OpenAPI/b2c_pc_payment/src/master/paymentSchema.md)
+ 9|Transaction Time    |14  |Text|transTime       |Transaction time, format :" yyymmddhhmmss" 
+ 10|Signature Type     |3  |Text|signType        |MD5 
+ 11|Signature Data      |32  |Text|signature         |MD5 signature 
+
+3. Response message format
+
+  No. |Field Name  |Max.Length|Type|Parameter name|Comment 
+ -----|-----|----|----|------|------
+ 1|Message Version|12|Text|version |"VER000000002" 
+ 2|Character set coding |6|Text|charSet  |"UTF-8" 
+ 3|Transaction type  |4|Text|transType |"INQY" 
+ 4|Order Number   |60|Text|orderNum  |The merchant shall define it by itself, and the order number of the same merchant number shall not be repeated 
+ 5|Gateway Transaction ID  |32|Text|transID    |The unique transaction id generated by the gateway.  
+ 6|Merchant ID   |15 |Text|merID     |Merchant ID, assigned by AllPay 
+ 7|Acquirer ID    |11  |Text|acqID      |"99020344" 
+ 8|Response Code   |2  |Text|RespCode       |00 stands for success; 01 stands for fail.  
+ 9|Response Message    |20  |Text|RespMsg        |Response message, all English characters 
+ 10|Transaction Time    |14  |Text|transTime       |Transaction time, format :" yyymmddhhmmss" 
+ 11|Gateway process time |14  |Text|GWTime |YYYYMMDDHHMMSS this should be a GWtime, currently is local transaction time 
+ 12|Signature Type     |3  |Text|signType        |MD5 
+ 13|Signature Data      |32  |Text|signature         |MD5 signature 
+
+## 3.5. Refund interface
+
+1.Interface specification 
+
+This interface provides the function of refund transaction for access merchants. 
+
+2.Request message format 
+
+  No. |Field Name  |Max.Length|Type|Parameter name|Comment 
+ -----|-----|----|----|------|------
+ 1|Message Version|12|Text|version |"VER000000002" 
+ 2|Character set coding |6|Text|charSet  |"UTF-8" 
+ 3|Transaction type  |4|Text|transType |"REFD" 
+ 4|Order Number   |60|Text|orderNum  |The merchant shall define it by itself, and the order number of the same merchant number shall not be repeated 
+ 5|Return Amount  |12|Text|returnAmount    |100 is displayed as 100 or 100.00 
+ 6|Order Currency   |3|Text|orderCurrency |Fill in "CNY" in RMB and "USD" in USD 
+ 7|Merchant Reserved  |1024 |Text|merReserve    |Merchant reserved content, can pass any content, such as purchase information, account number, etc., but do not pass special symbols, such as commas. 
+ 8|Merchant ID   |15 |Text|merID     |Merchant ID, assigned by AllPay 
+ 9|Acquirer ID    |11  |Text|acqID      |"99020344" 
+ 10|Payment Channel Code    |10  |Text|paymentSchema|Payment Channel Code:[Click here for details](https://git.allpayx.com/OpenAPI/b2c_pc_payment/src/master/paymentSchema.md)
+ 11|Transaction Time    |14  |Text|transTime       |Transaction time, format :" yyymmddhhmmss" 
+ 12|Signature Type     |3  |Text|signType        |MD5 
+ 13|Signature Data      |32  |Text|signature         |MD5 signature 
+ 
+3.Response message format
+  
+  No. |Field Name  |Max.Length|Type|Parameter name|Comment 
+ -----|-----|----|----|------|------
+ 1|Message Version|12|Text|version |"VER000000002" 
+ 2|Character set coding |6|Text|charSet  |"UTF-8" 
+ 3|Transaction type  |4|Text|transType |"REFD" 
+ 4|Order Number   |60|Text|orderNum  |The merchant shall define it by itself, and the order number of the same merchant number shall not be repeated 
+ 5|Gateway Transaction ID  |32|Text|transID    |The unique transaction id generated by the gateway.  
+ 6|Merchant ID   |15 |Text|merID     |Merchant ID, assigned by AllPay 
+ 7|Acquirer ID    |11  |Text|acqID      |"99020344" 
+ 8|Response Code   |2  |Text|RespCode       |00 stands for success; 01 stands for fail.  
+ 9|Response Message    |20  |Text|RespMsg        |Response message, all English characters 
+ 10|Transaction Time    |14  |Text|transTime       |Transaction time, format :" yyymmddhhmmss" 
+ 11|Gateway process time |14  |Text|GWTime |YYYYMMDDHHMMSS this should be a GWtime, currently is local transaction time 
+ 12|Signature Type     |3  |Text|signType        |MD5 
+ 13|Signature Data      |32  |Text|signature         |MD5 signature 
+ 

+ 5 - 0
docs/h5/README.md

@@ -0,0 +1,5 @@
+# HTML5 Integration Specification V4.2.1
+[Shanghai AllPay Technology Co., Ltd.](https://www.allpayx.com)
+
+* Version:English V4.2.0
+* Update Time:April 2018

+ 3 - 0
docs/ios/1.md

@@ -0,0 +1,3 @@
+# 1.概述
+
+AllPay 为基于移动端 APP 支付的客户提供接入插件(下文简称“SDK”),以帮助客户实 现快速、安全、集中式的接入支付渠道。

+ 3 - 0
docs/ios/2.md

@@ -0,0 +1,3 @@
+# 2.交易流程
+
+  ![image](https://git.allpayx.com/OpenAPI/b2c/raw/master/images/moble_sdk_flowsheet.png)

+ 145 - 0
docs/ios/3.md

@@ -0,0 +1,145 @@
+# 3.通用API说明
+
+商户服务器和 AllPay 网关对接的通用接口,每个渠道都具有的功能,包括:消费,退款,查询接口。
+
+## 3.1. 验签说明 
+
+1.对于发送到 ALLPAY 系统的 POST 请求报文,其中所有传入参数(除 signature 参数外)按照字段名的 ASCII 码从小到大排序后(字典序),使用 URL 键值对的格式(即 key1=value1&key2=value2...)拼接成字符串 String1。
+
+2.在 String1 最后直接拼接(不需要用“&”连接)双方约定的签名密钥 K1(接入时 ALLPAY 时分配),得到 stringSignTemp 字符串,并对 stringSignTemp 进行 md5 运算,得到 signature 的值。
+
+3.示例签名串 
+```
+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 
+```
+## 3.2. 通用API 接入地址 
+ 交易名称  |开发调试地址|生产交易地址  
+ ------- |-----------|-------
+ 消费接口 |https://testapi.allpayx.com/app/pay |https://api.allpayx.com/app/pay 
+ 查询接口 |https://testapi.allpayx.com/pay |https://api.allpayx.com/pay 
+ 退款接口 |https://testapi.allpayx.com/pay |https://api.allpayx.com/pay 
+
+## 3.3. 消费交易接口
+1. 接口说明
+
+  商户网关将订单信息发送给 ALLPAY 网关,由 ALLPAY 网关进行处理后将交易流水 号,即 tn,返回给商户网关,tn 作为调起手机 app 支付控件的参数。
+   
+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|前端 URL 地址 |400|文本|frontURL  |app 模式默认填"nil" 
+ 8|后端 URL 地址 |400|文本|backURL   |支付结果异步通知到该地址 
+ 9|商户预留字段  |1024 |文本|merReserve    |商户预留内容,可传任意内容,如购买商品信息、员号等,但不要传特殊符号,如逗号。 
+ 10|商户代码   |15 |文本|merID     |商户 ID,由AllPay 分配 
+ 11|收单行 ID    |11  |文本|acqID      |收单行 ID "99020344" 
+ 12|支付渠道代码    |10  |文本|paymentSchema       |支付宝:"APMP"; 微信:"WX"; 境外银联:"UP";  ApplePay 支付:"APP" ;印度本地支付:"EB"
+ 13|商品信息    |60  |文本|goodsInfo       | 商品信息
+ 14|交易时间    |14  |文本|transTime       |交易时间,格式:"yyyyMMddHHmmss" 
+ 15|签名类型     |3  |文本|signType        |MD5 
+ 16|签名      |32  |文本|signature         |采用 MD5 签名 
+ 
+3. 响应报文格式
+
+ 序号 |名称  |长度|类型|参数名称|备注 
+ -----|-----|----|----|------|------
+  1|应答码 |2|文本|code |应答码,00成功 
+  2|错误信息 |32|文本|msg |错误信息
+  3|交易流水号 |32|文本|tn |tn 作为调起 sdk 支付的参数,code等于"00"时返回该字段
+  
+## 3.4. 查询交易接口 
+
+
+ 
+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       |支付宝:"APMP"; 微信:"WX"; 境外银联:"UP";  ApplePay 支付:"APP" ;印度本地支付:"EB"
+ 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.5. 退款交易接口
+
+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       |支付宝:"APMP"; 微信:"WX"; 境外银联:"UP";  ApplePay 支付:"APP" ;印度本地支付:"EB"
+ 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 签名 
+ 

+ 100 - 0
docs/ios/4.md

@@ -0,0 +1,100 @@
+# 4.iOS 客户端接入步骤 
+
+## 4.1. 接入说明 
+
+```
+启动支付控件的接口,接口定义如下:
+
+[AllPaySDK pay:[diction objectForKey:@"tn"] mode:NO scheme:@"com.xxx.xxx" ViewController:self onResult: ^(NSDictionary *resultDic) { 
+
+//此处处理同步支付结果 
+
+}]; 
+tn:是从服务器端获取的流水号; mode:测试环境:NO; 
+生产环境:YES。 
+Scheme: 可以为任意值推荐填写成"com.xxx.xxx" 等形式, 有特殊配置的渠道会在渠道专属配置里面说明
+ViewController:调用 SDK 时的 ViewController; 
+onResult:接收同步结果通知 
+
+```
+## 4.2. 添加 SDK 包 
+```
+1. 将  allpaysdk 下的 AllPaySDK.h,libAllPaySDK.a文件add到项目中
+2. 在 APPDelegate.m 类中导入头文件: 
+
+#import "allpaysdk/AllPaySDK.h" 并添加如下方法 
+
+-(BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation{ 
+
+[AllPaySDK openURL:url]; return YES; 
+
+}
+
+-(BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url{ 
+
+[AllPaySDK openURL:url]; return YES; 
+
+} 
+
+-(BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<NSString *,id> *)options{ 
+
+[AllPaySDK openURL:url]; return YES; 
+
+} 
+
+3. 根据要使用的渠道的专属配置,对项目进行配置
+
+```
+
+
+## 4.3 同步结果通知 
+```
+
+[AllPaySDK pay:[diction objectForKey:@"tn"] mode:NO scheme:@"com.xxx.xxx" ViewController:self onResult: ^(NSDictionary *resultDic) { 
+
+//此处处理同步支付结果
+ }]; 
+resultDic,转为 json 字符串,格式如下: 
+
+{"state": "cancel",
+"paymentSchema": "YL", 
+"orderNum": "604337497032",
+ "errorDetail": "user cancel operation " 
+} 
+- state: "success"代表成功, "cancel"代表用户取消操作, "fail"代表失败
+- paymentSchema:支付渠道, 印度本地支付:"EB", "APMP"代表支付宝,  "WX"代表微信,"APP"代表ApplePay
+- orderNum:订单号
+- errorDetail:错误详情  
+```
+
+
+## 4.5. 异步结果通知
+
+商户需要提供一个 http 协议的接口,包含在参数里传递给 SDK,即 backURL。AllPay 
+服务器在支付完成后,会以 Get 方式调用 backURL,通知支付结果。 
+
+参数如下表: 
+
+
+ 序号 |名称  |长度|类型|参数名称|备注 
+ -----|-----|----|----|------|------
+ 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       |支付宝:"APMP"; 微信:"WX"; 境外银联:"UP";  ApplePay 支付:"APP" ;印度本地支付:"EB"
+ 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 签名 

+ 29 - 0
docs/ios/5.md

@@ -0,0 +1,29 @@
+# 5.渠道专属配置
+## 5.1 EB渠道
+* 渠道专属配置:
+  1.将allpaysdk/EBModule文件夹下的文件add到项目中
+  
+  2.Set Always embed swift standard libraries to YES from project build settings 
+  ```
+  ALWAYS_EMBED_SWIFT_STANDARD_LIBRARIES
+  ```
+
+  3.To simply disable ATS, you can follow this steps by open Info.plist, and add 	the following lines:
+ 
+ ```
+    <key>NSAppTransportSecurity</key>
+    <dict> <key>NSAllowsArbitraryLoads</key>
+        <true/>
+    </dict>
+```
+* 消费接口专属字段
+	* 请求报文
+	
+	 序号 |名称  |长度|类型|参数名称|备注 
+ -----|-----|----|----|------|------
+  1| 姓名     |32  |文本|trxn_firstname         |This is name of the customer who is doing the transaction. 
+  2| 邮箱     |40  |文本|trxn_email_id         |this is email id of the customer who is doing transaction.
+  3|电话 |20  |文本|trxn_phone|Phone number of the customer.
+  4|优惠券选项 |1  |文本|trxn_is_coupon_enabled| If the value is 0 then customer will not be able to see the coupons. If the value is 1 then customer will be able see the coupons and able to select the coupons
+  5|客户id |10  |文本|unique_id|This is customer’s unique id.不能超过10位
+ 

+ 6 - 0
docs/ios/README.md

@@ -0,0 +1,6 @@
+# iOS端控件支付产品接口规范文档4.0.0
+
+[上海偶可贝网络科技有限公司](https://www.allpayx.com)
+
+* 版本信息:中文 V4.0.0
+* 更新时间:2018 年4 月

+ 3 - 0
docs/pc/1.md

@@ -0,0 +1,3 @@
+# 1.Overview
+
+AllPay provides customers with unified API access to help them implement fast, secure and centralized access payment channels.

+ 3 - 0
docs/pc/2.md

@@ -0,0 +1,3 @@
+# 2.Transaction process
+
+![image](https://git.allpayx.com/OpenAPI/b2c/raw/master/images/pc_flowsheet.png)

+ 161 - 0
docs/pc/3.md

@@ -0,0 +1,161 @@
+# 3.General API specification
+
+Common interface between merchant server and AllPay gateway, each channel has functions including: Purchase, Refund, Inqiury interface.
+
+## 3.1. 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.
+
+2.At the end of String1, the signature key K1(assigned at ALLPAY upon access) agreed by both parties is spliced directly (no need to connect with "&"), resulting in a stringSignTemp string, and an md5 operation on stringSignTemp to get the value of signature.
+
+3.Sample signature string:
+
+```
+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 
+```
+
+## 3.2. General API access address
+
+ Transaction Type  |Test Address|Production Address  
+ ------- |-----------|-------
+ Purchase |https://testapi.allpayx.com/pay/v1 |https://api.allpayx.com/pay/v1 
+ Inqiury |https://testapi.allpayx.com/pay/v1 |https://api.allpayx.com/pay/v1 
+ Refund |https://testapi.allpayx.com/pay/v1 |https://api.allpayx.com/pay/v1 
+ 
+## 3.3. Purchase interface
+
+1. Request message format
+ 
+	This field is a list of common fields, sending, every channel needs some channel channel exclusive field, specific fields please go to the channel's exclusive canal to the fields that view. Consumer interface is divided into jump transformation and parameters return type, default to jump transformation, parameters return type will be explained in chapter 4 channels (exclusive) inside.
+
+ No. |Field Name  |Max.Length|Type|Parameter Name|Comment 
+ -----|-----|----|----|------|------
+ 1|Message Version|12|Text|version |"VER000000002" 
+ 2|Character set coding |6|Text|charSet  |"UTF-8" 
+ 3|Transaction type  |4|Text|transType |"PURC" 
+ 4|Order Number   |60|Text|orderNum  |The merchant shall define it by itself, and the order number of the same merchant number shall not be repeated 
+ 5|Order Amount |12|Text|orderAmount   |100 is displayed as 100 or 100.00 
+ 6|Order Currency   |3|Text|orderCurrency |Fill in "CNY" in RMB and "USD" in USD 
+ 7|Frontend URL Address |400|Text|frontURL  |Payment results are notified to this address front 
+ 8|Backend URL Address |400|Text|backURL   |Payment results are notified to this address asynchronously 
+ 9|Merchant Reserved  |1024 |Text|merReserve    |Merchant reserved content, can pass any content, such as purchase information, account number, etc., but do not pass special symbols, such as commas. 
+ 10|Merchant ID   |15 |Text|merID     |Merchant ID, assigned by AllPay 
+ 11|Acquirer ID    |11  |Text|acqID      |"99020344" 
+ 12|Payment Channel Code    |10  |Text|paymentSchema|Payment Channel Code:[Click here for details](https://git.allpayx.com/OpenAPI/b2c/src/master/pc_api/paymentSchema.md)
+ 13|Goods Information    |60  |Text|goodsInfo       |Goods Information
+ 14|Transaction Time    |14  |Text|transTime       |Transaction time, format :" yyymmddhhmmss" 
+ 15|Signature Type     |3  |Text|signType        |MD5 
+ 16|Signature Data      |32  |Text|signature         |MD5 signature 
+ 
+2. Jump transformation Purchase interface response message
+
+	The merchant needs to provide an HTTP/HTTPS protocol interface that is included in the parameters passed to the SDK, the backURL. After the payment is complete, the AllPay server will call the backURL as a Get, informing the payment result. 
+
+The parameters are as follows: 
+
+ No. |Field Name  |Max.Length|Type|Parameter name|Comment 
+ -----|-----|----|----|------|------
+ 1|Message Version|12|Text|version |"VER000000002" 
+ 2|Character set coding |6|Text|charSet  |"UTF-8" 
+ 3|Transaction type  |4|Text|transType |"PURC" 
+ 4|Order Number   |60|Text|orderNum  |The merchant shall define it by itself, and the order number of the same merchant number shall not be repeated 
+ 5|Order Amount |12|Text|orderAmount   |100 is displayed as 100 or 100.00 
+ 6|Order Currency   |3|Text|orderCurrency |Fill in "CNY" in RMB and "USD" in USD 
+ 7|Settlement Amount  |12 |Text|settAmount   |100 is displayed as 100 or 100.00  
+ 8|Settlement Currency  |3|Text|settCurrency    |Comply with ISO standards and fill in the number type 
+ 9|Settlement FX Rate   |7|Text|rate     |Real exchange rate, 7 digits  
+ 10|Merchant Reserved  |1024 |Text|merReserve    |Merchant reserved content, can pass any content, such as purchase information, account number, etc., but do not pass special symbols, such as commas. 
+ 11|Gateway Transaction ID  |32|Text|transID    |The unique transaction id generated by the gateway.
+ 12|Merchant ID   |15 |Text|merID     |Merchant ID, assigned by AllPay 
+ 13|Acquirer ID    |11  |Text|acqID      |"99020344" 
+ 14|Payment Channel Code    |10  |Text|paymentSchema|Payment Channel Code:[Click here for details](https://git.allpayx.com/OpenAPI/b2c_pc_payment/src/master/paymentSchema.md)
+ 15|Response Code   |2  |Text|RespCode       |00 stands for success; 01 stands for fail.  
+ 16|Response Message    |20  |Text|RespMsg        |Response message, all English characters 
+ 17|Transaction Time    |14  |Text|transTime       |Transaction time, format :" yyymmddhhmmss" 
+ 18|Gateway process time |14  |Text|GWTime |YYYYMMDDHHMMSS this should be a GWtime, currently is local transaction time
+ 19|Signature Type     |3  |Text|signType        |MD5 
+ 20|Signature Data      |32  |Text|signature         |MD5 signature 
+
+## 3.4. Inqiury interface 
+ 
+1. Interface specification
+ 
+ This interface provides the function of inqiury transaction for access merchants.
+
+2. Request message format 
+
+ No. |Field Name  |Max.Length|Type|Parameter name|Comment 
+ -----|-----|----|----|------|------
+ 1|Message Version|12|Text|version |"VER000000002" 
+ 2|Character set coding |6|Text|charSet  |"UTF-8" 
+ 3|Transaction type  |4|Text|transType |"INQY"  
+ 4|Order Number   |60|Text|orderNum  |The merchant shall define it by itself, and the order number of the same merchant number shall not be repeated 
+ 5|Merchant Reserved  |1024 |Text|merReserve    |Merchant reserved content 
+ 6|Merchant ID   |15 |Text|merID     |Merchant ID, assigned by AllPay 
+ 7|Acquirer ID    |11  |Text|acqID      |"99020344" 
+ 8|Payment Channel Code    |10  |Text|paymentSchema|Payment Channel Code:[Click here for details](https://git.allpayx.com/OpenAPI/b2c_pc_payment/src/master/paymentSchema.md)
+ 9|Transaction Time    |14  |Text|transTime       |Transaction time, format :" yyymmddhhmmss" 
+ 10|Signature Type     |3  |Text|signType        |MD5 
+ 11|Signature Data      |32  |Text|signature         |MD5 signature 
+
+3. Response message format
+
+  No. |Field Name  |Max.Length|Type|Parameter name|Comment 
+ -----|-----|----|----|------|------
+ 1|Message Version|12|Text|version |"VER000000002" 
+ 2|Character set coding |6|Text|charSet  |"UTF-8" 
+ 3|Transaction type  |4|Text|transType |"INQY" 
+ 4|Order Number   |60|Text|orderNum  |The merchant shall define it by itself, and the order number of the same merchant number shall not be repeated 
+ 5|Gateway Transaction ID  |32|Text|transID    |The unique transaction id generated by the gateway.  
+ 6|Merchant ID   |15 |Text|merID     |Merchant ID, assigned by AllPay 
+ 7|Acquirer ID    |11  |Text|acqID      |"99020344" 
+ 8|Response Code   |2  |Text|RespCode       |00 stands for success; 01 stands for fail.  
+ 9|Response Message    |20  |Text|RespMsg        |Response message, all English characters 
+ 10|Transaction Time    |14  |Text|transTime       |Transaction time, format :" yyymmddhhmmss" 
+ 11|Gateway process time |14  |Text|GWTime |YYYYMMDDHHMMSS this should be a GWtime, currently is local transaction time 
+ 12|Signature Type     |3  |Text|signType        |MD5 
+ 13|Signature Data      |32  |Text|signature         |MD5 signature 
+
+## 3.5. Refund interface
+
+1.Interface specification 
+
+This interface provides the function of refund transaction for access merchants. 
+
+2.Request message format 
+
+  No. |Field Name  |Max.Length|Type|Parameter name|Comment 
+ -----|-----|----|----|------|------
+ 1|Message Version|12|Text|version |"VER000000002" 
+ 2|Character set coding |6|Text|charSet  |"UTF-8" 
+ 3|Transaction type  |4|Text|transType |"REFD" 
+ 4|Order Number   |60|Text|orderNum  |The merchant shall define it by itself, and the order number of the same merchant number shall not be repeated 
+ 5|Return Amount  |12|Text|returnAmount    |100 is displayed as 100 or 100.00 
+ 6|Order Currency   |3|Text|orderCurrency |Fill in "CNY" in RMB and "USD" in USD 
+ 7|Merchant Reserved  |1024 |Text|merReserve    |Merchant reserved content, can pass any content, such as purchase information, account number, etc., but do not pass special symbols, such as commas. 
+ 8|Merchant ID   |15 |Text|merID     |Merchant ID, assigned by AllPay 
+ 9|Acquirer ID    |11  |Text|acqID      |"99020344" 
+ 10|Payment Channel Code    |10  |Text|paymentSchema|Payment Channel Code:[Click here for details](https://git.allpayx.com/OpenAPI/b2c_pc_payment/src/master/paymentSchema.md)
+ 11|Transaction Time    |14  |Text|transTime       |Transaction time, format :" yyymmddhhmmss" 
+ 12|Signature Type     |3  |Text|signType        |MD5 
+ 13|Signature Data      |32  |Text|signature         |MD5 signature 
+ 
+3.Response message format
+  
+  No. |Field Name  |Max.Length|Type|Parameter name|Comment 
+ -----|-----|----|----|------|------
+ 1|Message Version|12|Text|version |"VER000000002" 
+ 2|Character set coding |6|Text|charSet  |"UTF-8" 
+ 3|Transaction type  |4|Text|transType |"REFD" 
+ 4|Order Number   |60|Text|orderNum  |The merchant shall define it by itself, and the order number of the same merchant number shall not be repeated 
+ 5|Gateway Transaction ID  |32|Text|transID    |The unique transaction id generated by the gateway.  
+ 6|Merchant ID   |15 |Text|merID     |Merchant ID, assigned by AllPay 
+ 7|Acquirer ID    |11  |Text|acqID      |"99020344" 
+ 8|Response Code   |2  |Text|RespCode       |00 stands for success; 01 stands for fail.  
+ 9|Response Message    |20  |Text|RespMsg        |Response message, all English characters 
+ 10|Transaction Time    |14  |Text|transTime       |Transaction time, format :" yyymmddhhmmss" 
+ 11|Gateway process time |14  |Text|GWTime |YYYYMMDDHHMMSS this should be a GWtime, currently is local transaction time 
+ 12|Signature Type     |3  |Text|signType        |MD5 
+ 13|Signature Data      |32  |Text|signature         |MD5 signature 
+ 

+ 380 - 0
docs/pc/4.md

@@ -0,0 +1,380 @@
+# 4.Channel exclusive allocation
+## 4.1 EB(Transition)
+
+
+No. |Field Name  |Max.Length|Type|Parameter name|Comment 
+ -----|-----|----|----|------|------
+  1| Name     |32  |Text|trxn_firstname         |This is name of the customer who is doing the transaction. 
+  2| Email     |40  |Text|trxn_email_id         |this is email id of the customer who is doing transaction.
+  3|Phone |20  |Text|trxn_phone|Phone number of the customer.
+  
+## 4.2 UP(Transition)
+
+No. |Field Name  |Max.Length|Type|Parameter name|Comment 
+ -----|-----|----|----|------|------
+  1| UnionPay card number |19  | Text|uCardNumber |The overseas UnionPay channel is applicable to the UnionPay excellent plan. Can not upload, if you need to fill in the bank card number in advance, then send this field.
+  
+## 4.3 WX(Includes transition and parameter return)
+
+ No. |Field Name  |Max.Length|Type|Parameter name|Comment 
+ -----|-----|----|----|------|------
+  1| Transaction scenario code|16  | Text|code |1.“NATIVE“:Return 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; 2.“QUICK”:It's jump mode, open the front-end page provided by AllPay, which contains WeChat QR code.
+
+## 4.4 PPRO(Transition)
+## 4.4.1 PPRO_AC
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |Text |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |Text |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+consumerref |M   |Text |Unique reference identifying the consumer, has to satisfy the regular expression [A-Za-z0-9.%,&/+*$-]{1,20} 
+
+Note: AstroPay Card is available for currency USD and country codes BO, BR, CL, CN, CO, CR, MX, PE, UY, VE. 
+     
+###### 4.4.2 PPRO_AD
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |Text |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |Text |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+consumerref |M   |Text |Unique reference identifying the consumer, has to satisfy the regular expression [A-Za-z0-9.%,&/+*$-]{1,20} 
+
+Note: AstroPay Direct is available for currency USD and country codes AR, BR, CL, CN, CO, MX, PE, UY. 
+
+
+###### 4.4.3 PPRO_AR
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |Text |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |Text |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+consumerref |M   |Text |Unique reference identifying the consumer, has to satisfy the regular expression [A-Za-z0-9.%,&/+*$-]{1,20} 
+nationalid  |M   |Text |Consumer’s national id (up to 30 characters) 
+email   |M   |Text |RFC compliant email address of the account holder 
+dob    |O   |Text |Date of birth, format YYYYMMDD 
+
+Note: Aura (Brazil) is available for currency USD and country code BR. 
+
+
+###### 4.4.4 PPRO_BA
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |Text |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |Text |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+consumerref |M   |Text |Unique reference identifying the consumer, has to satisfy the regular expression [A-Za-z0-9.%,&/+*$-]{1,20} 
+nationalid  |M   |Text |Consumer’s national id (up to 30 characters) 
+email   |M   |Text |RFC compliant email address of the account holder 
+dob    |O   |Text |Date of birth, format YYYYMMDD 
+
+Note: Baloto Cash (Colombia) is available for currency USD and country code CO. 
+
+
+###### 4.4.5 PPRO_BB
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |Text |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |Text |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+consumerref |M   |Text |Unique reference identifying the consumer, has to satisfy the regular expression [A-Za-z0-9.%,&/+*$-]{1,20} 
+nationalid  |M   |Text |Consumer’s national id (up to 30 characters) 
+email   |M   |Text |RFC compliant email address of the account holder 
+dob    |O   |Text |Date of birth, format YYYYMMDD 
+
+Note: Banco do Brasil (Brazil) is available for currency USD and country code BR. 
+
+
+###### 4.4.6 PPRO_BO
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |Text |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |Text |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+consumerref |M   |Text |Unique reference identifying the consumer, has to satisfy the regular expression [A-Za-z0-9.%,&/+*$-]{1,20} 
+nationalid  |M   |Text |Consumer’s national id (up to 30 characters) 
+email   |M   |Text |RFC compliant email address of the account holder 
+dob    |O   |Text |Date of birth, format YYYYMMDD 
+
+Note: Boleto Bancario is available for currency USD and country code BR. 
+
+
+
+###### 4.4.7 PPRO_CC
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |Text |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |Text |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+consumerref |M   |Text |Unique reference identifying the consumer, has to satisfy the regular expression [A-Za-z0-9.%,&/+*$-]{1,20} 
+nationalid  |M   |Text |Consumer’s national id (up to 30 characters) 
+email   |M   |Text |RFC compliant email address of the account holder 
+dob    |O   |Text |Date of birth, format YYYYMMDD 
+
+Note: Cartao MercadoLivre (Brazil) is available for currency USD and country code BR. 
+
+###### 4.4.8 PPRO_DR
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |Text |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |Text |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+email   |M   |Text |RFC compliant email address of the account holder 
+phone  |M  |Text |Valid international phone number of the account holder 
+
+Note: Dragonpay is only available for currency PHP and country code PH. 
+
+
+
+###### 4.4.9 PPRO_EN
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |Text |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |Text |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+email   |M   |Text |RFC compliant email address of the account holder 
+phone  |M  |Text |Valid international phone number of the account holder 
+
+Note: eNETS is only available for currency SGD and country code SG. 
+
+###### 4.4.10 PPRO_EP
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |Text |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |Text |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+
+Note: eps only works for the countrycode “AT” and currency “EUR”. 
+
+###### 4.4.11 PPRO_GP
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |Text |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |Text |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+bic |O  |Text |Valid BIC (8 or 11 alphanumeric letters) of consumer’s bank 
+
+
+###### 4.4.12 PPRO_HC
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |Text |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |Text |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+consumerref |M   |Text |Unique reference identifying the consumer, has to satisfy the regular expression [A-Za-z0-9.%,&/+*$-]{1,20} 
+nationalid  |M   |Text |Consumer’s national id (up to 30 characters) 
+email   |M   |Text |RFC compliant email address of the account holder 
+dob    |O   |Text |Date of birth, format YYYYMMDD 
+
+Note: Hipercard (Brazil) is available for currency USD and country code BR. 
+
+###### 4.4.13 PPRO_ID
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |Text |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |Text |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+
+Note: iDEAL only works for the countrycode “NL” and currency “EUR”. 
+
+###### 4.4.14 PPRO_IT
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |Text |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |Text |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+consumerref |M   |Text |Unique reference identifying the consumer, has to satisfy the regular expression [A-Za-z0-9.%,&/+*$-]{1,20} 
+nationalid  |M   |Text |Consumer’s national id (up to 30 characters) 
+email   |M   |Text |RFC compliant email address of the account holder 
+dob    |O   |Text |Date of birth, format YYYYMMDD 
+
+Note: Itaú (Brazil) is available for currency USD and country code BR.
+
+###### 4.4.15 PPRO_MB
+
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |Text |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |Text |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+
+Note: MyBank only works for the country code IT and currency EUR. 
+
+
+###### 4.4.16 PPRO_PC
+
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |Text |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |Text |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+consumerref |M   |Text |Unique reference identifying the consumer, has to satisfy the regular expression [A-Za-z0-9.%,&/+*$-]{1,20} 
+
+
+
+###### 4.4.17 PPRO_PB
+
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |Text |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |Text |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+email   |M   |Text |RFC compliant email address of the account holder 
+phone  |M  |Text |Valid international phone number of the account holder 
+
+Note: PAYSBUY Cash is only available for currency THB and country code TH. 
+
+
+
+###### 4.4.18 PPRO_PU
+
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |Text |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |Text |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+email   |M   |Text |RFC compliant email address of the account holder 
+
+Note: PayU works only for country code/currency combinations CZ/CZK and PL/PLN. 
+
+###### 4.4.19 PPRO_PL
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |Text |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |Text |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+
+Note: POLi only works for the countrycode/currency combinations “NZ”/”NZD” and “AU/AUD”. 
+
+###### 4.4.20 PPRO_P24
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |Text |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |Text |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+email   |M   |Text |RFC compliant email address of the account holder 
+
+Note: Przelewy24 only works for the countrycode “PL” and currencies “PLN” and “EUR”. 
+
+
+###### 4.4.21 PPRO_QW
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |Text |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |Text |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+mobilephone|M   |Text |Valid international Russian mobile phone number identifying the QIWI destination account to pay out to (excluding plus sign or any other international prefixes, including a leading 7 for Russia, 11 digits in total, e.g. 71234567890). 
+
+
+Note:	QIWI Payout only works for the countrycodes “RU”, “KZ” and UA, and - depending on your contract - currency 
“RUB” , “EUR” ,”KZT” and “USD”. 

+###### 4.4.22 PPRO_SP
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |Text |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |Text |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+
+Note: SafetyPay only works for country codes “AT”, “BR”, “CO”, “CR”, “DE”, “ES”, “MX”, “NI”, “NL”, “PA”, “PE” and currencies “EUR”, “USD”. 
+
+###### 4.4.23 PPRO_SD
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |Text |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |Text |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+
+
+Note: SEPA Direct Debit works for all SEPA countries and currency EUR. 
+
+
+###### 4.4.24 PPRO_SG
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |Text |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |Text |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+email   |M   |Text |RFC compliant email address of the account holder 
+phone  |M  |Text |Valid international phone number of the account holder 
+
+Note: SingPost (Singapore) is only available for currency SGD and country code SG. 
+
+###### 4.4.25 PPRO_SK
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |Text |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |Text |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+email   |O  |Text |RFC compliant email address of the account holder 
+address   |O  |Text |Consumer’s address (e.g. street) 
+zipcode    |O  |Text |Consumer’s postal code 
+city     |O  |Text |Consumer’s city 
+
+###### 4.4.26 PPRO_DP
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |Text |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |Text |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+bic |O  |Text |Valid BIC (8 or 11 alphanumeric letters) of consumer’s bank 
+
+
+###### 4.4.27 PPRO_TP
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |Text |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |Text |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+
+TrustPay works for the following country code/currency combinations: 
+
+
+CZ 
+CZK, EUR 
+
+
+SK 
+EUR 
+
+
+The currencies available to you may depend on your contract. 
+
+
+###### 4.4.28 PPRO_WP
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |Text |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |Text |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+consumerref |M   |Text |Unique reference identifying the consumer, has to satisfy the regular expression [A-Za-z0-9.%,&/+*$-]{1,20} 
+nationalid  |M   |Text |Consumer’s national id (up to 30 characters) 
+email   |M   |Text |RFC compliant email address of the account holder 
+dob    |O   |Text |Date of birth, format YYYYMMDD 
+
+Note: WebPay is available for currency USD and country code CL.

+ 22 - 0
docs/pc/5.md

@@ -0,0 +1,22 @@
+# 5.Test account
+ 
+ Please note that AliPay and TenPay transactions need to be tested with Chinese real-name certified accounts. All test transactions do not provide liquidation services. Please use a small amount of test.
+
+The following are the UnionPay channel test cards for testing only: 
+ 
+```
+Credit Card:5200831111111113 
+Mobile:13552535506
+CVN2:123
+Exp Date:month 11 year 19
+SMS Code on PC:111111 
+SMS Code on Mobile:123456
+
+Credit Card:6226388000000095 
+Mobile:18100000000 
+CVN2:248
+Exp Date:month 12 year 19
+SMS Code on PC:111111 
+SMS Code on Mobile:123456 
+ 
+```

+ 17 - 0
docs/pc/6.md

@@ -0,0 +1,17 @@
+# 6. error code 
+
+| 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  

+ 5 - 0
docs/pc/README.md

@@ -0,0 +1,5 @@
+# PC Web Integration Specification V4.2.1
+[Shanghai AllPay Technology Co., Ltd.](https://www.allpayx.com)
+
+* Version:English V4.2.1
+* Update Time:April 2018

+ 14 - 0
docs/wx/README.md

@@ -0,0 +1,14 @@
+# 微信小程序支付接入规范文档4.2.1
+
+[上海偶可贝网络科技有限公司](https://www.allpayx.com)
+
+* 版本信息:中文 V4.2.1
+* 更新时间:2018 年6 月
+
+## 1.概述
+
+AllPay为基于微信小程序开发的接口,以帮助客户实现快速、安全、集中式的接入支付渠道。 
+
+## 2.通用API说明
+
+商户服务器和 AllPay 网关对接的通用接口,每个渠道都具有的功能,包括:消费,退款,查询接口。

+ 26 - 0
docs/zh/README.md

@@ -0,0 +1,26 @@
+---
+home: true
+# heroImage: /hero.png
+actionText: 快速上手 →
+actionLink: /pc/
+features:
+- title: PC在线支付接入文档
+  details: 适用于境外企业接入银联、支付宝、财付通跨境支付,适用于境内企业接入银联、支付宝、微信、国际信用卡支付
+- title: IOS支付接入文档
+  details: 适用于境外企业接入银联、支付宝跨境支付,适用于境内企业接入银联、支付宝、微信、国际信用卡支付
+- title: Android支付接入文档
+  details: 适用于境外企业接入银联、支付宝跨境支付,适用于境内企业接入银联、支付宝、微信、国际信用卡支付
+- title: H5页面支付接入文档
+  details: 适用于境外企业接入银联、支付宝、财付通跨境支付,适用于境外企业接入银联、支付宝、财付通跨境支付
+- title: 开源商城接入文档
+  details: 适用于境外企业接入银联、支付宝、财付通跨境支付,PrestaShop、Magento、WooCommerce、OpenCart
+- title: 微信小程序支付接入文档
+  details: 微信小程序支付接入规范文档
+footer: MIT Licensed | Copyright © 2018 AllPay
+---
+
+# 技术支持
+
+::: tip 提示
+如果您在调试时遇到问题,请我们联系:support@allpayx.com。
+:::

+ 3 - 0
docs/zh/android/1.md

@@ -0,0 +1,3 @@
+# 1.概述
+
+AllPay 为基于移动端 APP 支付的客户提供接入插件(下文简称“SDK”),以帮助客户实 现快速、安全、集中式的接入支付渠道。

+ 3 - 0
docs/zh/android/2.md

@@ -0,0 +1,3 @@
+# 2.交易流程
+
+  ![image](https://git.allpayx.com/OpenAPI/b2c/raw/master/images/moble_sdk_flowsheet.png)

+ 145 - 0
docs/zh/android/3.md

@@ -0,0 +1,145 @@
+# 3.通用API说明
+
+商户服务器和 AllPay 网关对接的通用接口,每个渠道都具有的功能,包括:消费,退款,查询接口。
+
+## 3.1. 验签说明 
+
+1.对于发送到 ALLPAY 系统的 POST 请求报文,其中所有传入参数(除 signature 参数外)按照字段名的 ASCII 码从小到大排序后(字典序),使用 URL 键值对的格式(即 key1=value1&key2=value2...)拼接成字符串 String1。
+
+2.在 String1 最后直接拼接(不需要用“&”连接)双方约定的签名密钥 K1(接入时 ALLPAY 时分配),得到 stringSignTemp 字符串,并对 stringSignTemp 进行 md5 运算,得到 signature 的值。
+
+3.示例签名串 
+```
+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 
+```
+## 3.2. 通用API 接入地址 
+ 交易名称  |开发调试地址|生产交易地址  
+ ------- |-----------|-------
+ 消费接口 |https://testapi.allpayx.com/app/pay |https://api.allpayx.com/app/pay 
+ 查询接口 |https://testapi.allpayx.com/pay |https://api.allpayx.com/pay 
+ 退款接口 |https://testapi.allpayx.com/pay |https://api.allpayx.com/pay 
+
+## 3.3. 消费交易接口
+1. 接口说明
+
+  商户网关将订单信息发送给 ALLPAY 网关,由 ALLPAY 网关进行处理后将交易流水 号,即 tn,返回给商户网关,tn 作为调起手机 app 支付控件的参数。
+   
+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|前端 URL 地址 |400|文本|frontURL  |app 模式默认填"nil" 
+ 8|后端 URL 地址 |400|文本|backURL   |支付结果异步通知到该地址 
+ 9|商户预留字段  |1024 |文本|merReserve    |商户预留内容,可传任意内容,如购买商品信息、员号等,但不要传特殊符号,如逗号。 
+ 10|商户代码   |15 |文本|merID     |商户 ID,由AllPay 分配 
+ 11|收单行 ID    |11  |文本|acqID      |收单行 ID "99020344" 
+ 12|支付渠道代码    |10  |文本|paymentSchema       |支付宝:"APMP"; 微信:"WX"; 境外银联:"UP";  ApplePay 支付:"APP" ;印度本地支付:"EB"
+ 13|商品信息    |60  |文本|goodsInfo       | 商品信息
+ 14|交易时间    |14  |文本|transTime       |交易时间,格式:"yyyyMMddHHmmss" 
+ 15|签名类型     |3  |文本|signType        |MD5 
+ 16|签名      |32  |文本|signature         |采用 MD5 签名 
+ 
+3. 响应报文格式
+
+ 序号 |名称  |长度|类型|参数名称|备注 
+ -----|-----|----|----|------|------
+  1|应答码 |2|文本|code |应答码,00成功 
+  2|错误信息 |32|文本|msg |错误信息
+  3|交易流水号 |32|文本|tn |tn 作为调起 sdk 支付的参数,code等于"00"时返回该字段
+  
+## 3.4. 查询交易接口 
+
+
+ 
+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       |支付宝:"APMP"; 微信:"WX"; 境外银联:"UP";  ApplePay 支付:"APP" ;印度本地支付:"EB"
+ 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.5. 退款交易接口
+
+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       |支付宝:"APMP"; 微信:"WX"; 境外银联:"UP";  ApplePay 支付:"APP" ;印度本地支付:"EB"
+ 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 签名 
+ 

+ 105 - 0
docs/zh/android/4.md

@@ -0,0 +1,105 @@
+# 4.ANDROID 客户端接入步骤 
+
+## 4.1. 接入说明 
+
+```
+启动支付控件的接口,接口定义如下:
+
+public static void pay(Activity activity,String tn,boolean mode)
+ 
+参数说明:
+
+activity —— 用于启动支付控件的活动对象
+
+tn——订单信息为交易流水号,即 TN,为商户后台从 AllPay 后台获取
+
+mode ——AllPay 后台环境标识,true 将在 AllPay 正式环境发起交易,false 将在 AllPay 测试环 境发起交易 
+
+```
+
+## 4.2. 添加 SDK 包 
+```
+1. 把allpaysdk当做Module导入到自己的工程
+2. 在Application Module的build.gradle文件的dependencies下添加compile project(':allpaysdk') 
+3. 在Application Module的build.gradle文件中添加
+repositories {
+
    flatDir {
+    
        dirs project(':allpaysdk').file('libs')
+        
    }
+    
}
+
+
+```
+
+
+
+## 4.3. 调用支付控件 
+```
+接着可以通过以下方式调用支付控件:
+//tn——交易流水号,即 TN,为商户后台从 AllPay 后台获取,获取方式参见 AllPay 网关对接文档
+AllPayEngine.Pay(ShopCartActivity.this, tn,false);//false 测试环境 
+```
+## 4.4. 同步结果通知 
+
+ ```
+ 支付完成后,获取支付控件支付结果,并添加相应处理逻辑,只需实现调用 Activity 
+中的 onActivityResult()方法即可,实例代码如下: 
+
+@Overrideprotected void onActivityResult(int requestCode, int resultCode, Intent data) 
+{ 
+if (data == null) { 
+return; 
+} 
+
+if (requestCode == AllPayConst.VTPAY_PAY_REQUESR_CODE&& resultCode == AllPayConst.VTPAY_PAY_RESULT_CODE) { 
+String result = data.getExtras().getString("pay_result"); } 
+} 
+
+pay_result,为 json 字符串,格式如下:
+ { 
+"state": "cancel",
+"paymentSchema": "UP", 
+"orderNum": "604337497032", 
+"errorDetail": "user cancel operation " 
+} 
+
+报文说明: 
+
+state: "success"代表成功, "cancel"代表用户取消操作,"fail"代表失败,"query"代表 app 需要调用查询接口来确认订单状态 
+paymentSchema:支付渠道, "APMP"代表支付宝, "WX"代表微信 
+orderNum:订单号
+errorDetail:错误详情 
+ ```
+
+
+## 4.5. 异步结果通知
+
+商户需要提供一个 http 协议的接口,包含在参数里传递给 SDK,即 backURL。AllPay 
+服务器在支付完成后,会以 Get 方式调用 backURL,通知支付结果。 
+
+参数如下表: 
+
+
+ 序号 |名称  |长度|类型|参数名称|备注 
+ -----|-----|----|----|------|------
+ 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       |支付宝:"APMP"; 微信:"WX"; 境外银联:"UP";  ApplePay 支付:"APP" ;印度本地支付:"EB"
+ 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 签名 
+ 

+ 14 - 0
docs/zh/android/5.md

@@ -0,0 +1,14 @@
+# 5.渠道专属配置
+
+## 5.1 EB渠道
+
+* 消费接口专属字段
+	* 请求报文
+	
+	 序号 |名称  |长度|类型|参数名称|备注 
+ -----|-----|----|----|------|------
+  1| 姓名     |32  |文本|trxn_firstname         |This is name of the customer who is doing the transaction. 
+  2| 邮箱     |40  |文本|trxn_email_id         |this is email id of the customer who is doing transaction.
+  3|电话 |20  |文本|trxn_phone|Phone number of the customer.
+  4|优惠券选项 |1  |文本|trxn_is_coupon_enabled| If the value is 0 then customer will not be able to see the coupons. If the value is 1 then customer will be able see the coupons and able to select the coupons
+  5|客户id |10  |文本|unique_id|This is customer’s unique id.不能超过10位

+ 6 - 0
docs/zh/android/README.md

@@ -0,0 +1,6 @@
+# Android端控件支付产品接口规范文档4.0.0
+
+[上海偶可贝网络科技有限公司](https://www.allpayx.com)
+
+* 版本信息:中文 V4.0.0
+* 更新时间:2018 年4 月

+ 26 - 0
docs/zh/cart/README.md

@@ -0,0 +1,26 @@
+# 开源商城支付插件
+
+## 1.PreteShop
+### 1.1 [PrestaShop_UnionPay.zip](https://git.allpayx.com/OpenAPI/b2c_shoppingCart_plug-in/src/master/PrestaShop_UnionPay.zip)
+
+### 1.2 [PrestaShop_AliPay.zip](https://git.allpayx.com/OpenAPI/b2c_shoppingCart_plug-in/src/master/PrestaShop_AliPay.zip)
+
+### 1.3 [PrestaShop_TenPay.zip](https://git.allpayx.com/OpenAPI/b2c_shoppingCart_plug-in/src/master/PrestaShop_TenPay.zip)
+## 2.Magento
+### 2.1 [Magento_UnionPay.zip](https://git.allpayx.com/OpenAPI/b2c_shoppingCart_plug-in/src/master/Magento_UnionPay.rar)
+### 2.2 [Magento_AliPay.zip](https://git.allpayx.com/OpenAPI/b2c_shoppingCart_plug-in/src/master/Magento_AliPay.rar)
+### 2.3 [Magento_Tenpay.zip](https://git.allpayx.com/OpenAPI/b2c_shoppingCart_plug-in/src/master/Magento_Tenpay.rar)
+
+## 3.OpenCart
+### 3.1 [OpenCart_UnionPay.zip](https://git.allpayx.com/OpenAPI/b2c_shoppingCart_plug-in/src/master/OpenCart_UnionPay.zip)
+
+### 3.2 [OpenCart_AliPay.zip](https://git.allpayx.com/OpenAPI/b2c_shoppingCart_plug-in/src/master/OpenCart_AliPay.zip)
+
+### 3.3 [OpenCart_TenPay.zip](https://git.allpayx.com/OpenAPI/b2c_shoppingCart_plug-in/src/master/OpenCart_TenPay.zip)
+
+## 4.WordPress_WooCommerce
+### 4.1 [WordPress_WooCommerce_UnionPay.zip](https://git.allpayx.com/OpenAPI/b2c_shoppingCart_plug-in/src/master/WordPress_WooCommerce_Unionpay.zip)
+
+### 4.2 [WordPress_WooCommerce_AliPay.zip](https://git.allpayx.com/OpenAPI/b2c_shoppingCart_plug-in/src/master/WordPress_WooCommerce_Alipay.zip)
+
+### 4.3 [WordPress_WooCommerce_TenPay.zip](https://git.allpayx.com/OpenAPI/b2c_shoppingCart_plug-in/src/master/WordPress_WooCommerce_Tenpay.zip)

+ 3 - 0
docs/zh/h5/1.md

@@ -0,0 +1,3 @@
+# 1.概述
+
+AllPay 为客户提供统一的api接入,以帮助客户实 现快速、安全、集中式的接入支付渠道。

+ 2 - 0
docs/zh/h5/2.md

@@ -0,0 +1,2 @@
+#### 2.交易流程 
+![image](https://git.allpayx.com/OpenAPI/b2c/raw/master/images/pc_flowsheet.png)

+ 167 - 0
docs/zh/h5/3.md

@@ -0,0 +1,167 @@
+# 3.通用API说明
+
+商户服务器和 AllPay 网关对接的通用接口,每个渠道都具有的功能,包括:消费,退款,查询接口。 
+
+## 3.1. 验签说明
+
+
+
+1.对于发送到 ALLPAY 系统的 POST 请求报文,其中所有传入参数(除 signature 参数外)按照字段名的 ASCII 码从小到大排序后(字典序),使用 URL 键值对的格式(即 key1=value1&key2=value2...)拼接成字符串 String1。
+
+2.在 String1 最后直接拼接(不需要用“&”连接)双方约定的签名密钥 K1(接入时 ALLPAY 时分配),得到 stringSignTemp 字符串,并对 stringSignTemp 进行 md5 运算,得到 signature 的值。
+
+3.示例签名串
+```
+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 
+```
+## 3.2. 通用API 接入地址 
+ 交易名称  |开发调试地址|生产交易地址  
+ ------- |-----------|-------
+ 消费接口 |https://testapi.allpayx.com/pay/v1 |https://api.allpayx.com/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 
+
+                            
+
+## 3.3. 消费交易接口
+
+1. 请求报文格式
+
+	下面列举的字段为通用字段,每个渠道都需要上送,部分渠道有渠道专属字段,具体字段请到该渠道的专属渠到字段说明处查看. 消费接口分为跳转型和参数返回型,默认为跳转型,参数返回型会在 第4章(渠道专属配置)里面说明
+
+ 序号 |名称  |长度|类型|参数名称|备注 
+ -----|-----|----|----|------|------
+ 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|前端 URL 地址 |400|文本|frontURL  |支付结果前端通知到该地址 
+ 8|后端 URL 地址 |400|文本|backURL   |支付结果异步通知到该地址 
+ 9|商户预留字段  |1024 |文本|merReserve    |商户预留内容,可传任意内容,如购买商品信息、员号等,但不要传特殊符号,如逗号。 
+ 10|商户代码   |15 |文本|merID     |商户 ID,由AllPay 分配 
+ 11|收单行 ID    |11  |文本|acqID      |收单行 ID "99020344" 
+ 12|支付渠道代码    |10  |文本|paymentSchema|渠道代码:[点击查看详情](https://git.allpayx.com/OpenAPI/b2c_pc_payment/src/master/paymentSchema.md)
+ 13|商品信息    |60  |文本|goodsInfo       | 商品信息
+ 14|交易时间    |14  |文本|transTime       |交易时间,格式:"yyyyMMddHHmmss" 
+ 15|签名类型     |3  |文本|signType        |MD5 
+ 16|签名      |32  |文本|signature         |采用 MD5 签名 
+
+
+2. 跳转型消费接口响应报文
+
+	商户需要提供一个 http/https 协议的接口,包含在参数里传递给 SDK,即 backURL。AllPay 
+服务器在支付完成后,会以 Get 方式调用 backURL,通知支付结果。 
+
+参数如下表: 
+
+
+ 序号 |名称  |长度|类型|参数名称|备注 
+ -----|-----|----|----|------|------
+ 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|渠道代码:[点击查看详情](https://git.allpayx.com/OpenAPI/b2c_pc_payment/src/master/paymentSchema.md)
+ 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.4. 查询交易接口 
+
+
+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|渠道代码:[点击查看详情](https://git.allpayx.com/OpenAPI/b2c_pc_payment/src/master/paymentSchema.md)
+ 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.5. 退款交易接口
+
+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|渠道代码:[点击查看详情](https://git.allpayx.com/OpenAPI/b2c_pc_payment/src/master/paymentSchema.md)
+ 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 签名 

+ 6 - 0
docs/zh/h5/README.md

@@ -0,0 +1,6 @@
+# 移动端H5页面支付接入规范文档V4.2.1
+
+[上海偶可贝网络科技有限公司](https://www.allpayx.com)
+
+* 版本信息:中文 V4.0.0
+* 更新时间:2018 年4 月

+ 3 - 0
docs/zh/ios/1.md

@@ -0,0 +1,3 @@
+# 1.概述
+
+AllPay 为基于移动端 APP 支付的客户提供接入插件(下文简称“SDK”),以帮助客户实 现快速、安全、集中式的接入支付渠道。

+ 3 - 0
docs/zh/ios/2.md

@@ -0,0 +1,3 @@
+# 2.交易流程
+
+  ![image](https://git.allpayx.com/OpenAPI/b2c/raw/master/images/moble_sdk_flowsheet.png)

+ 145 - 0
docs/zh/ios/3.md

@@ -0,0 +1,145 @@
+# 3.通用API说明
+
+商户服务器和 AllPay 网关对接的通用接口,每个渠道都具有的功能,包括:消费,退款,查询接口。
+
+## 3.1. 验签说明 
+
+1.对于发送到 ALLPAY 系统的 POST 请求报文,其中所有传入参数(除 signature 参数外)按照字段名的 ASCII 码从小到大排序后(字典序),使用 URL 键值对的格式(即 key1=value1&key2=value2...)拼接成字符串 String1。
+
+2.在 String1 最后直接拼接(不需要用“&”连接)双方约定的签名密钥 K1(接入时 ALLPAY 时分配),得到 stringSignTemp 字符串,并对 stringSignTemp 进行 md5 运算,得到 signature 的值。
+
+3.示例签名串 
+```
+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 
+```
+## 3.2. 通用API 接入地址 
+ 交易名称  |开发调试地址|生产交易地址  
+ ------- |-----------|-------
+ 消费接口 |https://testapi.allpayx.com/app/pay |https://api.allpayx.com/app/pay 
+ 查询接口 |https://testapi.allpayx.com/pay |https://api.allpayx.com/pay 
+ 退款接口 |https://testapi.allpayx.com/pay |https://api.allpayx.com/pay 
+
+## 3.3. 消费交易接口
+1. 接口说明
+
+  商户网关将订单信息发送给 ALLPAY 网关,由 ALLPAY 网关进行处理后将交易流水 号,即 tn,返回给商户网关,tn 作为调起手机 app 支付控件的参数。
+   
+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|前端 URL 地址 |400|文本|frontURL  |app 模式默认填"nil" 
+ 8|后端 URL 地址 |400|文本|backURL   |支付结果异步通知到该地址 
+ 9|商户预留字段  |1024 |文本|merReserve    |商户预留内容,可传任意内容,如购买商品信息、员号等,但不要传特殊符号,如逗号。 
+ 10|商户代码   |15 |文本|merID     |商户 ID,由AllPay 分配 
+ 11|收单行 ID    |11  |文本|acqID      |收单行 ID "99020344" 
+ 12|支付渠道代码    |10  |文本|paymentSchema       |支付宝:"APMP"; 微信:"WX"; 境外银联:"UP";  ApplePay 支付:"APP" ;印度本地支付:"EB"
+ 13|商品信息    |60  |文本|goodsInfo       | 商品信息
+ 14|交易时间    |14  |文本|transTime       |交易时间,格式:"yyyyMMddHHmmss" 
+ 15|签名类型     |3  |文本|signType        |MD5 
+ 16|签名      |32  |文本|signature         |采用 MD5 签名 
+ 
+3. 响应报文格式
+
+ 序号 |名称  |长度|类型|参数名称|备注 
+ -----|-----|----|----|------|------
+  1|应答码 |2|文本|code |应答码,00成功 
+  2|错误信息 |32|文本|msg |错误信息
+  3|交易流水号 |32|文本|tn |tn 作为调起 sdk 支付的参数,code等于"00"时返回该字段
+  
+## 3.4. 查询交易接口 
+
+
+ 
+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       |支付宝:"APMP"; 微信:"WX"; 境外银联:"UP";  ApplePay 支付:"APP" ;印度本地支付:"EB"
+ 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.5. 退款交易接口
+
+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       |支付宝:"APMP"; 微信:"WX"; 境外银联:"UP";  ApplePay 支付:"APP" ;印度本地支付:"EB"
+ 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 签名 
+ 

+ 100 - 0
docs/zh/ios/4.md

@@ -0,0 +1,100 @@
+# 4.iOS 客户端接入步骤 
+
+## 4.1. 接入说明 
+
+```
+启动支付控件的接口,接口定义如下:
+
+[AllPaySDK pay:[diction objectForKey:@"tn"] mode:NO scheme:@"com.xxx.xxx" ViewController:self onResult: ^(NSDictionary *resultDic) { 
+
+//此处处理同步支付结果 
+
+}]; 
+tn:是从服务器端获取的流水号; mode:测试环境:NO; 
+生产环境:YES。 
+Scheme: 可以为任意值推荐填写成"com.xxx.xxx" 等形式, 有特殊配置的渠道会在渠道专属配置里面说明
+ViewController:调用 SDK 时的 ViewController; 
+onResult:接收同步结果通知 
+
+```
+## 4.2. 添加 SDK 包 
+```
+1. 将  allpaysdk 下的 AllPaySDK.h,libAllPaySDK.a文件add到项目中
+2. 在 APPDelegate.m 类中导入头文件: 
+
+#import "allpaysdk/AllPaySDK.h" 并添加如下方法 
+
+-(BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation{ 
+
+[AllPaySDK openURL:url]; return YES; 
+
+}
+
+-(BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url{ 
+
+[AllPaySDK openURL:url]; return YES; 
+
+} 
+
+-(BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<NSString *,id> *)options{ 
+
+[AllPaySDK openURL:url]; return YES; 
+
+} 
+
+3. 根据要使用的渠道的专属配置,对项目进行配置
+
+```
+
+
+## 4.3 同步结果通知 
+```
+
+[AllPaySDK pay:[diction objectForKey:@"tn"] mode:NO scheme:@"com.xxx.xxx" ViewController:self onResult: ^(NSDictionary *resultDic) { 
+
+//此处处理同步支付结果
+ }]; 
+resultDic,转为 json 字符串,格式如下: 
+
+{"state": "cancel",
+"paymentSchema": "YL", 
+"orderNum": "604337497032",
+ "errorDetail": "user cancel operation " 
+} 
+- state: "success"代表成功, "cancel"代表用户取消操作, "fail"代表失败
+- paymentSchema:支付渠道, 印度本地支付:"EB", "APMP"代表支付宝,  "WX"代表微信,"APP"代表ApplePay
+- orderNum:订单号
+- errorDetail:错误详情  
+```
+
+
+## 4.5. 异步结果通知
+
+商户需要提供一个 http 协议的接口,包含在参数里传递给 SDK,即 backURL。AllPay 
+服务器在支付完成后,会以 Get 方式调用 backURL,通知支付结果。 
+
+参数如下表: 
+
+
+ 序号 |名称  |长度|类型|参数名称|备注 
+ -----|-----|----|----|------|------
+ 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       |支付宝:"APMP"; 微信:"WX"; 境外银联:"UP";  ApplePay 支付:"APP" ;印度本地支付:"EB"
+ 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 签名 

+ 29 - 0
docs/zh/ios/5.md

@@ -0,0 +1,29 @@
+# 5.渠道专属配置
+## 5.1 EB渠道
+* 渠道专属配置:
+  1.将allpaysdk/EBModule文件夹下的文件add到项目中
+  
+  2.Set Always embed swift standard libraries to YES from project build settings 
+  ```
+  ALWAYS_EMBED_SWIFT_STANDARD_LIBRARIES
+  ```
+
+  3.To simply disable ATS, you can follow this steps by open Info.plist, and add 	the following lines:
+ 
+ ```
+    <key>NSAppTransportSecurity</key>
+    <dict> <key>NSAllowsArbitraryLoads</key>
+        <true/>
+    </dict>
+```
+* 消费接口专属字段
+	* 请求报文
+	
+	 序号 |名称  |长度|类型|参数名称|备注 
+ -----|-----|----|----|------|------
+  1| 姓名     |32  |文本|trxn_firstname         |This is name of the customer who is doing the transaction. 
+  2| 邮箱     |40  |文本|trxn_email_id         |this is email id of the customer who is doing transaction.
+  3|电话 |20  |文本|trxn_phone|Phone number of the customer.
+  4|优惠券选项 |1  |文本|trxn_is_coupon_enabled| If the value is 0 then customer will not be able to see the coupons. If the value is 1 then customer will be able see the coupons and able to select the coupons
+  5|客户id |10  |文本|unique_id|This is customer’s unique id.不能超过10位
+ 

+ 6 - 0
docs/zh/ios/README.md

@@ -0,0 +1,6 @@
+# iOS端控件支付产品接口规范文档4.0.0
+
+[上海偶可贝网络科技有限公司](https://www.allpayx.com)
+
+* 版本信息:中文 V4.0.0
+* 更新时间:2018 年4 月

+ 3 - 0
docs/zh/pc/1.md

@@ -0,0 +1,3 @@
+# 1.概述
+
+AllPay 为客户提供统一的api接入,以帮助客户实 现快速、安全、集中式的接入支付渠道。

+ 2 - 0
docs/zh/pc/2.md

@@ -0,0 +1,2 @@
+#### 2.交易流程 
+![image](https://git.allpayx.com/OpenAPI/b2c/raw/master/images/pc_flowsheet.png)

+ 167 - 0
docs/zh/pc/3.md

@@ -0,0 +1,167 @@
+# 3.通用API说明
+
+商户服务器和 AllPay 网关对接的通用接口,每个渠道都具有的功能,包括:消费,退款,查询接口。 
+
+## 3.1. 验签说明
+
+
+
+1.对于发送到 ALLPAY 系统的 POST 请求报文,其中所有传入参数(除 signature 参数外)按照字段名的 ASCII 码从小到大排序后(字典序),使用 URL 键值对的格式(即 key1=value1&key2=value2...)拼接成字符串 String1。
+
+2.在 String1 最后直接拼接(不需要用“&”连接)双方约定的签名密钥 K1(接入时 ALLPAY 时分配),得到 stringSignTemp 字符串,并对 stringSignTemp 进行 md5 运算,得到 signature 的值。
+
+3.示例签名串
+```
+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 
+```
+## 3.2. 通用API 接入地址 
+ 交易名称  |开发调试地址|生产交易地址  
+ ------- |-----------|-------
+ 消费接口 |https://testapi.allpayx.com/pay/v1 |https://api.allpayx.com/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 
+
+                            
+
+## 3.3. 消费交易接口
+
+1. 请求报文格式
+
+	下面列举的字段为通用字段,每个渠道都需要上送,部分渠道有渠道专属字段,具体字段请到该渠道的专属渠到字段说明处查看. 消费接口分为跳转型和参数返回型,默认为跳转型,参数返回型会在 第4章(渠道专属配置)里面说明
+
+ 序号 |名称  |长度|类型|参数名称|备注 
+ -----|-----|----|----|------|------
+ 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|前端 URL 地址 |400|文本|frontURL  |支付结果前端通知到该地址 
+ 8|后端 URL 地址 |400|文本|backURL   |支付结果异步通知到该地址 
+ 9|商户预留字段  |1024 |文本|merReserve    |商户预留内容,可传任意内容,如购买商品信息、员号等,但不要传特殊符号,如逗号。 
+ 10|商户代码   |15 |文本|merID     |商户 ID,由AllPay 分配 
+ 11|收单行 ID    |11  |文本|acqID      |收单行 ID "99020344" 
+ 12|支付渠道代码    |10  |文本|paymentSchema|渠道代码:[点击查看详情](https://git.allpayx.com/OpenAPI/b2c_pc_payment/src/master/paymentSchema.md)
+ 13|商品信息    |60  |文本|goodsInfo       | 商品信息
+ 14|交易时间    |14  |文本|transTime       |交易时间,格式:"yyyyMMddHHmmss" 
+ 15|签名类型     |3  |文本|signType        |MD5 
+ 16|签名      |32  |文本|signature         |采用 MD5 签名 
+
+
+2. 跳转型消费接口响应报文
+
+	商户需要提供一个 http/https 协议的接口,包含在参数里传递给 SDK,即 backURL。AllPay 
+服务器在支付完成后,会以 Get 方式调用 backURL,通知支付结果。 
+
+参数如下表: 
+
+
+ 序号 |名称  |长度|类型|参数名称|备注 
+ -----|-----|----|----|------|------
+ 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|渠道代码:[点击查看详情](https://git.allpayx.com/OpenAPI/b2c_pc_payment/src/master/paymentSchema.md)
+ 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.4. 查询交易接口 
+
+
+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|渠道代码:[点击查看详情](https://git.allpayx.com/OpenAPI/b2c_pc_payment/src/master/paymentSchema.md)
+ 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.5. 退款交易接口
+
+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|渠道代码:[点击查看详情](https://git.allpayx.com/OpenAPI/b2c_pc_payment/src/master/paymentSchema.md)
+ 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 签名 

+ 376 - 0
docs/zh/pc/4.md

@@ -0,0 +1,376 @@
+# 4.渠道专属配置
+## 4.1 EB渠道(跳转)
+
+序号 |名称  |长度|类型|参数名称|备注
+ -----|-----|----|----|------|------
+  1| 姓名     |32  |文本|trxn_firstname         |This is name of the customer who is doing the transaction. 
+  2| 邮箱     |40  |文本|trxn_email_id         |this is email id of the customer who is doing transaction.
+  3|电话 |20  |文本|trxn_phone|Phone number of the customer.
+
+## 4.2 UP渠道(跳转)
+
+序号 |名称  |长度|类型|参数名称|备注 
+ -----|-----|----|----|------|------
+  1| 银联卡号 |19  | 文本|uCardNumber |境外银联通道,适用于银联优计划。可以不上送,若需要提前填入银行卡号,则上送此字段。
+
+## 4.3 WX渠道(含跳转和参数返回)
+
+ 序号 |名称  |长度|类型|参数名称|备注 
+ -----|-----|----|----|------|------
+  1| 交易场景代码|16  | 文本|code |1.“NATIVE“:为参数返回方式,返回微信收款URL值, 要求商户将其转换为 QR 码,自己生成支付前端界 面,提示用户扫码付款; 2.“QUICK”:为跳转方式,打开 AllPay 提供的前端页面,页面包含微信 QR 码
+## 4.4 PPRO相关渠道(跳转)
+## 4.4.1 PPRO_AC
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |文本 |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+consumerref |M   |文本 |Unique reference identifying the consumer, has to satisfy the regular expression [A-Za-z0-9.%,&/+*$-]{1,20} 
+
+Note: AstroPay Card is available for currency USD and country codes BO, BR, CL, CN, CO, CR, MX, PE, UY, VE. 
+     
+## 4.4.2 PPRO_AD
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |文本 |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+consumerref |M   |文本 |Unique reference identifying the consumer, has to satisfy the regular expression [A-Za-z0-9.%,&/+*$-]{1,20} 
+
+Note: AstroPay Direct is available for currency USD and country codes AR, BR, CL, CN, CO, MX, PE, UY. 
+
+
+## 4.4.3 PPRO_AR
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |文本 |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+consumerref |M   |文本 |Unique reference identifying the consumer, has to satisfy the regular expression [A-Za-z0-9.%,&/+*$-]{1,20} 
+nationalid  |M   |文本 |Consumer’s national id (up to 30 characters) 
+email   |M   |文本 |RFC compliant email address of the account holder 
+dob    |O   |文本 |Date of birth, format YYYYMMDD 
+
+Note: Aura (Brazil) is available for currency USD and country code BR. 
+
+
+## 4.4.4 PPRO_BA
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |文本 |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+consumerref |M   |文本 |Unique reference identifying the consumer, has to satisfy the regular expression [A-Za-z0-9.%,&/+*$-]{1,20} 
+nationalid  |M   |文本 |Consumer’s national id (up to 30 characters) 
+email   |M   |文本 |RFC compliant email address of the account holder 
+dob    |O   |文本 |Date of birth, format YYYYMMDD 
+
+Note: Baloto Cash (Colombia) is available for currency USD and country code CO. 
+
+
+## 4.4.5 PPRO_BB
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |文本 |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+consumerref |M   |文本 |Unique reference identifying the consumer, has to satisfy the regular expression [A-Za-z0-9.%,&/+*$-]{1,20} 
+nationalid  |M   |文本 |Consumer’s national id (up to 30 characters) 
+email   |M   |文本 |RFC compliant email address of the account holder 
+dob    |O   |文本 |Date of birth, format YYYYMMDD 
+
+Note: Banco do Brasil (Brazil) is available for currency USD and country code BR. 
+
+
+## 4.4.6 PPRO_BO
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |文本 |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+consumerref |M   |文本 |Unique reference identifying the consumer, has to satisfy the regular expression [A-Za-z0-9.%,&/+*$-]{1,20} 
+nationalid  |M   |文本 |Consumer’s national id (up to 30 characters) 
+email   |M   |文本 |RFC compliant email address of the account holder 
+dob    |O   |文本 |Date of birth, format YYYYMMDD 
+
+Note: Boleto Bancario is available for currency USD and country code BR. 
+
+
+
+## 4.4.7 PPRO_CC
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |文本 |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+consumerref |M   |文本 |Unique reference identifying the consumer, has to satisfy the regular expression [A-Za-z0-9.%,&/+*$-]{1,20} 
+nationalid  |M   |文本 |Consumer’s national id (up to 30 characters) 
+email   |M   |文本 |RFC compliant email address of the account holder 
+dob    |O   |文本 |Date of birth, format YYYYMMDD 
+
+Note: Cartao MercadoLivre (Brazil) is available for currency USD and country code BR. 
+
+## 4.4.8 PPRO_DR
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |文本 |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+email   |M   |文本 |RFC compliant email address of the account holder 
+phone  |M  |文本 |Valid international phone number of the account holder 
+
+Note: Dragonpay is only available for currency PHP and country code PH. 
+
+
+
+## 4.4.9 PPRO_EN
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |文本 |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+email   |M   |文本 |RFC compliant email address of the account holder 
+phone  |M  |文本 |Valid international phone number of the account holder 
+
+Note: eNETS is only available for currency SGD and country code SG. 
+
+## 4.4.10 PPRO_EP
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |文本 |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+
+Note: eps only works for the countrycode “AT” and currency “EUR”. 
+
+## 4.4.11 PPRO_GP
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |文本 |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+bic |O  |文本 |Valid BIC (8 or 11 alphanumeric letters) of consumer’s bank 
+
+
+## 4.4.12 PPRO_HC
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |文本 |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+consumerref |M   |文本 |Unique reference identifying the consumer, has to satisfy the regular expression [A-Za-z0-9.%,&/+*$-]{1,20} 
+nationalid  |M   |文本 |Consumer’s national id (up to 30 characters) 
+email   |M   |文本 |RFC compliant email address of the account holder 
+dob    |O   |文本 |Date of birth, format YYYYMMDD 
+
+Note: Hipercard (Brazil) is available for currency USD and country code BR. 
+
+## 4.4.13 PPRO_ID
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |文本 |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+
+Note: iDEAL only works for the countrycode “NL” and currency “EUR”. 
+
+## 4.4.14 PPRO_IT
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |文本 |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+consumerref |M   |文本 |Unique reference identifying the consumer, has to satisfy the regular expression [A-Za-z0-9.%,&/+*$-]{1,20} 
+nationalid  |M   |文本 |Consumer’s national id (up to 30 characters) 
+email   |M   |文本 |RFC compliant email address of the account holder 
+dob    |O   |文本 |Date of birth, format YYYYMMDD 
+
+Note: Itaú (Brazil) is available for currency USD and country code BR.
+
+## 4.4.15 PPRO_MB
+
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |文本 |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+
+Note: MyBank only works for the country code IT and currency EUR. 
+
+
+## 4.4.16 PPRO_PC
+
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |文本 |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+consumerref |M   |文本 |Unique reference identifying the consumer, has to satisfy the regular expression [A-Za-z0-9.%,&/+*$-]{1,20} 
+
+
+
+## 4.4.17 PPRO_PB
+
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |文本 |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+email   |M   |文本 |RFC compliant email address of the account holder 
+phone  |M  |文本 |Valid international phone number of the account holder 
+
+Note: PAYSBUY Cash is only available for currency THB and country code TH. 
+
+
+
+## 4.4.18 PPRO_PU
+
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |文本 |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+email   |M   |文本 |RFC compliant email address of the account holder 
+
+Note: PayU works only for country code/currency combinations CZ/CZK and PL/PLN. 
+
+## 4.4.19 PPRO_PL
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |文本 |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+
+Note: POLi only works for the countrycode/currency combinations “NZ”/”NZD” and “AU/AUD”. 
+
+## 4.4.20 PPRO_P24
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |文本 |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+email   |M   |文本 |RFC compliant email address of the account holder 
+
+Note: Przelewy24 only works for the countrycode “PL” and currencies “PLN” and “EUR”. 
+
+
+## 4.4.21 PPRO_QW
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |文本 |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+mobilephone|M   |文本 |Valid international Russian mobile phone number identifying the QIWI destination account to pay out to (excluding plus sign or any other international prefixes, including a leading 7 for Russia, 11 digits in total, e.g. 71234567890). 
+
+
+Note:	QIWI Payout only works for the countrycodes “RU”, “KZ” and UA, and - depending on your contract - currency 
“RUB” , “EUR” ,”KZT” and “USD”. 

+## 4.4.22 PPRO_SP
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |文本 |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+
+Note: SafetyPay only works for country codes “AT”, “BR”, “CO”, “CR”, “DE”, “ES”, “MX”, “NI”, “NL”, “PA”, “PE” and currencies “EUR”, “USD”. 
+
+## 4.4.23 PPRO_SD
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |文本 |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+
+
+Note: SEPA Direct Debit works for all SEPA countries and currency EUR. 
+
+
+## 4.4.24 PPRO_SG
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |文本 |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+email   |M   |文本 |RFC compliant email address of the account holder 
+phone  |M  |文本 |Valid international phone number of the account holder 
+
+Note: SingPost (Singapore) is only available for currency SGD and country code SG. 
+
+## 4.4.25 PPRO_SK
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |文本 |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+email   |O  |文本 |RFC compliant email address of the account holder 
+address   |O  |文本 |Consumer’s address (e.g. street) 
+zipcode    |O  |文本 |Consumer’s postal code 
+city     |O  |文本 |Consumer’s city 
+
+## 4.4.26 PPRO_DP
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |文本 |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+bic |O  |文本 |Valid BIC (8 or 11 alphanumeric letters) of consumer’s bank 
+
+
+## 4.4.27 PPRO_TP
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |文本 |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+
+TrustPay works for the following country code/currency combinations: 
+
+
+CZ 
+CZK, EUR 
+
+
+SK 
+EUR 
+
+
+The currencies available to you may depend on your contract. 
+
+
+## 4.4.28 PPRO_WP
+
+
+ Field name  |M/O   |Type |Description  
+ -----|-----|----|----
+ countrycode|M   |文本 |The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation. 
+accountholdername|M   |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. 
+consumerref |M   |文本 |Unique reference identifying the consumer, has to satisfy the regular expression [A-Za-z0-9.%,&/+*$-]{1,20} 
+nationalid  |M   |文本 |Consumer’s national id (up to 30 characters) 
+email   |M   |文本 |RFC compliant email address of the account holder 
+dob    |O   |文本 |Date of birth, format YYYYMMDD 
+
+Note: WebPay is available for currency USD and country code CL. 

+ 21 - 0
docs/zh/pc/5.md

@@ -0,0 +1,21 @@
+# 5.测试账户
+
+ 请注意,支付宝、财付通交易需要用中国实名认证的账户进行测试交易,所有测试交 
+易不提供清算服务,请用小额测试。
+
+以下是银联渠道测试卡,仅用于测试使用: 
+
+```
+信用卡:5200831111111113 
+手机:13552535506
+CVN2:123
+有效期:2019 年 11 月 
+电脑端验证码:111111 
+移动端验证码:123456
+
+信用卡:6226388000000095 
+手机:18100000000 
+CVN2:248
+有效期:2019 年 12 月 
+电脑端验证码:111111 
+移动端验证码:123456 

+ 19 - 0
docs/zh/pc/6.md

@@ -0,0 +1,19 @@
+# 6. 错误码
+
+若商户请求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  

+ 6 - 0
docs/zh/pc/README.md

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

+ 14 - 0
docs/zh/wx/README.md

@@ -0,0 +1,14 @@
+# 微信小程序支付接入规范文档4.2.1
+
+[上海偶可贝网络科技有限公司](https://www.allpayx.com)
+
+* 版本信息:中文 V4.2.1
+* 更新时间:2018 年6 月
+
+## 1.概述
+
+AllPay为基于微信小程序开发的接口,以帮助客户实现快速、安全、集中式的接入支付渠道。 
+
+## 2.通用API说明
+
+商户服务器和 AllPay 网关对接的通用接口,每个渠道都具有的功能,包括:消费,退款,查询接口。

A diferenza do arquivo foi suprimida porque é demasiado grande
+ 11912 - 0
package-lock.json


+ 22 - 0
package.json

@@ -0,0 +1,22 @@
+{
+  "name": "b2c",
+  "version": "1.0.0",
+  "description": "b2c api文档",
+  "main": "index.js",
+  "directories": {
+    "doc": "docs"
+  },
+  "scripts": {
+    "dev": "vuepress dev docs",
+    "build": "vuepress build docs"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://git.allpayx.com/OpenAPI/b2c.git"
+  },
+  "author": "",
+  "license": "ISC",
+  "devDependencies": {
+    "vuepress": "^0.12.0"
+  }
+}