API REFERENCE

海关申报查询

YabandPay 文档·更新于 2026年10月26日

商户通过订单号查询提交的订单报关信息

参数	类型	描述	是否必填
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=YOUR_CASHIER_UID"

得到的 stringA 使用 secret_key做签名

得到的签名如下：

"YOUR_SIGNATURE"

提交示例：

{
	"user": "YOUR_CASHIER_UID",
	"sign": "YOUR_SIGNATURE",
	"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	海关接口异常