Browse Source

fixup! add express文档

benson 5 years ago
parent
commit
2f997844ab
2 changed files with 176 additions and 36 deletions
  1. 105 36
      docs/expup/2.md
  2. 71 0
      docs/expup/4.md

+ 105 - 36
docs/expup/2.md

@@ -87,9 +87,72 @@ card_no=6222020302030778784&expiry_date=0824&mch_id=000000000000015&order_amount
 }
 ```
 
+## 3.4. 消费退款接口
 
+1. 请求参数
+
+   | 参数名称       | 必填 | 使用说明                                       |
+   | :------------- | :--- | ---------------------------------------------- |
+   | mch_id         | M    | 商户ID,由AllPay分配                           |
+   | trade_type     | M    | 交易类型 退款填写"REFD"              |
+   | trade_no       | M    | 商户自行定义,需保证同一商户号下订单号不能重复 |
+   | origin_trade_no       | M    | 原交易订单号 |
+   | refund_amount | M    | 退款金额   如100元,表示为100或100.00          |
+   | order_currency | M    | 订单币种  人民币填写“CNY”,美元填写"USD"        |
+   | trade_time     | M    | 交易时间,格式:"yyyyMMddHHmmss"                 |
+   | sign_type      | M    | SHA256                                         |
+   | sign           | M    | 签名                                           |
+
+   举例如下:
+
+   ```json
+   {
+    mch_id:"000000000000015",
+    trade_type:"REFD",
+    trade_no:"35252352352525",
+    origin_trade_no:"5389535343453",
+    refund_amount:"100",
+    order_currency:"CNY",
+    trade_time:"20180821120001",
+    sign_type:"SHA256",
+    sign:"" 
+   }
+   ```
+
+   
 
-## 3.4. 订购预授权 
+2. 响应报文
+
+参数如下表:
+
+| 参数名称   | 必填 | 使用说明             |
+| ---------- | ---- | -------------------- |
+| resp_code  | M    | 应答码 00-成功       |
+| resp_msg   | M    | 应答信息             |
+| mch_id     | M    | 商户ID,由AllPay分配 |
+| trade_type | M    | 交易类型             |
+| trade_time | M    | 交易时间             |
+| trade_no   | M    | 交易订单号           |
+| sign_type  | M    | SHA256               |
+| sign       | M    | 签名                 |
+
+举例如下:
+
+```json
+{
+    resp_code:"00",
+    resp_msg:"SUCCESS",
+    mch_id:"000000000000015",
+    trade_type:"REFD",
+    trade_time:"20180821120001",
+    trade_no:"35252352352525",
+    sign_type:"SHA256",
+    sign:""
+    
+}
+```
+
+## 3.5. 订购预授权 
 
 
 1. 请求参数
@@ -161,21 +224,24 @@ card_no=6222020302030778784&expiry_date=0824&mch_id=000000000000015&order_amount
 
 
 
-## 3.5. 订购预授权完成 
+## 3.6. 订购预授权完成 
 
 
 1. 请求参数
 
-   | 参数名称       | 必填 | 使用说明                                       |
-   | :------------- | :--- | ---------------------------------------------- |
-   | mch_id         | M    | 商户ID,由AllPay分配                           |
-   | trade_type     | M    | 交易类型 预授权完成填写"  PAUC  "              |
-   | trade_no       | M    | 商户自行定义,需保证同一商户号下订单号不能重复 |
-   | order_amount   | M    | 订单金额   如100元,表示为100或100.00          |
-   | order_currency | M    | 订单币种  人民币填写“CNY”,美元填写"USD"        |
-   | trade_time     | M    | 交易时间,格式:"yyyyMMddHHmmss"                 |
-   | sign_type      | M    | SHA256                                         |
-   | sign           | M    | 签名                                           |
+   | 参数名称        | 必填 | 使用说明                                       |
+   | :-------------- | :--- | ---------------------------------------------- |
+   | mch_id          | M    | 商户ID,由AllPay分配                           |
+   | trade_type      | M    | 交易类型 预授权完成填写"  PAUC  "              |
+   | trade_no        | M    | 商户自行定义,需保证同一商户号下订单号不能重复 |
+   | origin_trade_no | M    | 原订单号                                       |
+   | order_amount    | M    | 订单金额   如100元,表示为100或100.00          |
+   | order_currency  | M    | 订单币种  人民币填写“CNY”,美元填写"USD"        |
+   | trade_time      | M    | 交易时间,格式:"yyyyMMddHHmmss"                 |
+   | sign_type       | M    | SHA256                                         |
+   | sign            | M    | 签名                                           |
+
+   
 
    举例如下:
 
@@ -183,7 +249,8 @@ card_no=6222020302030778784&expiry_date=0824&mch_id=000000000000015&order_amount
    {
     mch_id:"000000000000015",
     trade_type:"PAUC",
-    trade_no:"5389535343453",
+    trade_no:"424234234242423",
+    origin_trade_no:"5389535343453",
     order_amount:"100",
     order_currency:"CNY",
     trade_time:"20180821120001",
@@ -218,33 +285,35 @@ card_no=6222020302030778784&expiry_date=0824&mch_id=000000000000015&order_amount
     mch_id:"000000000000015",
     trade_type:"PAUC",
     trade_time:"20180821120001",
-    trade_no:"5389535343453",
+    trade_no:"424234234242423",
     sign_type:"SHA256",
     sign:""
     
 }
 ```
