|
|
@@ -7,21 +7,20 @@
|
|
|
#### 1.Overview
|
|
|
|
|
|
AllPay provides customers with unified API access to help them implement fast, secure and centralized access payment channels.
|
|
|
+
|
|
|
#### 2.Transaction process
|
|
|
|
|
|
|
|
|
+#### 3.Description of verifying the signature
|
|
|
|
|
|
-
|
|
|
-#### 3. 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.
|
|
|
|
|
|
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: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.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=VER0000000022f2c77e3718c47cfb47a89a6fbc9d361
|
|
|
```
|
|
|
|
|
|
-
|
|
|
#### 4. Common interface
|
|
|
|
|
|
Common interface includes notification, asynchronous notification of transactions, transaction inquiry, refund, refund inquiry interface
|
|
|
@@ -61,14 +60,10 @@ This field is a list of common fields, sending, every channel needs some channel
|
|
|
| signType | String(3) | M | MD5 |
|
|
|
| signature | String(32) | M | MD5 signature |
|
|
|
|
|
|
-
|
|
|
-
|
|
|
2.Jump transformation Purchase interface response message
|
|
|
|
|
|
The merchant needs to provide an HTTP/HTTPS protocol interface that is included in the parameters passed to the SDK, the backURL. After the payment is complete, the AllPay server will call the backURL as a Get, informing the payment result.
|
|
|
|
|
|
-
|
|
|
-
|
|
|
| Parameter | Type | Required | Description |
|
|
|
| ------------- | ------------ | -------- | ------------------------------------------------------------ |
|
|
|
| version | String(12) | M | "VER000000002" |
|
|
|
@@ -88,7 +83,7 @@ This field is a list of common fields, sending, every channel needs some channel
|
|
|
| RespCode | String(2) | M | 00 stands for success; 01 stands for fail. |
|
|
|
| RespMsg | String(20) | M | Response message, all English characters |
|
|
|
| transTime | String(14) | M | Transaction time, format :" yyymmddhhmmss" |
|
|
|
-| GWTime | String(14) | M | YYYYMMDDHHMMSS this should be a GWtime, currently is local transaction time |
|
|
|
+| GWTime | String(14) | M | YYYYMMDDHHMMSS this should be a GWtime, currently is local transaction time.|
|
|
|
| signType | String(3) | M | MD5 |
|
|
|
| signature | String(32) | M | MD5 signature |
|
|
|
|
|
|
@@ -229,9 +224,9 @@ This interface provides the function of refund transaction for access merchants.
|
|
|
|
|
|
##### 5.2 UP(Transition）
|
|
|
|
|
|
-| No. | Field Name | Max.Length | Type | Parameter name | Comment |
|
|
|
-| ---- | -------------------- | ---------- | ---- | -------------- | ------------------------------------------------------------ |
|
|
|
-| 1 | UnionPay card number | 19 | Text | uCardNumber | The overseas UnionPay channel is applicable to the UnionPay excellent plan. Can not upload, if you need to fill in the bank card number in advance, then send this field. |
|
|
|
+| No. | Field Name | Max.Length | Type | Parameter name | Comment |
|
|
|
+| ---- | -------------------- | ---------- | ---- | -------------- | ------------------------------------------------ |
|
|
|
+| 1 | UnionPay card number | 19 | Text | uCardNumber | The overseas UnionPay channel is applicable to the UnionPay excellent plan. Can not upload, if you need to fill in the bank card number in advance, then send this field.|
|
|
|
|
|
|
```javascript
|
|
|
Test cards:
|
|
|
@@ -253,8 +248,8 @@ SMS Code on Mobile: 123456
|
|
|
|
|
|
##### 5.3 WX(Includes transition and parameter return）
|
|
|
|
|
|
-| No. | Field Name | Max.Length | Type | Parameter name | Comment |
|
|
|
-| ---- | ------------------------- | ---------- | ---- | -------------- | ------------------------------------------------------------ |
|
|
|
+| No. | Field Name | Max.Length | Type | Parameter name | Comment |
|
|
|
+| ---- | ------------------------- | ---------- | ---- | -------------- | ------------------------------------------- |
|
|
|
| 1 | Transaction scenario code | 16 | Text | code | 1.“NATIVE“：Return the URL value of WeChat payment collection for parameter return, ask the merchant to convert it into QR code, generate the front interface of payment, and prompt the user to scan the code to pay; 2.“QUICK”：It's jump mode, open the front-end page provided by AllPay, which contains WeChat QR code. |
|
|
|
|
|
|
##### 5.4 PPRO(Transition）
|
|
|
@@ -268,7 +263,6 @@ SMS Code on Mobile: 123456
|
|
|
| consumerref | M | Text | Unique reference identifying the consumer, has to satisfy the regular expression [A-Za-z0-9.%,&/+*$-]{1,20} |
|
|
|
|
|
|
Note: AstroPay Card is available for currency USD and country codes BO, BR, CL, CN, CO, CR, MX, PE, UY, VE.
|
|
|
-
|
|
|
|
|
|
###### 5.4.2 PPRO_AD
|
|
|
|
|
|
@@ -526,7 +520,7 @@ Note: SingPost (Singapore) is only available for currency SGD and country code S
|
|
|
The account holder name passed in the request has to be in the format <firstname><space><lastname>, with
|
|
|
lastname having a minimum length of two characters and the total string a minimum length of five. Multiple
|
|
|
first names are ok, valid examples are “John Dorian”, “William Charles Dickinson”. If these conditions are not
|
|
|
-met, the system will not accept the request
|
|
|
+met, the system will not accept the request.
|
|
|
```
|
|
|
|
|
|
###### 5.4.24 PPRO_SB
|
