|
@@ -4,42 +4,41 @@ Common interface between merchant server and AllPay gateway, each channel has fu
|
|
|
|
|
|
## 3.1. Description of verifying the signature
|
|
## 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.
|
|
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.
|
|
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:
|
|
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
|
|
|
|
|
|
+```js
|
|
|
|
+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
|
|
## 3.2. General API access address
|
|
|
|
|
|
Transaction Type |Test Address|Production 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
|
|
|
|
-
|
|
|
|
|
|
+ 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
|
|
## 3.3. Purchase interface
|
|
|
|
|
|
1. Request message format
|
|
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
|
|
|
|
|
|
+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.
|
|
|
|
|
|
+ 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
|
|
10|Merchant ID |15 |Text|merID |Merchant ID, assigned by AllPay
|
|
11|Acquirer ID |11 |Text|acqID |"99020344"
|
|
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)
|
|
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)
|
|
@@ -157,5 +156,4 @@ This interface provides the function of refund transaction for access merchants.
|
|
10|Transaction Time |14 |Text|transTime |Transaction time, format :" yyymmddhhmmss"
|
|
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
|
|
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
|
|
12|Signature Type |3 |Text|signType |MD5
|
|
- 13|Signature Data |32 |Text|signature |MD5 signature
|
|
|
|
-
|
|
|
|
|
|
+ 13|Signature Data |32 |Text|signature |MD5 signature
|