|
@@ -9,7 +9,7 @@
|
|
|
AllPay 为客户提供统一的api接入,以帮助客户实 现快速、安全、集中式的接入支付渠道。
|
|
|
#### 2.交易流程
|
|
|
![image](https://git.allpayx.com/OpenAPI/b2c/raw/master/images/pc_flowsheet.png)
|
|
|
-
|
|
|
+
|
|
|
#### 3.通用API说明
|
|
|
商户服务器和 AllPay 网关对接的通用接口,每个渠道都具有的功能,包括:消费,退款,查询接口。
|
|
|
|
|
@@ -27,11 +27,31 @@ AllPay 为客户提供统一的api接入,以帮助客户实 现快速、安全
|
|
|
消费接口 |https://testapi.allpayx.com/pay |https://api.allpayx.com/pay
|
|
|
查询接口 |https://testapi.allpayx.com/pay |https://api.allpayx.com/pay
|
|
|
退款接口 |https://testapi.allpayx.com/pay |https://api.allpayx.com/pay
|
|
|
-
|
|
|
-##### 3.3. 消费交易接口
|
|
|
+
|
|
|
+**3.3.交易信息错误返回参数说明**
|
|
|
+
|
|
|
+若商户请求AllPay网关时,请求的参数错误或参数缺失时,AllPay网关会将错误信息以JSON格式返回给客户端,供商户解析调用,以下是相关错误信息返回参数的说明
|
|
|
+
|
|
|
+| 参数应答码code | 对应应答信息msg |
|
|
|
+| -------------- | -------------------------------------- |
|
|
|
+| U1 | Clientid not found |
|
|
|
+| U2 | Signature error |
|
|
|
+| V1 | Parameter missing |
|
|
|
+| T1 | Parameter missing(version或tranType) |
|
|
|
+| R1 | Orderno repeat |
|
|
|
+| C1 | Order currency is not set |
|
|
|
+| P1 | paychannel error |
|
|
|
+| T1 | Illegal request address |
|
|
|
+| E1 | Exceed the limit |
|
|
|
+| T2 | Txntype error |
|
|
|
+| 99 | System error |
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+##### 3.4. 消费交易接口
|
|
|
|
|
|
1. 请求报文格式
|
|
|
-
|
|
|
+
|
|
|
下面列举的字段为通用字段,每个渠道都需要上送,部分渠道有渠道专属字段,具体字段请到该渠道的专属渠到字段说明处查看. 消费接口分为跳转型和参数返回型,默认为跳转型,参数返回型会在 第4章(渠道专属配置)里面说明
|
|
|
|
|
|
序号 |名称 |长度|类型|参数名称|备注
|
|
@@ -52,9 +72,9 @@ AllPay 为客户提供统一的api接入,以帮助客户实 现快速、安全
|
|
|
14|交易时间 |14 |文本|transTime |交易时间,格式:"yyyyMMddHHmmss"
|
|
|
15|签名类型 |3 |文本|signType |MD5
|
|
|
16|签名 |32 |文本|signature |采用 MD5 签名
|
|
|
-
|
|
|
|
|
|
-
|
|
|
+
|
|
|
+
|
|
|
2. 跳转型消费接口响应报文
|
|
|
|
|
|
商户需要提供一个 http/https 协议的接口,包含在参数里传递给 SDK,即 backURL。AllPay
|
|
@@ -86,17 +106,17 @@ AllPay 为客户提供统一的api接入,以帮助客户实 现快速、安全
|
|
|
19|签名类型 |3 |文本|signType |MD5
|
|
|
20|签名 |32 |文本|signature |采用 MD5 签名
|
|
|
|
|
|
-##### 3.4. 查询交易接口
|
|
|
+##### 3.5. 查询交易接口
|
|
|
+
|
|
|
|
|
|
|
|
|
-
|
|
|
1. 接口说明
|
|
|
-
|
|
|
+
|
|
|
该接口为接入商家提供交易查询的功能。
|
|
|
|
|
|
2. 请求报文格式
|
|
|
|
|
|
-
|
|
|
+
|
|
|
序号 |名称 |长度|类型|参数名称|备注
|
|
|
-----|-----|----|----|------|------
|
|
|
1|版本号|12|文本|version |统一填写为“VER000000002”
|
|
@@ -114,7 +134,7 @@ AllPay 为客户提供统一的api接入,以帮助客户实 现快速、安全
|
|
|
|
|
|
3. 响应报文格式
|
|
|
|
|
|
-
|
|
|
+
|
|
|
序号 |名称 |长度|类型|参数名称|备注
|
|
|
-----|-----|----|----|------|------
|
|
|
1|版本号|12|文本|version |统一填写为“VER000000002”
|
|
@@ -131,7 +151,7 @@ AllPay 为客户提供统一的api接入,以帮助客户实 现快速、安全
|
|
|
12|签名类型 |3 |文本|signType |MD5
|
|
|
13|签名 |32 |文本|signature |采用 MD5 签名
|
|
|
|
|
|
-##### 3.5. 退款交易接口
|
|
|
+##### 3.6. 退款交易接口
|
|
|
|
|
|
1.接口功能说明
|
|
|
|
|
@@ -154,10 +174,10 @@ AllPay 为客户提供统一的api接入,以帮助客户实 现快速、安全
|
|
|
11|交易时间 |14 |文本|transTime |交易时间,格式:"yyyyMMddHHmmss"
|
|
|
12|签名类型 |3 |文本|signType |MD5
|
|
|
13|签名 |32 |文本|signature |采用 MD5 签名
|
|
|
-
|
|
|
+
|
|
|
3.响应报文格式
|
|
|
|
|
|
-
|
|
|
+
|
|
|
序号 |名称 |长度|类型|参数名称|备注
|
|
|
-----|-----|----|----|------|------
|
|
|
1|版本号|12|文本|version |统一填写为“VER000000002”
|
|
@@ -173,9 +193,9 @@ AllPay 为客户提供统一的api接入,以帮助客户实 现快速、安全
|
|
|
11|GW 处理时间 |14 |文本|GWTime |YYYYMMDDHHMMSS,为 GW 时间,目前为本地交易时间
|
|
|
12|签名类型 |3 |文本|signType |MD5
|
|
|
13|签名 |32 |文本|signature |采用 MD5 签名
|
|
|
-
|
|
|
-#### 5.渠道专属配置
|
|
|
-##### 5.1 EB渠道(跳转)
|
|
|
+
|
|
|
+#### 4.渠道专属配置
|
|
|
+##### 4.1 EB渠道(跳转)
|
|
|
|
|
|
|
|
|
序号 |名称 |长度|类型|参数名称|备注
|
|
@@ -183,26 +203,26 @@ AllPay 为客户提供统一的api接入,以帮助客户实 现快速、安全
|
|
|
1| 姓名 |32 |文本|trxn_firstname |This is name of the customer who is doing the transaction.
|
|
|
2| 邮箱 |40 |文本|trxn_email_id |this is email id of the customer who is doing transaction.
|
|
|
3|电话 |20 |文本|trxn_phone|Phone number of the customer.
|
|
|
-
|
|
|
-##### 5.2 UP渠道(跳转)
|
|
|
+
|
|
|
+##### 4.2 UP渠道(跳转)
|
|
|
|
|
|
序号 |名称 |长度|类型|参数名称|备注
|
|
|
-----|-----|----|----|------|------
|
|
|
1| 银联卡号 |19 | 文本|uCardNumber |境外银联通道,适用于银联优计划。可以不上送,若需要提前填入银行卡号,则上送此字段。
|
|
|
-
|
|
|
-##### 5.3 WX渠道(含跳转和参数返回)
|
|
|
+
|
|
|
+##### 4.3 WX渠道(含跳转和参数返回)
|
|
|
|
|
|
序号 |名称 |长度|类型|参数名称|备注
|
|
|
-----|-----|----|----|------|------
|
|
|
1| 交易场景代码|16 | 文本|code |1.“NATIVE“:为参数返回方式,返回微信收款URL值, 要求商户将其转换为 QR 码,自己生成支付前端界 面,提示用户扫码付款; 2.“QUICK”:为跳转方式,打开 AllPay 提供的前端页面,页面包含微信 QR 码
|
|
|
-
|
|
|
-#### 6.测试账户
|
|
|
-
|
|
|
+
|
|
|
+#### 5.测试账户
|
|
|
+
|
|
|
请注意,支付宝、财付通交易需要用中国实名认证的账户进行测试交易,所有测试交
|
|
|
易不提供清算服务,请用小额测试。
|
|
|
|
|
|
以下是银联渠道测试卡,仅用于测试使用:
|
|
|
-
|
|
|
+
|
|
|
```
|
|
|
信用卡:5200831111111113
|
|
|
手机:13552535506
|
|
@@ -220,16 +240,16 @@ CVN2:248
|
|
|
|
|
|
```
|
|
|
|
|
|
-#### 7.技术支持
|
|
|
+#### 6.技术支持
|
|
|
|
|
|
如果您在调试时遇到问题,请我们联系:support@allpayx.com。
|
|
|
|
|
|
|
|
|
-
|
|
|
|
|
|
|
|
|
|
|
|
-
|
|
|
+
|
|
|
+
|
|
|
|
|
|
|
|
|
|