最新更新時(shí)間:2020.04.03 版本說(shuō)明
該接口用于商戶修改訂單附加信息。
修改接口會(huì)重新生成一條新的待申報(bào)申報(bào)數(shù)據(jù),同時(shí)作廢舊的申請(qǐng)數(shù)據(jù),不用再主動(dòng)調(diào)用重推接口。修改接口只能對(duì)商戶海關(guān)備案號(hào)、關(guān)稅、子訂單金額、物流費(fèi)用和商品費(fèi)用做修改。如修改商戶海關(guān)備案號(hào),將讀取商戶新的備案號(hào)和備案名稱,進(jìn)行重新申報(bào)。
適用對(duì)象:直連模式
接口URL:https://apihk.mch.weixin.qq.com/global/v3/customs /orders
請(qǐng)求方式:PATch
接口規(guī)則:https://wechatpay-api.gitbook.io/wechatpay-api-v3/
參數(shù)名 | 變量 | 類(lèi)型 | 必填 | 描述 |
---|---|---|---|---|
機(jī)構(gòu)APPID | appid | string(32) | 是 | 微信分配的公眾賬號(hào)ID 示例值:wxd678efh567hg6787 |
商戶號(hào) | mchid | string(32) | 是 | 微信支付分配的商戶號(hào) 示例值:1230000109 |
商戶訂單號(hào) | out_trade_no | string(32) | 是 | 商戶系統(tǒng)內(nèi)部訂單號(hào),要求32個(gè)字符內(nèi),只能是數(shù)字、大小寫(xiě)字母_-|*@ ,且在同一個(gè)商戶號(hào)下唯一 示例值:20150806125346 |
微信訂單號(hào) | transaction_id | string(32) | 是 | 微信支付返回的訂單號(hào) 示例值:1000320306201511078440737890 |
商戶子訂單號(hào) | sub_order_no | string(32) | 否 | 如有拆單,則必傳 示例值:20150806125346 |
海關(guān)編碼 | customs | string(32) | 是 | 海關(guān)代碼,枚舉值參見(jiàn)參數(shù)規(guī)定-海關(guān)列表 示例值:SHANGHAI_ZS |
商戶海關(guān)備案號(hào) | merchant_customs_no | string(32) | 是 | 商戶在海關(guān)登記的備案號(hào) 示例值:123456 |
關(guān)稅 | duty | int | 否 | 關(guān)稅,以分為單位,非必填項(xiàng),不會(huì)提交給海關(guān) 示例值:888 |
子訂單金額 | order_fee | int | 否 | 子訂單金額,以分為單位,不能超過(guò)原訂單金額,order\_fee=transport_fee+product_fee(應(yīng)付金額=物流費(fèi)+商品價(jià)格),如有拆單則必傳 示例值:888 |
物流費(fèi)用 | transport_fee | int | 否 | 物流費(fèi)用,以分為單位,如有拆單則必傳 示例值:888 |
商品費(fèi)用 | product_fee | int | 否 | 商品費(fèi)用,以分為單位,如有拆單則必傳 示例值:888 |
{
"appid": "wxd678efh567hg6787",
"mchid": "1230000109",
"out_trade_no": "20150806125346",
"transaction_id": "1000320306201511078440737890",
"sub_order_no": "20150806125346",
"customs": "SHANGHAI_ZS",
"merchant_customs_no": "123456",
"duty": 888,
"order_fee": 888,
"transport_fee": 888,
"product_fee": 888
}
參數(shù)名 | 變量 | 類(lèi)型 | 必填 | 描述 |
---|---|---|---|---|
機(jī)構(gòu)APPID | appid | string(32) | 是 | 微信分配的公眾賬號(hào)ID 示例值:wxd678efh567hg6787 |
商戶號(hào) | mchid | string(32) | 是 | 微信支付分配的商戶號(hào) 示例值:1230000109 |
報(bào)關(guān)狀態(tài) | state | string(32) | 是 | 申報(bào)結(jié)果狀態(tài)碼 PROCESSING:申報(bào)中 UNDECLARED:未申報(bào) SUBMITTED:已修改未申報(bào) SUCCESS:申報(bào)成功 FAIL:申報(bào)失敗 EXCEPT:海關(guān)接口異常 示例值:SUBMITTED |
商戶訂單號(hào) | out_trade_no | string(32) | 是 | 商戶系統(tǒng)內(nèi)部訂單號(hào),要求32個(gè)字符內(nèi),只能是數(shù)字、大小寫(xiě)字母_-|*@ ,且在同一個(gè)商戶號(hào)下唯一 示例值:20150806125346 |
微信訂單號(hào) | transaction_id | string(32) | 是 | 微信支付返回的訂單號(hào) 示例值:1000320306201511078440737890 |
商戶子訂單號(hào) | sub_order_no | string(32) | 否 | 商戶子訂單號(hào),如有拆單則返回 示例值:20150806125346 |
微信子訂單號(hào) | sub_order_id | string(32) | 否 | 微信子訂單號(hào),如有拆單則返回 示例值:20150806125346 |
最后更新時(shí)間 | modify_time | string(32) | 是 | 最后更新時(shí)間,該時(shí)間取自微信服務(wù)器 示例值:2015-09-01T10:00:00+08:00 |
核驗(yàn)機(jī)構(gòu) | verify_department | string(16) | 是 | 核驗(yàn)機(jī)構(gòu)代碼 UNIONPAY:銀聯(lián) NETSUNION:網(wǎng)聯(lián) OTHERS:其他 示例值:UNIONPAY |
核驗(yàn)機(jī)構(gòu)流水號(hào) | verify_department_trade_id | string(64) | 是 | 交易流水號(hào),來(lái)自驗(yàn)核機(jī)構(gòu),如銀聯(lián)記錄的交易流水號(hào),供商戶報(bào)備海關(guān) 示例值:2018112288340107038204310100000 |
參數(shù)名 | 變量 | 類(lèi)型 | 必填 | 描述 |
---|---|---|---|---|
返回狀態(tài)碼 | code | string(32) | 是 | 錯(cuò)誤碼,枚舉值見(jiàn)錯(cuò)誤碼列表 示例值:INVALID_REQUEST |
返回信息 | message | string(256) | 是 | 返回信息,如非空,為錯(cuò)誤原因 示例值:參數(shù)格式校驗(yàn)錯(cuò)誤 |
+詳細(xì)錯(cuò)誤描述 | detail | object | 否 | 當(dāng)code為PARAM_ERROR時(shí)返回,詳細(xì)說(shuō)明見(jiàn)下文 |
{
"appid": "wxd678efh567hg6787",
"mchid": "1230000109",
"state": "SUBMITTED",
"out_trade_no": "20150806125346",
"transaction_id": "1000320306201511078440737890",
"sub_order_no": "20150806125346",
"sub_order_id": "20150806125346",
"modify_time": "2015-09-01T10:00:00+08:00",
"verify_department": "UNIONPAY",
"verify_department_trade_id": "2018112288340107038204310100000"
}
錯(cuò)誤碼 | 描述 | 解決方案 |
---|---|---|
INVALID_REQUEST | 海關(guān)申報(bào)記錄不存在 | 海關(guān)申報(bào)記錄不存在,請(qǐng)重新申請(qǐng)或聯(lián)系微信支付小助手排查原因 |
支付單申報(bào)中,不能修改申報(bào)信息 | 當(dāng)前海關(guān)不支持申報(bào)中的支付單修改信息,請(qǐng)等支付單完成申報(bào)后,再使用報(bào)關(guān)修改信息接口修改支付單信息 | |
海關(guān)配置未設(shè)置 | 報(bào)關(guān)接口需要商戶已配置過(guò)海關(guān)信息才可以訪問(wèn)。請(qǐng)參照上文中的海關(guān)備案指引,進(jìn)行海關(guān)信息報(bào)備 | |
訂單金額不匹配 | 報(bào)關(guān)的訂單金額必須和支付的金額一致,請(qǐng)檢查報(bào)關(guān)訂單的金額是否正確 | |
NOAUTH | 商戶未在當(dāng)前申報(bào)的海關(guān)進(jìn)行備案 | 商戶未在申報(bào)的海關(guān)中備案,請(qǐng)商戶完成備案后重試; |
未開(kāi)通自助清關(guān)功能 | 請(qǐng)檢查當(dāng)前商戶是否已開(kāi)通自助清關(guān)功能,開(kāi)通路徑:微信支付商戶平臺(tái)-產(chǎn)品中心-自助清關(guān)中申請(qǐng)開(kāi)通。 | |
PARAM_ERROR | 幣種類(lèi)型未設(shè)置 | 拆單情況下,幣種為必填參數(shù)。請(qǐng)檢查fee_type是否為空。 |
交易幣種與商戶結(jié)算幣種不一致 | 請(qǐng)檢查所傳幣種參數(shù)(fee_type)是否為空 | |
參數(shù)錯(cuò)誤 | 參數(shù)錯(cuò)誤,可能參數(shù)有誤或參數(shù)遺漏,請(qǐng)檢查接口參數(shù)是否按要求提交 | |
訂單金額信息有誤 | 訂單金額與支付單金額不符,請(qǐng)檢查后重新申報(bào) | |
交易單信息有誤 | 交易單信息有誤,請(qǐng)檢查后重新申報(bào) | |
商戶拆單申報(bào)金額不正確 | 商戶折單金額大于原支付單金額,請(qǐng)檢查后重新申報(bào) | |
交易幣種與商戶結(jié)算幣種不一致 | 請(qǐng)重新報(bào)關(guān),或聯(lián)系微信支付小助手排查原因 | |
拆單申報(bào)時(shí)參數(shù)缺漏 | 拆單時(shí)fee_type、order_fee、transport_fee和product_fee必傳 | |
SYSTEMERROR | 系統(tǒng)錯(cuò)誤 | 請(qǐng)重新報(bào)關(guān),或聯(lián)系微信支付小助手排查原因 |
Customer Service Tel
Business Development
9:00-18:00
Monday-Friday GMT+8
Technical Support
WeChat Pay Global
ICP證