|
|
@@ -1,4 +1,4 @@
|
|
|
-# AllPay报关接口规范说明文档V5.0.0
|
|
|
+# GoAllPay报关接口规范说明文档V5.0.0
|
|
|
>[上海偶可贝网络科技有限公司](https://www.allpayx.com)
|
|
|
>
|
|
|
>- 版本信息：中文 V5.0.0
|
|
|
@@ -6,25 +6,25 @@
|
|
|
|
|
|
## 1.概述
|
|
|
|
|
|
-本文档规定了商户与AllPay之间的海关申报产品进行联机交易时使用的报文接口。
|
|
|
+本文档规定了商户与GoAllPay之间的海关申报产品进行联机交易时使用的报文接口。
|
|
|
|
|
|
## 2.验签说明
|
|
|
|
|
|
```
|
|
|
-1.对于发送到 AllPay 系统的 POST 请求报文，其中所有传入参数(除 signature 参数外)按照字段名的 ASCII 码从小到大排序后(字典序)，使用 URL 键值对的格式(即 key1=value1&key2=value2...)拼接成字符串 String1。
|
|
|
+1.对于发送到 GoAllPay 系统的请求报文，其中所有传入参数(除 signature 参数外)按照字段名的 ASCII 码从小到大排序后(字典序)，使用 URL 键值对的格式(即 key1=value1&key2=value2...)拼接成字符串 String1。
|
|
|
|
|
|
-2.在 String1 最后直接拼接（不需要用“&”连接）双方约定的签名密钥 Key（接入 AllPay 时分配），得到 stringSignTemp 字符串，并对 stringSignTemp 进行加密运算，得到 signature 的值。
|
|
|
+2.在 String1 最后直接拼接（不需要用“&”连接）双方约定的签名密钥 Key（接入 GoAllPay 时分配），得到 stringSignTemp 字符串，并对 stringSignTemp 进行加密运算，得到 signature 的值。
|
|
|
|
|
|
3.示例签名串 IDCard=411422199808080415&acqID=99020344&charSet=UTF-8&customerAccount=ab123456&customs_code=3302462548&customs_name=AAAA&customs_place=CUSTOMSHEADOFFICE&merID=000000000000015&merReserve=dd&name=shi kai feng&orderCurrency=CNY&orderNum=kfvWipRWHEboJPh71m7lXkUILutt&origOrderNum=VzVJhPdX18tDu3vgGfNOIgh71LjY&paymentSchema=UP&productPrice=80&signType=MD5&transTime=20181229171552&transType=DECL&transportPrice=10&version=VER0000000052f2c77e3718c47cfb47a89a6fbc9d361
|
|
|
```
|
|
|
|
|
|
## 3.通用API说明
|
|
|
|
|
|
-商户服务器和 AllPay 网关对接的海关申报相关接口，包括申报、申报查询、申报更新。
|
|
|
+商户服务器和 GoAllPay 网关对接的海关申报相关接口，包括申报、申报查询、申报更新。
|
|
|
|
|
|
### 3.1 通用 API 接入地址
|
|
|
|
|
|
-| 交易名称 | 开发调试地址 | 生产交易地址 |
|
|
|
+| 交易名称 | 测试交易地址 | 生产交易地址 |
|
|
|
| ------- | ----------------------------------------- | ------------------------------------------ |
|
|
|
| 申报 | https://testapi.allpayx.com/custom/declare | https://api.allpayx.com/custom/declare |
|
|
|
| 申报查询 | https://testapi.allpayx.com/custom/query | https://api.allpayx.com/custom/query |
|
|
|
@@ -53,7 +53,7 @@
|
|
|
| IDCard | String(32) | M | 消费者身份证号 |
|
|
|
| customerAccount | String(64) | M | 消费者在商家的注册帐号 |
|
|
|
| businessType | String(2) | O | 保税进口：1，直邮进口：2。如果不填，默认为1保税进口，视申报海关需要填写 |
|
|
|
-| merID | String(15) | M | 商户 ID，由AllPay 分配 |
|
|
|
+| merID | String(15) | M | 商户 ID，由GoAllPay 分配 |
|
|
|
| acqID | String(11) | M | 收单行 ID "99020344" |
|
|
|
| paymentSchema | String(10) | M | 渠道代码。银联：UP，微信：WX，支付宝：AP/APMP |
|
|
|
| transTime | String(14) | M | 交易时间，格式:"yyyyMMddHHmmss" |
|
|
|
@@ -73,9 +73,9 @@
|
|
|
| customs_code | String(64) | M | 商户在海关报备的编码 |
|
|
|
| customs_name | String(128) | M | 商户在海关报备的名称 |
|
|
|
| customs_place | String(128) | M | 海关，详见附件 1 海关列表 |
|
|
|
-| allpayOrderNum | String(64) | M | AllPay系统的转换商户订单号 |
|
|
|
+| allpayOrderNum | String(64) | M | GoAllPay系统的转换商户订单号 |
|
|
|
| schemaTransId | String(64) | M | 支付渠道的交易ID。<br/>注：银联报关需要用该字段作为物流单以及销售单的报关单号 |
|
|
|
-| merID | String(15) | M | 商户 ID，由AllPay 分配 |
|
|
|
+| merID | String(15) | M | 商户 ID，由GoAllPay 分配 |
|
|
|
| acqID | String(11) | M | 收单行 ID "99020344" |
|
|
|
| paymentSchema | String(10) | M | 渠道代码。银联：UP，微信：WX，支付宝：AP/APMP |
|
|
|
| transTime | String(14) | M | 交易时间，格式："yyyyMMddHHmmss" |
|
|
|
@@ -92,7 +92,7 @@
|
|
|
| charSet | String(6) | M | 统一填写为“UTF-8” |
|
|
|
| transType | String(4) | M | 查询填写“INQY” |
|
|
|
| orderNum | String(60) | M | 交易ID |
|
|
|
-| merID | String(15) | M | 商户 ID，由AllPay 分配 |
|
|
|
+| merID | String(15) | M | 商户 ID，由GoAllPay 分配 |
|
|
|
| acqID | String(11) | M | 收单行 ID "99020344" |
|
|
|
| paymentSchema | String(10) | M | 渠道代码。银联：UP，微信：WX，支付宝：AP/APMP |
|
|
|
| transTime | String(14) | M | 交易时间，格式:"yyyyMMddHHmmss" |
|
|
|
@@ -112,9 +112,9 @@
|
|
|
| customs_code | String(64) | M | 商户在海关报备的编码 |
|
|
|
| customs_name | String(128) | M | 商户在海关报备的名称 |
|
|
|
| customs_place | String(128) | M | 海关，详见附件 1 海关列表 |
|
|
|
-| allpayOrderNum | String(64) | M | AllPay系统的转换商户订单号 |
|
|
|
+| allpayOrderNum | String(64) | M | GoAllPay系统的转换商户订单号 |
|
|
|
| schemaTransId | String(64) | M | 支付渠道的交易ID。 |
|
|
|
-| merID | String(15) | M | 商户 ID，由 AllPay 分配 |
|
|
|
+| merID | String(15) | M | 商户 ID，由 GoAllPay 分配 |
|
|
|
| acqID | String(11) | M | 收单行 ID "99020344" |
|
|
|
| paymentSchema | String(10) | M | 渠道代码。银联：UP，微信：WX，支付宝：AP/APMP |
|
|
|
| transTime | String(14) | M | 交易时间，格式："yyyyMMddHHmmss" |
|
|
|
@@ -144,7 +144,7 @@
|
|
|
| IDCard | String(32) | M | 消费者身份证号 |
|
|
|
| customerAccount | String(64) | M | 消费者在商家的注册帐号 |
|
|
|
| businessType | String(2) | O | 保税进口：1，直邮进口：2。如果不填，默认为1保税进口，视申报海关需要填写 |
|
|
|
-| merID | String(15) | M | 商户 ID，由AllPay 分配 |
|
|
|
+| merID | String(15) | M | 商户 ID，由GoAllPay 分配 |
|
|
|
| acqID | String(11) | M | 收单行 ID "99020344" |
|
|
|
| paymentSchema | String(10) | M | 渠道代码。银联：UP，微信：WX，支付宝：AP/APMP |
|
|
|
| transTime | String(14) | M | 交易时间，格式:"yyyyMMddHHmmss" |
|
|
|
@@ -164,9 +164,9 @@
|
|
|
| customs_code | String(64) | M | 商户在海关报备的编码 |
|
|
|
| customs_name | String(128) | M | 商户在海关报备的名称 |
|
|
|
| customs_place | String(128) | M | 海关，详见附件 1 海关列表 |
|
|
|
-| allpayOrderNum | String(64) | M | AllPay系统的转换商户订单号 |
|
|
|
+| allpayOrderNum | String(64) | M | GoAllPay系统的转换商户订单号 |
|
|
|
| schemaTransId | String(64) | M | 支付渠道的交易ID |
|
|
|
-| merID | String(15) | M | 商户 ID，由AllPay 分配 |
|
|
|
+| merID | String(15) | M | 商户 ID，由GoAllPay 分配 |
|
|
|
| acqID | String(11) | M | 收单行 ID "99020344" |
|
|
|
| paymentSchema | String(10) | M | 渠道代码。银联：UP，微信：WX，支付宝：AP/APMP |
|
|
|
| transTime | String(14) | M | 交易时间，格式："yyyyMMddHHmmss" |
|
