|
|
@@ -8,14 +8,14 @@
|
|
|
|
|
|
#### 1. 概述
|
|
|
|
|
|
-本文档规定了商户与AllPay之间的海关申报产品进行联机交易时使用的报文接口
|
|
|
+本文档规定了商户与AllPay之间的海关申报产品进行联机交易时使用的报文接口。
|
|
|
|
|
|
#### 2. 验签说明
|
|
|
|
|
|
```
|
|
|
-1.对于发送到 ALLPAY 系统的 POST 请求报文，其中所有传入参数(除 signature 参数外)按照字段名的 ASCII 码从小到大排序后(字典序)，使用 URL 键值对的格式(即 key1=value1&key2=value2...)拼接成字符串 String1。
|
|
|
+1.对于发送到 AllPay 系统的 POST 请求报文，其中所有传入参数(除 signature 参数外)按照字段名的 ASCII 码从小到大排序后(字典序)，使用 URL 键值对的格式(即 key1=value1&key2=value2...)拼接成字符串 String1。
|
|
|
|
|
|
-2.在 String1 最后直接拼接(不需要用“&”连接)双方约定的签名密钥 K1(接入时 ALLPAY 时分配)，得到 stringSignTemp 字符串,并对 stringSignTemp 进行 md5 运算，得到 signature 的值。
|
|
|
+2.在 String1 最后直接拼接(不需要用“&”连接)双方约定的签名密钥 Key(接入 AllPay 时分配)，得到 stringSignTemp 字符串，并对 stringSignTemp 进行 md5 运算，得到 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=VER000000005
|
|
|
```
|
|
|
@@ -27,7 +27,7 @@
|
|
|
##### 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 |
|
|
|
|
|
|
@@ -45,14 +45,14 @@
|
|
|
| productPrice | String(12) | M | 商品金额：如 100 元，表示为 100 或 100.00 |
|
|
|
| transportPrice | String(12) | M | 运费金额：如 100 元，表示为 100 或 100.00 |
|
|
|
| tarPrice | String(12) | M | 关税金额：如 100 元，表示为 100 或 100.00 |
|
|
|
-| orderCurrency | String(3) | M | 订单币种：ISO标准 如：人民币填写“CNY”,美元填写"USD" |
|
|
|
+| orderCurrency | String(3) | M | 订单币种：ISO标准。如：人民币填写“CNY”，美元填写"USD" |
|
|
|
| customs_code | String(64) | M | 商户海关备案编码 |
|
|
|
| customs_name | String(128) | M | 商户海关备案名称 |
|
|
|
| customs_place | String(128) | M | 海关，详见附件 1 海关列表 |
|
|
|
| name | String(64) | M | 消费者姓名 |
|
|
|
| IDCard | String(32) | M | 消费者身份证号 |
|
|
|
| customerAccount | String(64) | M | 消费者在商家的注册帐号 |
|
|
|
-| businessType | String(2) | C | 保税进口:1 直邮进口:2 如果不填，默认为1保税进口，视申报海关需要填写 |
|
|
|
+| businessType | String(2) | O | 保税进口：1，直邮进口：2。如果不填，默认为1保税进口，视申报海关需要填写 |
|
|
|
| merID | String(15) | M | 商户 ID，由AllPay 分配 |
|
|
|
| acqID | String(11) | M | 收单行 ID "99020344" |
|
|
|
| paymentSchema | String(10) | M | 渠道代码。银联：UP，微信：WX，支付宝：AP/APMP |
|
|
|
@@ -102,7 +102,7 @@
|
|
|
2.响应报文格式
|
|
|
|
|
|
| 参数 | 类型 | 属性 | 描述 |
|
|
|
-| -------------- | ----------- | ---- | --------------------------------------------- |
|
|
|
+| ------------- | ----------- | ---- | --------------------------------------------- |
|
|
|
| version | String(12) | M | 统一填写为“VER000000005” |
|
|
|
| charSet | String(6) | M | 统一填写为“UTF-8” |
|
|
|
| transType | String(4) | M | “DECL” |
|
|
|
@@ -179,8 +179,8 @@
|
|
|
|
|
|
银联渠道申请报关告后应答码为处理中，需要查询来确定报关状态，银联海关申报查询为04时，表示后端系统处理中，需要过段时间再发起申报查询。
|
|
|
|
|
|
-| 应答码 | 描 述 |
|
|
|
-| ------ | ------------ |
|
|
|
+| 应答码 | 描述 |
|
|
|
+| ------ | ----------- |
|
|
|
| 00 | 成功 |
|
|
|
| 01 | 失败 |
|
|
|
| 04 | 处理中 |
|
