海关申报查询
商户通过订单号查询提交的订单报关信息
API URL：https://mapi.yabandpay.com/Payments
Method：POST
POST data type：Json
| 参数 | 类型 | 描述 | 是否必填 |
|---|---|---|---|
| user | String | 收银员账号的UID | 必填 |
| sign | String | 签名 | 必填 |
| method | String | v3.CustomDeclareQuery | 必填 |
| time | Long | 时间戳 | 必填 |
- 参数
| 参数 | 类型 | 描述 | 是否必填 |
|---|---|---|---|
| trade_id | String | YabandPay交易ID | 必填 |
| customs | String | 海关名称 | 必填 |
签名示例：
拼接为URL方式并排序后的字符串
"customs=NINGBO&method=v3.CustomDeclareQuery&time=1560499094&trade_id=dd11d082-810d-c8b7-3669-b784c466759b&user=016683"
得到的 stringA 使用 secret_key做签名
得到的签名如下：
"64d0640853475f2d9b7cb7d89ca98bb141ac85b923c191eb0eabd4f8d9c79ddc"
提交示例：
{
"user": "016683",
"sign": "64d0640853475f2d9b7cb7d89ca98bb141ac85b923c191eb0eabd4f8d9c79ddc",
"method": "v3.CustomDeclareQuery",
"time": 1560753647,
"data": {
"trade_id": "847b175e-f8f4-d362-d078-52092b412b1c",
"customs": "NINGBO"
}
}
返回示例：
{
"status": true,
"code": "200",
"data": {
"data": [
{
"customs": "NINGBO",
"duty": "",
"fee_type": "EUR",
"mch_customs_no": "31222699S7",
"modify_time": "2024-06-19T08:21:18Z",
"order_fee": "10",
"product_fee": "10",
"state": "SUCCESS",
"sub_order_id": "e0721a7f957e8e55dfbb5c7bcb4441d6",
"sub_order_no": "1234567890",
"transport_fee": "0",
"cert_check_result": "SAME"
},
{
"customs": "NINGBO",
"duty": "",
"fee_type": "EUR",
"mch_customs_no": "31222699S7",
"modify_time": "2024-06-19T08:20:53Z",
"order_fee": "10",
"product_fee": "10",
"state": "SUCCESS",
"sub_order_id": "05cbd13d104bb4ea542cc66550d16ac8",
"sub_order_no": "123456789",
"transport_fee": "0",
"cert_check_result": "SAME"
}
]
},
"message": ""
}
State状态如下：
| 状态 | 描述 |
|---|---|
| UNDECLARED | 未申报 （该状态表示已提交报关,等待海关处理中,无需再次提交） |
| SUBMITTED | 申报已提交（订单已经送海关，商户重新申报，并且海关还有修改接口，那么记录的状态会是这个） |
| PROCESSING | 申报中 |
| SUCCESS | 申报成功 |
| FAIL | 申报失败 |
| EXCEPT | 海关接口异常 |