訂單附加信息查詢接口
應(yīng)用場景
商戶通過訂單號查詢提交的訂單附加信息。如果是微信收集的實名信息，查詢接口不返回實名信息內(nèi)容
接口鏈接
URL地址： https://api.mch.weixin.qq.com/cgi-bin/mch/customs/customdeclarequery
是否需要證書
否
請求參數(shù)
請求方式：post 數(shù)據(jù)格式：xml 簽名方式：MD5
| 字段名 | 變量名 | 必填 | 類型 | 示例值 | 說明 |
|---|---|---|---|---|---|
| 簽名類型 | sign_type | 否 | String(32) | MD5 | 暫只支持MD5 |
| 簽名 | sign | 是 | String(32) | C380BEC2BFD727A4B6845133519F3AD6 | 簽名，詳見簽名生成算法 |
| 公眾賬號ID | appid | 是 | String(32) | wxd678efh567hg6787 | 微信分配的公眾賬號ID |
| 商戶號 | mch_id | 是 | String(32) | 1230000109 | 微信支付分配的商戶號 |
| 商戶訂單號 | out_trade_no | 四選一 | String(32) | 20150806125346 | 商戶側(cè)系統(tǒng)內(nèi)部的訂單號, out_trade_no、transaction_id、sub_order_no、sub_order_id至少一個必填，同時存在時優(yōu)先級如下：sub_order_id> sub_order_no> transaction_id> out_trade_no |
| 微信支付訂單號 | transaction_id | String(28) | 1000320306201511078440737890 | 微信支付系統(tǒng)內(nèi)部訂單號, out_trade_no、transaction_id、sub_order_no、sub_order_id至少一個必填，同時存在時優(yōu)先級如下：sub_order_id> sub_order_no> transaction_id> out_trade_no | |
| 商戶子訂單號 | sub_order_no | String(32) | 20150806125346 | 商戶側(cè)系統(tǒng)內(nèi)部子訂單號, out_trade_no、transaction_id、sub_order_no、sub_order_id至少一個必填，同時存在時優(yōu)先級如下：sub_order_id> sub_order_no> transaction_id> out_trade_no | |
| 微信子訂單號 | sub_order_id | String(32) | 20150806125346 | 微信支付系統(tǒng)內(nèi)部子訂單號, out_trade_no、transaction_id、sub_order_no、sub_order_id至少一個必填，同時存在時優(yōu)先級如下：sub_order_id> sub_order_no> transaction_id> out_trade_no | |
| 海關(guān) | customs | 是 | String(32) | SHANGHAI |
GUANGZHOU_ZS 廣州（總署版） HANGZHOU_ZS 杭州（總署版） NINGBO 寧波 ZHENGZHOU_BS 鄭州（保稅物流中心） CHONGQING 重慶 SHANGHAI_ZS 上海（總署版） SHENZHEN 深圳 ZHENGZHOU_ZH_ZS 鄭州綜保（總署版） TIANJIN 天津（需要推送訂單至天津海關(guān)時，需要在商戶管理后臺同時配置天津海關(guān)備案信息與天津國檢備案信息；調(diào)用報關(guān)接口時只需推送天津海關(guān)，即請求一次報關(guān)接口。） 接口文檔列表沒有的海關(guān)，商戶在商戶平臺新增海關(guān)備案信息時選“廣州（總署）”，備案號和備案名稱填商戶在海關(guān)登記的信息，然后按商戶平臺登記的信息調(diào)用“訂單附加信息提交接口”即可 |
應(yīng)答參數(shù)列表
| 字段名 | 變量名 | 必填 | 類型 | 示例值 | 說明 |
|---|---|---|---|---|---|
| 返回狀態(tài)碼 | return_code | 是 | String(16) | SUCCESS | SUCCESS/FAIL 此字段是通信標(biāo)識，非交易標(biāo)識，交易是否成功需要查看result_code來判斷 |
| 返回信息 | return_msg | 否 | String(128) | 簽名失敗 | 返回信息，如非空，為錯誤原因 簽名失敗 參數(shù)格式校驗錯誤 |
以下字段在return_code為SUCCESS的時候有返回
| 字段名 | 變量名 | 必填 | 類型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 簽名 | sign | 是 | String(32) | C380BEC2BFD727A4B6845133519F3AD6 | 簽名，詳見簽名生成算法 |
| 公眾賬號ID | appid | 是 | String(32) | wxd678efh567hg6787 | 微信分配的公眾賬號ID |
| 商戶號 | mch_id | 是 | String(32) | 1230000109 | 微信支付分配的商戶號 |
| 業(yè)務(wù)結(jié)果 | result_code | 是 | String(16) | SUCCESS | SUCCESS/FAIL |
| 錯誤代碼 | err_code | 否 | String(32) | SYSTEMERROR | 詳細(xì)參見第6節(jié)錯誤列表 |
| 錯誤代碼描述 | err_code_des | 否 | String(128) | 系統(tǒng)錯誤 | 錯誤返回的信息描述 |
以下字段在return_code 和result_code都為SUCCESS的時候有返回
| 字段名 | 變量名 | 必填 | 類型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 微信支付訂單號 | transaction_id | 是 | String(28) | 1000320306201511078440737890 | 微信支付返回的訂單號 |
| 筆數(shù) | count | 是 | int | 1 | 筆數(shù) |
| 商戶子訂單號 | sub_order_no_$n | 否 | String(32) | 20150806125346 | 商戶子訂單號 |
| 微信子訂單號 | sub_order_id_$n | 否 | String(32) | 20150806125346 | 微信子訂單號 |
| 商戶海關(guān)備案號 | mch_customs_no_$n | 否 | String(32) | 1234567 | 商戶在海關(guān)登記的備案號 |
| 海關(guān) | customs_$n | 是 | String(2) | SHANGHAI |
GUANGZHOU 廣州 HANGZHOU 杭州 NINGBO 寧波 ZHENGZHOU_BS 鄭州（保稅物流中心） CHONGQING 重慶 SHANGHAI 上海 ZHENGZHOU_ZH 鄭州（綜保區(qū)） |
| 幣種 | fee_type_$n | 否 | String(3) | CNY | 幣種 |
| 應(yīng)付金額 | order_fee_$n | 否 | int | 888 | 子單金額，以分為單位 |
| 關(guān)稅 | duty_$n | 否 | int | 888 | 關(guān)稅，以分為單位，非必填項，不會提交給海關(guān) |
| 物流費 | transport_fee_$n | 否 | int | 888 | 物流費用，以分為單位 | 商品價格 | product_fee_$n | 否 | int | 888 | 商品費用，以分為單位 |
| 狀態(tài)碼 | state_$n | 是 | String(2) | UNDECLARED |
狀態(tài)碼 UNDECLARED -- 未申報 SUBMITTED -- 申報已提交（訂單已經(jīng)送海關(guān)，商戶重新申報，并且海關(guān)還有修改接口，那么記錄的狀態(tài)會是這個） PROCESSING -- 申報中 SUCCESS -- 申報成功 FAIL -- 申報失敗 EXCEPT --海關(guān)接口異常 |
| 申報結(jié)果說明 | explanation_$n | 否 | String(128) | 支付單已存在并且為非退單狀態(tài) | 申報結(jié)果說明，如果狀態(tài)是失敗或異常，顯示失敗原因 |
| 最后更新時間 | modify_time_$n | 是 | String(14) | 20091227091010 | 最后更新時間，格式為yyyyMMddhhmmss，如2009年12月27日9點10分10秒表示為20091227091010。時區(qū)為GMT+8 beijing。該時間取自微信服務(wù)器 |
| 訂購人和支付人身份信息校驗結(jié)果 | cert_check_result_$n | 是 | String(256) | UNCHECKED |
UNCHECKED 商戶未上傳訂購人身份信息 SAME 商戶上傳的訂購人身份信息與支付人身份信息一致 DIFFERENT 商戶上傳的訂購人身份信息與支付人身份信息不一致 |
| 驗核機(jī)構(gòu) | verify_department | 是 | String(16) | UNIONPAY | 驗核機(jī)構(gòu)包括： |
| 驗核機(jī)構(gòu)交易流水號 | verify_department_trade_id | 是 | String(64) | 2018112288340107038204310100000 | 交易流水號，來自驗核機(jī)構(gòu)，如銀聯(lián)記錄的交易流水號，供商戶報備海關(guān) |
PS:$n表示記錄的序號，取值為0~($ count -1)，例如count指示返回的退款記錄有2條。第一條序號為“0”，第二條序號為“1”。