-## 3.6. 预授权撤销 
+## 3.7. 撤销接口 
 
 
 1. 请求参数
 
-   | 参数名称       | 必填 | 使用说明                                       |
-   | :------------- | :--- | ---------------------------------------------- |
-   | mch_id         | M    | 商户ID,由AllPay分配                           |
-   | trade_type     | M    | 交易类型 预授权撤销填写"CANC "                 |
-   | trade_no       | M    | 商户自行定义,需保证同一商户号下订单号不能重复 |
-   | trade_time     | M    | 交易时间,格式:"yyyyMMddHHmmss"                 |
-   | sign_type      | M    | SHA256                                         |
-   | sign           | M    | 签名                                           |
+   | 参数名称        | 必填 | 使用说明                                       |
+   | :-------------- | :--- | ---------------------------------------------- |
+   | mch_id          | M    | 商户ID,由AllPay分配                           |
+   | trade_type      | M    | 交易类型 撤销填写"VOID "                       |
+   | trade_no        | M    | 商户自行定义,需保证同一商户号下订单号不能重复 |
+   | origin_trade_no | M    | 原订单号                                       |
+   | trade_time      | M    | 交易时间,格式:"yyyyMMddHHmmss"                 |
+   | sign_type       | M    | SHA256                                         |
+   | sign            | M    | 签名                                           |
 
    举例如下:
 
    ```json
    {
     mch_id:"000000000000015",
-    trade_type:"CANC",
-    trade_no:"5389535343453",
+    trade_type:"VOID",
+    trade_no:"4324242424234234",
+    origin_trade_no:"424234234242423",
     trade_time:"20180821120001",
     sign_type:"SHA256",
     sign:"" 
@@ -275,9 +344,9 @@ card_no=6222020302030778784&expiry_date=0824&mch_id=000000000000015&order_amount
     resp_code:"00",
     resp_msg:"SUCCESS",
     mch_id:"000000000000015",
-    trade_type:"CANC",
+    trade_type:"VOID",
     trade_time:"20180821120001",
-    trade_no:"5389535343453",
+    trade_no:"4324242424234234",
     sign_type:"SHA256",
     sign:""
     
@@ -289,15 +358,15 @@ card_no=6222020302030778784&expiry_date=0824&mch_id=000000000000015&order_amount
 
 1. 请求参数
 
-   | 参数名称          | 必填 | 使用说明                                       |
-   | :---------------- | :--- | ---------------------------------------------- |
-   | mch_id            | M    | 商户ID,由AllPay分配                           |
-   | trade_type        | M    | 交易类型 查询填写"INQY"                        |
-   | origin_trade_type | M    | 要查询的交易类型 PURC,PAUT,PAUC,CANC           |
-   | trade_no          | M    | 商户自行定义,需保证同一商户号下订单号不能重复 |
-   | trade_time        | M    | 交易时间,格式:"yyyyMMddHHmmss"                 |
-   | sign_type         | M    | SHA256                                         |
-   | sign              | M    | 签名                                           |
+   | 参数名称          | 必填 | 使用说明                             |
+   | :---------------- | :--- | ------------------------------------ |
+   | mch_id            | M    | 商户ID,由AllPay分配                 |
+   | trade_type        | M    | 交易类型 查询填写"INQY"              |
+   | origin_trade_type | M    | 要查询的交易类型 PURC,PAUT,PAUC,VOID |
+   | trade_no          | M    | 订单号                               |
+   | trade_time        | M    | 交易时间,格式:"yyyyMMddHHmmss"       |
+   | sign_type         | M    | SHA256                               |
+   | sign              | M    | 签名                                 |
 
    举例如下:
 

+ 71 - 0
docs/expup/4.md

@@ -1,3 +1,74 @@
 # 4. 错误码
 
+| 应答码 | 描述                                                         |
+| ------ | ------------------------------------------------------------ |
+| 00     | 成功                                                         |
+| 01     | 向发卡行咨询 Refertocardissuer                               |
+| 02     | 想发卡行特殊情况咨询Refertocardissuer'sspecialcondition      |
+| 03     | 无效商户 Invalid merchant                                    |
+| 04     | 没收卡 Pick-up                                               |
+| 05     | 不予承兑Donothonor                                           |
+| 06     | 出错 Error                                                   |
+| 07     | 特殊情况下没收卡 Pick-upcard,specialcondition                |
+| 09     | 请求正在处理中 Request in progress                           |
+| 10     | 部分金额批准 Approved for partial amount                     |
+| 11     | 重要人物批准(VIP)Approved(VIP)                               |
+| 12     | 无效交易 Invalidtransaction                                  |
+| 13     | 无效金额 Invalid amount                                      |
+| 14     | 无效卡号(无此帐号)Invalid card number (no such number)       |
+| 15     | 无此发卡行 No such issuer                                    |
+| 16     | 批准更新第三磁道Approved,updatetrack3                        |
+| 17     | 客户撤销 Customer Cancellation                               |
+| 19     | 重新输入交易 Re-entertransaction                             |
+| 20     | 无效应答 Invalid response                                    |
+| 21     | 无操作Noactiontaken                                          |
+| 22     | 疑似故障 Suspectedmalfunction                                |
+| 23     | 不可接受的交易费 Unacceptable transaction fee                |
+| 25     | 找不到原始交易 Unabletolocateoriginaltransaction             |
+| 30     | 格式错误 Format error                                        |
+| 31     | 交换中心不支持的银行Banknotsupportedbyswitch                 |
+| 33     | 过期的卡 Expired card                                        |
+| 34     | 有作弊嫌疑 Suspectedfraud                                    |
+| 35     | 受卡方与代理方联系 Card acceptor contact security            |
+| 36     | 受限制的卡 Restrictedcard                                    |
+| 37     | 受卡方电话通知代理方安全部门 Card acceptor call acquirer security |
+| 38     | 超过允许的 PIN 尝试次数 Allowable PIN tries exceeded         |
+| 39     | 无贷记账户 No credit account                                 |
+| 40     | 请求的功能尚不支持 Requested function not supported          |
+| 41     | 挂失卡 Lost card                                             |
+| 42     | 无此账户 No universal account                                |
+| 43     | 被窃卡,没收卡 Stolen card, pick-up                          |
+| 44     | 无此投资账户 No investment account                           |
+| 51     | 资金不足 Not sufficient funds                                |
+| 52     | 无此支票账户 No chequing account                             |
+| 53     | 无此储蓄卡账户 No saving account                             |
+| 54     | 过期的卡 Expired card                                        |
+| 55     | PIN 错误 Incorrect personal identification number            |
+| 56     | 无此卡记录 No card record                                    |
+| 57     | 不允许此持卡人进行的交易Transactionnotpermittedtocardholder  |
+| 58     | 不允许此终端进行的交易Transactionnotpermittedtoterminal      |
+| 59     | 有作弊嫌疑 Suspectedfraud                                    |
+| 60     | 受卡方与代理方联系(不没收卡)Card acceptor contact acquirer   |
+| 61     | 超出金额限制 Exceeds amount limit                            |
+| 62     | 受限制的卡 Restrictedcard                                    |
+| 63     | 安全违规 Security violation                                  |
+| 64     | 原始金额错误 Original amount incorrect                       |
+| 65     | 超出取款/小非频率限制Exceedswithdrawalfrequencylimit         |
+| 66     | 受卡方通知受理方安全部门 Card acceptor call acquirer’s security department |
+| 67     | 强行受理(要求ATM没收卡)Hardcapture(requiresthatcardbepickedupatATM) |
+| 68     | 接收应答超时Responsereceivedtoolate                          |
+| 75     | 超出允许的 PIN 尝试次数 Allowable number of PINtries exceeded |
+| 76     | 无效账户 Invalid Account                                     |
+| 90     | 正在日终处理Cutoffisinprocess                                |
+| 91     | 发卡方不能操作 Issuer is inoperative                         |
+| 92     | 金融机构或网络中间设施找不到或者无法到达。Financial institution or intermediate network  facilitycannotbefoundforrouting |
+| 93     | 交易违法,不能完成 Transaction cannot be completed. Violation of law |
+| 94     | 重复的交易 Duplicate transaction                             |
+| 95     | 核对错误 Reconcile error                                     |
+| 96     | 交换中心系统异常、失效Switchsystemmalfunction                |
+| 97     | 无效 ATM/POSID。InvalidATM/POSIds                            |
+| 98     | 交换中心无法从发卡方获取应答。SW couldn’t get reply from IS  |
+| 99     | PIN块错误PIN。BlockError                                     |
+| A0     | MAC 校验失败。MAC failed                                     |
+