|
@@ -11,7 +11,7 @@
|
|
|
3.示例签名串
|
|
|
|
|
|
```js
|
|
|
-card_no=6222020302030778784&expiry_date=0824&mch_id=000000000000015&order_amount=100&order_currency=CNY&sign_type=SHA256&trade_no=5389535343453&trade_time=20180821120001&trade_type=PURC2f2c77e3718c47cfb47a89a6fbc9d361
|
|
|
+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
|
|
|
```
|
|
|
|
|
|
## 3.2. 通用API 接入地址
|
|
@@ -22,20 +22,24 @@ card_no=6222020302030778784&expiry_date=0824&mch_id=000000000000015&order_amount
|
|
|
|
|
|
## 3.3. 订购消费接口
|
|
|
|
|
|
+接口说明:
|
|
|
+
|
|
|
+ 该接口可以进行订购消费,每次trade_no不能重复
|
|
|
+
|
|
|
1. 请求参数
|
|
|
|
|
|
- | 参数名称 | 必填 | 使用说明 |
|
|
|
- | :------------- | :--- | ---------------------------------------------- |
|
|
|
- | mch_id | M | 商户ID,由AllPay分配 |
|
|
|
- | trade_type | M | 交易类型 消费填写"PURC" |
|
|
|
- | trade_no | M | 商户自行定义,需保证同一商户号下订单号不能重复 |
|
|
|
- | order_amount | M | 订单金额 如100元,表示为100或100.00 |
|
|
|
- | order_currency | M | 订单币种 人民币填写“CNY”,美元填写"USD" |
|
|
|
- | card_no | M | 卡号 |
|
|
|
- | expiry_date | M | 有效期 MMYY |
|
|
|
- | trade_time | M | 交易时间,格式:"yyyyMMddHHmmss" |
|
|
|
- | sign_type | M | SHA256 |
|
|
|
- | sign | M | 签名 |
|
|
|
+ | 参数名称 | 必填 | 使用说明 |
|
|
|
+ | :----------- | :--- | ---------------------------------------------- |
|
|
|
+ | mch_id | M | 商户ID,由AllPay分配 |
|
|
|
+ | trade_type | M | 交易类型 消费填写"PURC" |
|
|
|
+ | trade_no | M | 商户自行定义,需保证同一商户号下订单号不能重复 |
|
|
|
+ | order_amount | M | 订单金额 如100元,表示为100或100.00 |
|
|
|
+ | currency | M | 订单币种 人民币填写“CNY”,美元填写"USD" |
|
|
|
+ | card_no | M | 卡号 |
|
|
|
+ | expiry_date | M | 有效期 MMYY |
|
|
|
+ | trade_time | M | 交易时间,格式:"yyyyMMddHHmmss" |
|
|
|
+ | sign_type | M | SHA256 |
|
|
|
+ | sign | M | 签名 |
|
|
|
|
|
|
举例如下:
|
|
|
|
|
@@ -45,7 +49,7 @@ card_no=6222020302030778784&expiry_date=0824&mch_id=000000000000015&order_amount
|
|
|
trade_type:"PURC",
|
|
|
trade_no:"5389535343453",
|
|
|
order_amount:"100",
|
|
|
- order_currency:"CNY",
|
|
|
+ currency:"CNY",
|
|
|
card_no:"6222020302030778784",
|
|
|
expiry_date:"0824",
|
|
|
trade_time:"20180821120001",
|
|
@@ -89,6 +93,10 @@ card_no=6222020302030778784&expiry_date=0824&mch_id=000000000000015&order_amount
|
|
|
|
|
|
## 3.4. 消费退款接口
|
|
|
|
|
|
+接口说明:
|
|
|
+
|
|
|
+ 该接口可以对订购消费进行退款,退款时origin_trade_no填写订购消费时的trade_no,可以进行分步退款,分步退款时每次的trade_no不能重复。
|
|
|
+
|
|
|
1. 请求参数
|
|
|
|
|
|
| 参数名称 | 必填 | 使用说明 |
|
|
@@ -96,9 +104,9 @@ card_no=6222020302030778784&expiry_date=0824&mch_id=000000000000015&order_amount
|
|
|
| mch_id | M | 商户ID,由AllPay分配 |
|
|
|
| trade_type | M | 交易类型 退款填写"REFD" |
|
|
|
| trade_no | M | 商户自行定义,需保证同一商户号下订单号不能重复 |
|
|
|
- | origin_trade_no | M | 原交易订单号 |
|
|
|
+ | origin_trade_no | M | 原订购消费订单号, 原交易类型必须为PURC |
|
|
|
| refund_amount | M | 退款金额 如100元,表示为100或100.00 |
|
|
|
- | order_currency | M | 订单币种 人民币填写“CNY”,美元填写"USD" |
|
|
|
+ | currency | M | 订单币种 人民币填写“CNY”,美元填写"USD" |
|
|
|
| trade_time | M | 交易时间,格式:"yyyyMMddHHmmss" |
|
|
|
| sign_type | M | SHA256 |
|
|
|
| sign | M | 签名 |
|
|
@@ -112,7 +120,7 @@ card_no=6222020302030778784&expiry_date=0824&mch_id=000000000000015&order_amount
|
|
|
trade_no:"35252352352525",
|
|
|
origin_trade_no:"5389535343453",
|
|
|
refund_amount:"100",
|
|
|
- order_currency:"CNY",
|
|
|
+ currency:"CNY",
|
|
|
trade_time:"20180821120001",
|
|
|
sign_type:"SHA256",
|
|
|
sign:""
|
|
@@ -154,21 +162,25 @@ card_no=6222020302030778784&expiry_date=0824&mch_id=000000000000015&order_amount
|
|
|
|
|
|
## 3.5. 订购预授权
|
|
|
|
|
|
+接口说明:
|
|
|
+
|
|
|
+ 该接口可以进行订购预授权,每次trade_no不能重复
|
|
|
+
|
|
|
|
|
|
1. 请求参数
|
|
|
|
|
|
- | 参数名称 | 必填 | 使用说明 |
|
|
|
- | :------------- | :--- | ---------------------------------------------- |
|
|
|
- | mch_id | M | 商户ID,由AllPay分配 |
|
|
|
- | trade_type | M | 交易类型 预授权填写" PAUT " |
|
|
|
- | trade_no | M | 商户自行定义,需保证同一商户号下订单号不能重复 |
|
|
|
- | order_amount | M | 订单金额 如100元,表示为100或100.00 |
|
|
|
- | order_currency | M | 订单币种 人民币填写“CNY”,美元填写"USD" |
|
|
|
- | card_no | M | 卡号 |
|
|
|
- | expiry_date | M | 有效期 MMYY |
|
|
|
- | trade_time | M | 交易时间,格式:"yyyyMMddHHmmss" |
|
|
|
- | sign_type | M | SHA256 |
|
|
|
- | sign | M | 签名 |
|
|
|
+ | 参数名称 | 必填 | 使用说明 |
|
|
|
+ | :----------- | :--- | ---------------------------------------------- |
|
|
|
+ | mch_id | M | 商户ID,由AllPay分配 |
|
|
|
+ | trade_type | M | 交易类型 预授权填写" PAUT " |
|
|
|
+ | trade_no | M | 商户自行定义,需保证同一商户号下订单号不能重复 |
|
|
|
+ | order_amount | M | 订单金额 如100元,表示为100或100.00 |
|
|
|
+ | currency | M | 订单币种 人民币填写“CNY”,美元填写"USD" |
|
|
|
+ | card_no | M | 卡号 |
|
|
|
+ | expiry_date | M | 有效期 MMYY |
|
|
|
+ | trade_time | M | 交易时间,格式:"yyyyMMddHHmmss" |
|
|
|
+ | sign_type | M | SHA256 |
|
|
|
+ | sign | M | 签名 |
|
|
|
|
|
|
举例如下:
|
|
|
|
|
@@ -178,7 +190,7 @@ card_no=6222020302030778784&expiry_date=0824&mch_id=000000000000015&order_amount
|
|
|
trade_type:"PURC",
|
|
|
trade_no:"5389535343453",
|
|
|
order_amount:"100",
|
|
|
- order_currency:"CNY",
|
|
|
+ currency:"CNY",
|
|
|
card_no:"6222020302030778784",
|
|
|
expiry_date:"0824",
|
|
|
trade_time:"20180821120001",
|
|
@@ -226,6 +238,10 @@ card_no=6222020302030778784&expiry_date=0824&mch_id=000000000000015&order_amount
|
|
|
|
|
|
## 3.6. 订购预授权完成
|
|
|
|
|
|
+接口说明:
|
|
|
+
|
|
|
+ 该接口可以对订购预授权完成,origin_trade_no填写订购预授权时的trade_no
|
|
|
+
|
|
|
|
|
|
1. 请求参数
|
|
|
|
|
@@ -234,9 +250,9 @@ card_no=6222020302030778784&expiry_date=0824&mch_id=000000000000015&order_amount
|
|
|
| mch_id | M | 商户ID,由AllPay分配 |
|
|
|
| trade_type | M | 交易类型 预授权完成填写" PAUC " |
|
|
|
| trade_no | M | 商户自行定义,需保证同一商户号下订单号不能重复 |
|
|
|
- | origin_trade_no | M | 原订单号 |
|
|
|
+ | origin_trade_no | M | 原预授权订单号, 原交易类型必须为PAUT |
|
|
|
| order_amount | M | 订单金额 如100元,表示为100或100.00 |
|
|
|
- | order_currency | M | 订单币种 人民币填写“CNY”,美元填写"USD" |
|
|
|
+ | currency | M | 订单币种 人民币填写“CNY”,美元填写"USD" |
|
|
|
| trade_time | M | 交易时间,格式:"yyyyMMddHHmmss" |
|
|
|
| sign_type | M | SHA256 |
|
|
|
| sign | M | 签名 |
|
|
@@ -252,7 +268,7 @@ card_no=6222020302030778784&expiry_date=0824&mch_id=000000000000015&order_amount
|
|
|
trade_no:"424234234242423",
|
|
|
origin_trade_no:"5389535343453",
|
|
|
order_amount:"100",
|
|
|
- order_currency:"CNY",
|
|
|
+ currency:"CNY",
|
|
|
trade_time:"20180821120001",
|
|
|
sign_type:"SHA256",
|
|
|
sign:""
|
|
@@ -293,6 +309,10 @@ card_no=6222020302030778784&expiry_date=0824&mch_id=000000000000015&order_amount
|
|
|
```
|
|
|
## 3.7. 撤销接口
|
|
|
|
|
|
+接口说明:
|
|
|
+
|
|
|
+ 该接口可以对 订购消费,订购预授权,订购预授权完成进行撤销,origin_trade_no填写对应交易的trade_no。
|
|
|
+
|
|
|
|
|
|
1. 请求参数
|
|
|
|
|
@@ -301,7 +321,7 @@ card_no=6222020302030778784&expiry_date=0824&mch_id=000000000000015&order_amount
|
|
|
| mch_id | M | 商户ID,由AllPay分配 |
|
|
|
| trade_type | M | 交易类型 撤销填写"VOID " |
|
|
|
| trade_no | M | 商户自行定义,需保证同一商户号下订单号不能重复 |
|
|
|
- | origin_trade_no | M | 原订单号 |
|
|
|
+ | origin_trade_no | M | 需要撤销的订单号 |
|
|
|
| trade_time | M | 交易时间,格式:"yyyyMMddHHmmss" |
|
|
|
| sign_type | M | SHA256 |
|
|
|
| sign | M | 签名 |
|
|
@@ -353,20 +373,23 @@ card_no=6222020302030778784&expiry_date=0824&mch_id=000000000000015&order_amount
|
|
|
}
|
|
|
```
|
|
|
|
|
|
-## 3.6. 交易查询
|
|
|
+## 3.8.交易查询
|
|
|
+
|
|
|
+接口说明:
|
|
|
+
|
|
|
+该接口可以对订购消费,订购预授权,订购预授权完成,退款,撤销,进行查询,trade_no填写要查询的订单的
|
|
|
|
|
|
|
|
|
1. 请求参数
|
|
|
|
|
|
- | 参数名称 | 必填 | 使用说明 |
|
|
|
- | :---------------- | :--- | ------------------------------------ |
|
|
|
- | 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 | 签名 |
|
|
|
+ | 参数名称 | 必填 | 使用说明 |
|
|
|
+ | :--------- | :--- | ------------------------------ |
|
|
|
+ | mch_id | M | 商户ID,由AllPay分配 |
|
|
|
+ | trade_type | M | 交易类型 查询填写"INQY" |
|
|
|
+ | trade_no | M | 需要查询状态的订单号 |
|
|
|
+ | trade_time | M | 交易时间,格式:"yyyyMMddHHmmss" |
|
|
|
+ | sign_type | M | SHA256 |
|
|
|
+ | sign | M | 签名 |
|
|
|
|
|
|
举例如下:
|
|
|
|
|
@@ -374,7 +397,6 @@ card_no=6222020302030778784&expiry_date=0824&mch_id=000000000000015&order_amount
|
|
|
{
|
|
|
mch_id:"000000000000015",
|
|
|
trade_type:"INQY",
|
|
|
- origin_trade_type:"PURC",
|
|
|
trade_no:"5389535343453",
|
|
|
trade_time:"20180821120001",
|
|
|
sign_type:"SHA256",
|
|
@@ -388,18 +410,19 @@ card_no=6222020302030778784&expiry_date=0824&mch_id=000000000000015&order_amount
|
|
|
|
|
|
参数如下表:
|
|
|
|
|
|
-| 参数名称 | 必填 | 使用说明 |
|
|
|
-| -------------- | ---- | --------------------------------------- |
|
|
|
-| resp_code | M | 应答码 00-成功 |
|
|
|
-| resp_msg | M | 应答信息 |
|
|
|
-| mch_id | M | 商户ID,由AllPay分配 |
|
|
|
-| trade_type | M | 交易类型 |
|
|
|
-| trade_time | M | 交易时间 |
|
|
|
-| trade_no | M | 交易订单号 |
|
|
|
-| order_amount | M | 订单金额 如100元,表示为100或100.00 |
|
|
|
-| order_currency | M | 订单币种 人民币填写“CNY”,美元填写"USD" |
|
|
|
-| sign_type | M | SHA256 |
|
|
|
-| sign | M | 签名 |
|
|
|
+| 参数名称 | 必填 | 使用说明 |
|
|
|
+| ------------- | ---- | -------------------------------------- |
|
|
|
+| resp_code | M | 应答码 00-成功 |
|
|
|
+| resp_msg | M | 应答信息 |
|
|
|
+| mch_id | M | 商户ID,由AllPay分配 |
|
|
|
+| trade_type | M | 交易类型 |
|
|
|
+| trade_time | M | 交易时间 |
|
|
|
+| trade_no | M | 交易订单号 |
|
|
|
+| order_amount | C | trade_type 为PURC,PAUT,PAUC时返回 |
|
|
|
+| refund_amount | C | trade_type 为REFD时返回 |
|
|
|
+| currency | C | trade_type 为PURC,PAUT,PAUC,REFD时返回 |
|
|
|
+| sign_type | M | SHA256 |
|
|
|
+| sign | M | 签名 |
|
|
|
|
|
|
举例如下:
|
|
|
|
|
@@ -410,7 +433,7 @@ card_no=6222020302030778784&expiry_date=0824&mch_id=000000000000015&order_amount
|
|
|
mch_id:"000000000000015",
|
|
|
trade_type:"PURC",
|
|
|
order_amount:"100",
|
|
|
- order_currency:"CNY",
|
|
|
+ currency:"CNY",
|
|
|
trade_time:"20180821120001",
|
|
|
trade_no:"5389535343453",
|
|
|
sign_type:"SHA256",
|