修改FC接口

AllPay_Integration_Specification_CH.md

@@ -17,7 +17,9 @@ AllPay 为客户提供统一的API接入，以帮助客户实 现快速、安全
 3.示例签名串 acqID=99020344&backURL=https://baidu.com&charSet=UTF-8&detailInfo=W3siZ29vZHNfbmFtZSI6IuWNjuS4ulAyMCIsInF1YW50aXR5IjoiMiJ9LHsiZ29vZHNfbmFtZSI6IuWNjuS4ulAyMCBwbHVzIiwicXVhbnRpdHkiOiI0In1d&frontURL=https://mchapi.allpayx.com/demo&goodsInfo=华为P20&merID=000000000000015&merReserve=你好&orderAmount=1&orderCurrency=HKD&orderNum=dKmdb4S9Tv1a9ZpkMjeDawV82MCJ&paymentSchema=AP&signType=MD5&transTime=20181206134515&transType=PURC&version=VER0000000052f2c77e3718c47cfb47a89a6fbc9d361
 ```
 ## 4.通用API说明
+
 商户服务器和 AllPay 网关对接的通用接口，每个渠道都具有的功能，包括：消费，消费查询，退款，退款查询。
+
 ### 4.1 通用 API 接入地址 
 
 | 交易名称 | 测试地址                                 | 生产地址                             |
@@ -28,7 +30,7 @@ AllPay 为客户提供统一的API接入，以帮助客户实 现快速、安全
 | 退款查询 | https://testapi.allpayx.com/api/refundquery  | https://api.allpayx.com/api/refundquery  |
 | 预授权 | https://testapi.allpayx.com/api/unifiedorder | https://api.allpayx.com/api/unifiedorder |
 | 预授权完成 | https://testapi.allpayx.com/api/pauc | https://api.allpayx.com/api/pauc |
-| 撤销接口 | https://testapi.allpayx.com/api/canc | https://api.allpayx.com/api/canc |
+| 撤销 | https://testapi.allpayx.com/api/canc | https://api.allpayx.com/api/canc |
 
 ### 4.2 消费交易接口
 
@@ -101,7 +103,7 @@ AllPay 为客户提供统一的API接入，以帮助客户实 现快速、安全
 | version       | String(12) | M    | 统一填写为“VER000000005”                                     |
 | charSet       | String(6)  | M    | 统一填写为“UTF-8”                                            |
 | transType     | String(4)  | M    | 查询填写“INQY”                                               |
-| orderNum      | String(60) | M    | 订单号                                                       |
+| orderNum      | String(60) | M    | 支付订单号                                                       |
 | merID         | String(15) | M    | 商户 ID，由 AllPay 分配                                       |
 | acqID         | String(11) | M    | 收单行 ID "99020344"                                         |
 | paymentSchema | String(10) | M    | 渠道代码：[点击这里](https://git.allpayx.com/OpenAPI/common/src/master/paymentSchema.md) |
@@ -116,7 +118,7 @@ AllPay 为客户提供统一的API接入，以帮助客户实 现快速、安全
 | version       | String(12) | M    | 统一填写为“VER000000005”                                     |
 | charSet       | String(6)  | M    | 统一填写为“UTF-8”                                            |
 | transType     | String(4)  | M    | 查询填写“INQY”                                               |
-| orderNum      | String(60) | M    | 订单号                                                       |
+| orderNum      | String(60) | M    | 支付订单号                                                       |
 | transID       | String(32) | M    | GW 系统生成的交易 ID，每笔交易保持唯一                       |
 | merID         | String(15) | M    | 商户 ID，由 AllPay 分配                                      |
 | acqID         | String(11) | M    | 收单行 ID "99020344"                                         |
@@ -142,7 +144,7 @@ AllPay 为客户提供统一的API接入，以帮助客户实 现快速、安全
 | charSet       | String(6)  | M    | 统一填写为“UTF-8”                                            |
 | transType     | String(4)  | M    | 退款填写“REFD”                                               |
 | orderNum      | String(60) | M    | 退款订单号:商户自行定义，需保证同一商户号下退款订单号不能重复 |
-| origOrderNum  | String(60) | M    | 原交易订单号                                                 |
+| origOrderNum  | String(60) | M    | 原支付订单号                                                 |
 | returnAmount  | String(12) | M    | 退款金额：如 100 元，表示为 100 或 100.00                    |
 | orderCurrency | String(3)  | M    | 订单币种：ISO标准 如：人民币填写“CNY”,美元填写"USD"          |
 | merID         | String(15) | M    | 商户 ID，由AllPay 分配                                       |
@@ -269,8 +271,8 @@ AllPay 为客户提供统一的API接入，以帮助客户实 现快速、安全
 | signType      | String(10)   | M    | MD5或SHA256                                                  |
 | signature     | String(32)   | M    | 采用 MD5或SHA256 签名                                        |
 
-
 ### 4.7 外卡预授权完成接口
+
 1.接口说明
 
  该接口为接入商家提供预授权完成功能。
@@ -311,14 +313,11 @@ AllPay 为客户提供统一的API接入，以帮助客户实 现快速、安全
 | signType      | String(10) | M    | MD5或SHA256                                    |
 | signature     | String(32) | M    | 采用 MD5或SHA256 签名                          |
 
-
-
-
-### 4.8 撤销接口
+### 4.8 外卡撤销接口
 
 1.接口说明
 
- 该接口为接入商家提供对外卡 消费、预授权、预授权完成的撤销。
+ 该接口为接入商家提供对外卡消费、预授权、预授权完成的撤销。
 
 2.请求报文格式
 
@@ -328,24 +327,20 @@ AllPay 为客户提供统一的API接入，以帮助客户实 现快速、安全
 | charSet       | String(6)  | M    | 统一填写为“UTF-8”                                            |
 | transType     | String(4)  | M    | 填写“VOID”                                                   |
 | orderNum      | String(60) | M    | 订单号：商户自行定义，需保证同一商户号下订单号不能重复       |
-| origOrderNum  | String(60) | M    | 订单号：要撤销的订单号， 可以为消费、预授权、预授权完成的orderNum |
+| origOrderNum  | String(60) | M    | 原交易订单号：要撤销的订单号，可以为消费、预授权、预授权完成的orderNum |
 | merID         | String(15) | M    | 商户 ID，由 AllPay 分配                                      |
 | acqID         | String(11) | M    | 收单行 ID "99020344"                                         |
 | paymentSchema | String(10) | M    | 渠道代码：FC                                                 |
 | signType      | String(10) | M    | MD5或SHA256                                                  |
 | signature     | String(32) | M    | 采用 MD5或SHA256 签名                                        |
 
-
-
 3.响应报文格式
 
-
-
 | 参数          | 类型       | 属性 | 描述                                           |
 | ------------- | ---------- | ---- | ---------------------------------------------- |
 | version       | String(12) | M    | 统一填写为“VER000000005”                       |
 | charSet       | String(6)  | M    | 统一填写为“UTF-8”                              |
-| transType     | String(4)  | M    | 查询填写“VOID”                                 |
+| transType     | String(4)  | M    | 填写“VOID”                                 |
 | orderNum      | String(60) | M    | 撤销订单号                                     |
 | transID       | String(32) | M    | GW 系统生成的交易 ID，每笔交易保持唯一         |
 | merID         | String(15) | M    | 商户 ID，由 AllPay 分配                        |
@@ -358,8 +353,6 @@ AllPay 为客户提供统一的API接入，以帮助客户实 现快速、安全
 | signType      | String(10) | M    | MD5或SHA256                                    |
 | signature     | String(32) | M    | 采用 MD5或SHA256 签名                          |
 
-
-
 ## 5.渠道专属配置
 
 ### 5.1 WX渠道

AllPay_Integration_Specification_EN.md

@@ -17,7 +17,9 @@ AllPay provides customers with unified API access to help them implement fast, s
 3.Sample signature string: acqID=99020344&backURL=https://www.allpayx.com&charSet=UTF-8&detailInfo=W3siZ29vZHNfbmFtZSI6IuiLueaenCIsInF1YW50aXR5IjoiMyJ9LHsiZ29vZHNfbmFtZSI6IuapmOWtkCIsInF1YW50aXR5IjoiNyJ9XQ==&frontURL=https://www.baidu.com&goodsInfo=apple&merID=000000000000015&merReserve=iPhone&orderAmount=0.01&orderCurrency=USD&orderNum=20190104022800&paymentSchema=AP&signType=MD5&transTime=20190104022800&transType=PURC&version=VER0000000052f2c77e3718c47cfb47a89a6fbc9d361
 ```
 ## 4.Common interface
