|
@@ -2,7 +2,7 @@
|
|
|
|
|
|
商户服务器和 AllPay 网关对接的通用接口,每个渠道都具有的功能,包括:订购消费,订购预授权,订购预授权完成,预售期撤销,查询接口。
|
|
|
|
|
|
-## 2.1. 验签说明
|
|
|
+## 2.1.验签说明
|
|
|
|
|
|
1.对于发送到 ALLPAY 系统的 POST 请求报文,其中所有传入参数(除 sign 参数外)按照字段名的 ASCII 码从小到大排序后(字典序),使用 URL 键值对的格式(即 key1=value1&key2=value2...)拼接成字符串 String1。
|
|
|
|
|
@@ -11,20 +11,20 @@
|
|
|
3.示例签名串
|
|
|
|
|
|
```js
|
|
|
-card_no=6222020302030778784¤cy=CNY&expiry_date=0824&mch_id=000000000000015&order_amount=100&sign_type=SHA256&trade_no=5389535343453&trade_time=20180821120001&trade_type=PURC2f2c77e3718c47cfb47a89a6fbc9d361
|
|
|
+card_no=5200831111111113¤cy=CNY&expiry_date=1119&mch_id=000000000000015&order_amount=100&sign_type=SHA256&trade_no=370000197809218764&trade_time=20180829165052&trade_type=PURC2f2c77e3718c47cfb47a89a6fbc9d361
|
|
|
```
|
|
|
|
|
|
-## 3.2. 通用API 接入地址
|
|
|
+## 3.2.通用API 接入地址
|
|
|
|
|
|
开发调试地址|生产交易地址
|
|
|
-----------|-------
|
|
|
<https://testapi.allpayx.com/expup> |<https://api.allpayx.com/expup>
|
|
|
|
|
|
-## 3.3. 订购消费接口
|
|
|
+## 3.3.订购消费接口
|
|
|
|
|
|
接口说明:
|
|
|
|
|
|
- 该接口可以进行订购消费,每次trade_no不能重复
|
|
|
+该接口可以进行订购消费,每次trade_no不能重复
|
|
|
|
|
|
1. 请求参数
|
|
|
|
|
@@ -45,21 +45,19 @@ card_no=6222020302030778784¤cy=CNY&expiry_date=0824&mch_id=000000000000015
|
|
|
|
|
|
```json
|
|
|
{
|
|
|
- mch_id:"000000000000015",
|
|
|
- trade_type:"PURC",
|
|
|
- trade_no:"5389535343453",
|
|
|
- order_amount:"100",
|
|
|
- currency:"CNY",
|
|
|
- card_no:"6222020302030778784",
|
|
|
- expiry_date:"0824",
|
|
|
- trade_time:"20180821120001",
|
|
|
- sign_type:"SHA256",
|
|
|
- sign:""
|
|
|
+ "mch_id": "000000000000015",
|
|
|
+ "trade_type": "PURC",
|
|
|
+ "trade_no": "370000197809218764",
|
|
|
+ "order_amount": "100",
|
|
|
+ "currency": "CNY",
|
|
|
+ "card_no": "5200831111111113",
|
|
|
+ "expiry_date": "1119",
|
|
|
+ "trade_time": "20180829165052",
|
|
|
+ "sign_type": "SHA256",
|
|
|
+ "sign": "426907204360081d7c728a6695067bc84233e82d0e3a61703313d874aa741d76"
|
|
|
}
|
|
|
```
|
|
|
|
|
|
-
|
|
|
-
|
|
|
2. 响应报文
|
|
|
|
|
|
参数如下表:
|
|
@@ -79,23 +77,22 @@ card_no=6222020302030778784¤cy=CNY&expiry_date=0824&mch_id=000000000000015
|
|
|
|
|
|
```json
|
|
|
{
|
|
|
- resp_code:"00",
|
|
|
- resp_msg:"SUCCESS",
|
|
|
- mch_id:"000000000000015",
|
|
|
- trade_type:"PURC",
|
|
|
- trade_time:"20180821120001",
|
|
|
- trade_no:"5389535343453",
|
|
|
- sign_type:"SHA256",
|
|
|
- sign:""
|
|
|
-
|
|
|
+ "resp_code": "00",
|
|
|
+ "resp_msg": "SUCCESS",
|
|
|
+ "mch_id": "000000000000015",
|
|
|
+ "trade_type": "PURC",
|
|
|
+ "trade_time": "20180829165048",
|
|
|
+ "trade_no": "520000197701311324",
|
|
|
+ "sign_type": "SHA256",
|
|
|
+ "sign": "7ca2442edac07b92ee9d086d2df1635b62c1d5d4ab33ffe8ceb2c195579a8698"
|
|
|
}
|
|
|
```
|
|
|
|
|
|
-## 3.4. 消费退款接口
|
|
|
+## 3.4.消费退款接口
|
|
|
|
|
|
接口说明:
|
|
|
|
|
|
- 该接口可以对订购消费进行退款,退款时origin_trade_no填写订购消费时的trade_no,可以进行分步退款,分步退款时每次的trade_no不能重复。
|
|
|
+该接口可以对订购消费进行退款,退款时origin_trade_no填写订购消费时的trade_no,可以进行分步退款,分步退款时每次的trade_no不能重复。
|
|
|
|
|
|
1. 请求参数
|
|
|
|
|
@@ -115,20 +112,18 @@ card_no=6222020302030778784¤cy=CNY&expiry_date=0824&mch_id=000000000000015
|
|
|
|
|
|
```json
|
|
|
{
|
|
|
- mch_id:"000000000000015",
|
|
|
- trade_type:"REFD",
|
|
|
- trade_no:"35252352352525",
|
|
|
- origin_trade_no:"5389535343453",
|
|
|
- refund_amount:"100",
|
|
|
- currency:"CNY",
|
|
|
- trade_time:"20180821120001",
|
|
|
- sign_type:"SHA256",
|
|
|
- sign:""
|
|
|
+ "mch_id": "000000000000015",
|
|
|
+ "trade_type": "REFD",
|
|
|
+ "trade_no": "990000198707011244",
|
|
|
+ "origin_trade_no": "230000197106062088",
|
|
|
+ "refund_amount": "1",
|
|
|
+ "currency": "CNY",
|
|
|
+ "trade_time": "20180829165313",
|
|
|
+ "sign_type": "SHA256",
|
|
|
+ "sign": "edc8e56be38190402ee537e3fc4e30766d47a0ca297c2de4be460a99a6139e14"
|
|
|
}
|
|
|
```
|
|
|
|
|
|
-
|
|
|
-
|
|
|
2. 响应报文
|
|
|
|
|
|
参数如下表:
|
|
@@ -148,23 +143,22 @@ card_no=6222020302030778784¤cy=CNY&expiry_date=0824&mch_id=000000000000015
|
|
|
|
|
|
```json
|
|
|
{
|
|
|
- resp_code:"00",
|
|
|
- resp_msg:"SUCCESS",
|
|
|
- mch_id:"000000000000015",
|
|
|
- trade_type:"REFD",
|
|
|
- trade_time:"20180821120001",
|
|
|
- trade_no:"35252352352525",
|
|
|
- sign_type:"SHA256",
|
|
|
- sign:""
|
|
|
-
|
|
|
+ "resp_code": "00",
|
|
|
+ "resp_msg": "SUCCESS",
|
|
|
+ "mch_id": "000000000000015",
|
|
|
+ "trade_type": "REFD",
|
|
|
+ "trade_time": "20180829165313",
|
|
|
+ "trade_no": "990000198707011244",
|
|
|
+ "sign_type": "SHA256",
|
|
|
+ "sign": "3a370170181a5aa6b5f53cb3ae81890813c455df6ec9b1a894a49302fcc3d055"
|
|
|
}
|
|
|
```
|
|
|
|
|
|
-## 3.5. 订购预授权
|
|
|
+## 3.5.订购预授权
|
|
|
|
|
|
接口说明:
|
|
|
|
|
|
- 该接口可以进行订购预授权,每次trade_no不能重复
|
|
|
+该接口可以进行订购预授权,每次trade_no不能重复
|
|
|
|
|
|
|
|
|
1. 请求参数
|
|
@@ -186,21 +180,19 @@ card_no=6222020302030778784¤cy=CNY&expiry_date=0824&mch_id=000000000000015
|
|
|
|
|
|
```json
|
|
|
{
|
|
|
- mch_id:"000000000000015",
|
|
|
- trade_type:"PURC",
|
|
|
- trade_no:"5389535343453",
|
|
|
- order_amount:"100",
|
|
|
- currency:"CNY",
|
|
|
- card_no:"6222020302030778784",
|
|
|
- expiry_date:"0824",
|
|
|
- trade_time:"20180821120001",
|
|
|
- sign_type:"SHA256",
|
|
|
- sign:""
|
|
|
+ "mch_id": "000000000000015",
|
|
|
+ "trade_type": "PAUT",
|
|
|
+ "trade_no": "620000199911267889",
|
|
|
+ "order_amount": "100",
|
|
|
+ "currency": "CNY",
|
|
|
+ "card_no": "5200831111111113",
|
|
|
+ "expiry_date": "1119",
|
|
|
+ "trade_time": "20180829165720",
|
|
|
+ "sign_type": "SHA256",
|
|
|
+ "sign": "ac7cf7d284cf72743e16c51b7a95d9a61b7dbb6f50e92f5699ecf4d9f8e65aee"
|
|
|
}
|
|
|
```
|
|
|
|
|
|
-
|
|
|
-
|
|
|
2. 响应报文
|
|
|
|
|
|
参数如下表:
|
|
@@ -220,15 +212,14 @@ card_no=6222020302030778784¤cy=CNY&expiry_date=0824&mch_id=000000000000015
|
|
|
|
|
|
```json
|
|
|
{
|
|
|
- resp_code:"00",
|
|
|
- resp_msg:"SUCCESS",
|
|
|
- mch_id:"000000000000015",
|
|
|
- trade_type:"PAUT",
|
|
|
- trade_time:"20180821120001",
|
|
|
- trade_no:"5389535343453",
|
|
|
- sign_type:"SHA256",
|
|
|
- sign:""
|
|
|
-
|
|
|
+ "resp_code": "00",
|
|
|
+ "resp_msg": "SUCCESS",
|
|
|
+ "mch_id": "000000000000015",
|
|
|
+ "trade_type": "PAUT",
|
|
|
+ "trade_time": "20180829165720",
|
|
|
+ "trade_no": "620000199911267889",
|
|
|
+ "sign_type": "SHA256",
|
|
|
+ "sign": "7421f9720d56b1d417edc26f89d2777b74d7745440bfc4957c853474f20ea4f7"
|
|
|
}
|
|
|
```
|
|
|
|
|
@@ -236,11 +227,11 @@ card_no=6222020302030778784¤cy=CNY&expiry_date=0824&mch_id=000000000000015
|
|
|
|
|
|
|
|
|
|
|
|
-## 3.6. 订购预授权完成
|
|
|
+## 3.6.订购预授权完成
|
|
|
|
|
|
接口说明:
|
|
|
|
|
|
- 该接口可以对订购预授权完成,origin_trade_no填写订购预授权时的trade_no
|
|
|
+该接口可以对订购预授权完成,origin_trade_no填写订购预授权时的trade_no
|
|
|
|
|
|
|
|
|
1. 请求参数
|
|
@@ -257,26 +248,24 @@ card_no=6222020302030778784¤cy=CNY&expiry_date=0824&mch_id=000000000000015
|
|
|
| sign_type | M | SHA256 |
|
|
|
| sign | M | 签名 |
|
|
|
|
|
|
-
|
|
|
+
|
|
|
|
|
|
举例如下:
|
|
|
|
|
|
```json
|
|
|
{
|
|
|
- mch_id:"000000000000015",
|
|
|
- trade_type:"PAUC",
|
|
|
- trade_no:"424234234242423",
|
|
|
- origin_trade_no:"5389535343453",
|
|
|
- order_amount:"100",
|
|
|
- currency:"CNY",
|
|
|
- trade_time:"20180821120001",
|
|
|
- sign_type:"SHA256",
|
|
|
- sign:""
|
|
|
+ "mch_id": "000000000000015",
|
|
|
+ "trade_type": "PAUC",
|
|
|
+ "origin_trade_no": "620000199911267889",
|
|
|
+ "trade_no": "310000198512106263",
|
|
|
+ "order_amount": "100",
|
|
|
+ "currency": "CNY",
|
|
|
+ "trade_time": "20180829170036",
|
|
|
+ "sign_type": "SHA256",
|
|
|
+ "sign": "0a532fdc7488bdbc6cdc87d24635fdd7294d6d3fc8cf0eb387d4b74b5fc3dcb7"
|
|
|
}
|
|
|
```
|
|
|
|
|
|
-
|
|
|
-
|
|
|
2. 响应报文
|
|
|
|
|
|
参数如下表:
|
|
@@ -296,22 +285,21 @@ card_no=6222020302030778784¤cy=CNY&expiry_date=0824&mch_id=000000000000015
|
|
|
|
|
|
```json
|
|
|
{
|
|
|
- resp_code:"00",
|
|
|
- resp_msg:"SUCCESS",
|
|
|
- mch_id:"000000000000015",
|
|
|
- trade_type:"PAUC",
|
|
|
- trade_time:"20180821120001",
|
|
|
- trade_no:"424234234242423",
|
|
|
- sign_type:"SHA256",
|
|
|
- sign:""
|
|
|
-
|
|
|
+ "resp_code": "00",
|
|
|
+ "resp_msg": "SUCCESS",
|
|
|
+ "mch_id": "000000000000015",
|
|
|
+ "trade_type": "PAUC",
|
|
|
+ "trade_time": "20180829170036",
|
|
|
+ "trade_no": "310000198512106263",
|
|
|
+ "sign_type": "SHA256",
|
|
|
+ "sign": "5769c35d68d8263ace180e224eea6ebb8907cc1a1042a9f955cd9c32fd0602cf"
|
|
|
}
|
|
|
```
|
|
|
-## 3.7. 撤销接口
|
|
|
+## 3.7.撤销接口
|
|
|
|
|
|
接口说明:
|
|
|
|
|
|
- 该接口可以对 订购消费,订购预授权,订购预授权完成进行撤销,origin_trade_no填写对应交易的trade_no。
|
|
|
+该接口可以对 订购消费,订购预授权,订购预授权完成进行撤销,origin_trade_no填写对应交易的trade_no。
|
|
|
|
|
|
|
|
|
1. 请求参数
|
|
@@ -330,18 +318,16 @@ card_no=6222020302030778784¤cy=CNY&expiry_date=0824&mch_id=000000000000015
|
|
|
|
|
|
```json
|
|
|
{
|
|
|
- mch_id:"000000000000015",
|
|
|
- trade_type:"VOID",
|
|
|
- trade_no:"4324242424234234",
|
|
|
- origin_trade_no:"424234234242423",
|
|
|
- trade_time:"20180821120001",
|
|
|
- sign_type:"SHA256",
|
|
|
- sign:""
|
|
|
+ "mch_id": "000000000000015",
|
|
|
+ "trade_type": "VOID",
|
|
|
+ "trade_no": "370000197912155378",
|
|
|
+ "origin_trade_no": "460000201604155983",
|
|
|
+ "trade_time": "20180829170913",
|
|
|
+ "sign_type": "SHA256",
|
|
|
+ "sign": "6c0815cd8f364dacc965e6bc2ce144fe56b7743912f0520db33c9c3393e75d26"
|
|
|
}
|
|
|
```
|
|
|
|
|
|
-
|
|
|
-
|
|
|
2. 响应报文
|
|
|
|
|
|
参数如下表:
|
|
@@ -361,15 +347,14 @@ card_no=6222020302030778784¤cy=CNY&expiry_date=0824&mch_id=000000000000015
|
|
|
|
|
|
```json
|
|
|
{
|
|
|
- resp_code:"00",
|
|
|
- resp_msg:"SUCCESS",
|
|
|
- mch_id:"000000000000015",
|
|
|
- trade_type:"VOID",
|
|
|
- trade_time:"20180821120001",
|
|
|
- trade_no:"4324242424234234",
|
|
|
- sign_type:"SHA256",
|
|
|
- sign:""
|
|
|
-
|
|
|
+ "resp_code": "00",
|
|
|
+ "resp_msg": "SUCCESS",
|
|
|
+ "mch_id": "000000000000015",
|
|
|
+ "trade_type": "VOID",
|
|
|
+ "trade_time": "20180829170913",
|
|
|
+ "trade_no": "370000197912155378",
|
|
|
+ "sign_type": "SHA256",
|
|
|
+ "sign": "d48e6a23b87f7f3b47598aed52fe60aaccb053979de588170f943f9a3426ced4"
|
|
|
}
|
|
|
```
|
|
|
|
|
@@ -395,17 +380,15 @@ card_no=6222020302030778784¤cy=CNY&expiry_date=0824&mch_id=000000000000015
|
|
|
|
|
|
```json
|
|
|
{
|
|
|
- mch_id:"000000000000015",
|
|
|
- trade_type:"INQY",
|
|
|
- trade_no:"5389535343453",
|
|
|
- trade_time:"20180821120001",
|
|
|
- sign_type:"SHA256",
|
|
|
- sign:""
|
|
|
+ "mch_id": "000000000000015",
|
|
|
+ "trade_type": "INQY",
|
|
|
+ "trade_no": "990000198707011244",
|
|
|
+ "trade_time": "20180829171422",
|
|
|
+ "sign_type": "SHA256",
|
|
|
+ "sign": "2bdfe50dc7c207891e132485eedf978c3f355f3a8e3ad25d6b4260c388a584c5"
|
|
|
}
|
|
|
```
|
|
|
|
|
|
-
|
|
|
-
|
|
|
2. 响应报文
|
|
|
|
|
|
参数如下表:
|
|
@@ -428,17 +411,14 @@ card_no=6222020302030778784¤cy=CNY&expiry_date=0824&mch_id=000000000000015
|
|
|
|
|
|
```json
|
|
|
{
|
|
|
- resp_code:"00",
|
|
|
- resp_msg:"SUCCESS",
|
|
|
- mch_id:"000000000000015",
|
|
|
- trade_type:"PURC",
|
|
|
- order_amount:"100",
|
|
|
- currency:"CNY",
|
|
|
- trade_time:"20180821120001",
|
|
|
- trade_no:"5389535343453",
|
|
|
- sign_type:"SHA256",
|
|
|
- sign:""
|
|
|
-
|
|
|
+ "mch_id": "000000000000015",
|
|
|
+ "trade_type": "REFD",
|
|
|
+ "trade_time": "20180829165313",
|
|
|
+ "trade_no": "990000198707011244",
|
|
|
+ "refund_amount": "1",
|
|
|
+ "currency": "CNY",
|
|
|
+ "sign_type": "SHA256",
|
|
|
+ "sign": "4ab0c48ac6aac058f7f5d6473679dcebc91d6c57cf3f690ab8984248b5b960f9"
|
|
|
}
|
|
|
```
|
|
|
|