海关申报提交

小贴士

注意：

1.每个订单只能有一条非拆单数据和多条拆单数据，拆单数据中 sub_order_no (商户子订单号)相同时将会视为同一条数据。

2.如需修改报关信息，action_type 类型请传 MODIFY, 修改只能对商户备案号、备案名称、海关编码和金额、用户证件信息做修改,如果为拆单数据，则需传递 sub_order_no 来对应修改数据。

3.如果某笔交易已请求报送海关，但电子口岸丢单，可以使用重推接口, 重推时，需要保持报关流水号和原始请求一致。

4.海关申报接口的金额单位是分。

5.海关申报currency是CNY(用户支付的人民币金额)可通过订单查询。

• 参数

customs字段如下：

微信支付报关字段

TIANJIN (需要推送订单至天津海关时，需要在商户管理后台同时配置天津海关备案信息与天津国检备案信息；调用报关接口时只需推送天津海关，即请求一次报关接口。)

支付宝报关字段

签名示例：

拼接为URL方式并排序后的字符串

"customs=NINGBO&mch_customs_no=3302462090&mch_name=宁波保税区嘉里大通物流有限公司&method=v3.CustomDeclareOrder&time=1560499094&trade_id=4760a968-4c5d-1e7e-3b88-89641af6e041&user=YOUR_CASHIER_UID"

得到的 stringA 使用 secret_key做签名

得到的签名如下：

"YOUR_SIGNATURE"

提交示例：

{
	"user": "YOUR_CASHIER_UID",
	"sign": "YOUR_SIGNATURE",
	"method": "v3.CustomDeclareOrder",
	"time": 1560499094,
	"data": {
		"trade_id": "4760a968-4c5d-1e7e-3b88-89641af6e041",
		"customs": "NINGBO",
        "mch_customs_no": "3302462090",
        "mch_name": "宁波保税区嘉里大通物流有限公司"
	}
}

报关返回示例：

{
    "status": true,
    "code": "200",
    "data": {
        "appid": "",
        "return_code":"SUCCESS",
        "result_code":"SUCCESS",
        "mchid": "3302462090",
        "out_trade_no": "4434a6e235e81cde4aee954c0031ad96",
        "state": "SUCCESS",
        "sub_order_id": "e0721a7f957e8e55dfbb5c7bcb4441d6",
        "sub_order_no": "1234567890",
        "transaction_id": "2024061922001467961423939655",
        "verify_department": "OTHERS",
        "verify_department_trade_id": "2024061922001467961423939655",
        "cert_check_result": "SAME", //订购人和支付人身份信息校验结果(UNCHECKED 商户未上传订购人身份信息 SAME 商户上传的订购人身份信息与支付人身份信息一致 DIFFERENT 商户上传的订购人身份信息与支付人身份信息不一致)
        "transId": "20240619161756813048",
        "customs_declarations_id": "e0721a7f957e8e55dfbb5c7bcb4441d6"
    },
    "message": ""
}

State状态如下：