-Common interface includes notification, asynchronous notification of transactions, transaction inquiry, refund, refund inquiry interface
+
+Common interface includes notification, asynchronous notification of transactions, transaction inquiry, refund, refund inquiry interface.
+
 ### 4.1 General API access address 
 
 | Interface Name | Test URL                                 | Production URL                             |
@@ -28,6 +30,7 @@ Common interface includes notification, asynchronous notification of transaction
 | Refund inquiry | https://testapi.allpayx.com/api/refundquery  | https://api.allpayx.com/api/refundquery  |
 | Pre-authorization | https://testapi.allpayx.com/api/unifiedorder | https://api.allpayx.com/api/unifiedorder |
 | Pre-authorization completed | https://testapi.allpayx.com/api/pauc | https://api.allpayx.com/api/pauc |
+| Cancellation | https://testapi.allpayx.com/api/canc | https://api.allpayx.com/api/canc |
 
 ### 4.2 Purchase interface
 
@@ -310,6 +313,46 @@ Parameters as follows:
 | signType      | String(10) | M    | "MD5" or "SHA256" |
 | signature     | String(32) | M    | MD5 or SHA256 signature |
 
+### 4.8 Cancellation interface
+
+1.Interface specification
+
+ The interface provides the access merchant with the cancellation of international credit card consumption, pre-authorization, and pre-authorization completion.
+
+2.Request message format
+
+| Parameter          | Type       | Required | Description |
+| ------------- | ---------- | ---- | ------------------------------------------------------------ |
+| version       | String(12) | M    | "VER000000005" |
+| charSet       | String(6)  | M    | "UTF-8" |
+| transType     | String(4)  | M    | "VOID" |
+| orderNum      | String(60) | M    | Order number: it is defined by the merchant itself, and the order number must not be repeated for the same merchant number |
+| origOrderNum  | String(60) | M    | Original transaction order number: The order number to be revoked, which can be consumption, pre-authorization, pre-authorization completed orderNum |
+| merID         | String(15) | M    | Merchant ID, assigned by AllPay |
+| acqID         | String(11) | M    | "99020344" |
+| paymentSchema | String(10) | M    | Channel code: "FC" |
+| signType      | String(10) | M    | "MD5" or "SHA256" |
+| signature     | String(32) | M    | MD5 or SHA256 signature |
+
+3.Response message format
+
+| Parameter          | Type       | Required | Description |
+| ------------- | ---------- | ---- | ---------------------------------------------- |
+| version       | String(12) | M    | "VER000000005" |
+| charSet       | String(6)  | M    | "UTF-8" |
+| transType     | String(4)  | M    | "VOID" |
+| orderNum      | String(60) | M    | Order number of cancellation |
+| transID       | String(32) | M    | The unique transaction id generated by the gateway. |
+| merID         | String(15) | M    | Merchant ID, assigned by AllPay |
+| acqID         | String(11) | M    | "99020344" |
+| paymentSchema | String(10) | M    | Channel code: "FC" |
+| RespCode      | String(2)  | M    | 00 stands for success; 01 stands for fail. |
+| RespMsg       | String(20) | M    | Response message |
+| transTime     | String(14) | M    | Transaction time, format :" yyyyMMddHHmmss" |
+| GWTime        | String(14) | M    | yyyyMMddHHmmss this should be a GWtime, currently is local transaction time. |
+| signType      | String(10) | M    | "MD5" or "SHA256" |
+| signature     | String(32) | M    | MD5 or SHA256 signature |
+
 ## 5.Channel exclusive allocation
 
 ### 5.1 WX
@@ -501,8 +544,8 @@ Response message：
 
 | Parameter | Type   | Required | Description |
 | -------- | ------ | ---- | --------------------------------------------------------- |
-| RespCode | String | M    | 00 stands for success; 01 stands for fail.                                 |
-| RespMsg  | String | M    | Response message                                                  |
+| RespCode | String | M    | 00 stands for success; 01 stands for fail. |
+| RespMsg  | String | M    | Response message |
 | tn       | String | O    | Transaction serial number. Required parameter for Wechat app payment. When RespCode=00 returns it. |
 
 After getting tn, call the SDK to pay according to Section 7 of this document.