API字典 / 海關(guān)報(bào)關(guān) / 報(bào)關(guān)API

報(bào)關(guān)API

最新更新時(shí)間：2022.08.04 版本說(shuō)明

該接口用于商戶提交海關(guān)需要的訂單附加信息。

注意：

以下為財(cái)付通的海關(guān)備案信息，一般海關(guān)會(huì)提供，如果沒(méi)有請(qǐng)參考下表：財(cái)付通海關(guān)備案名稱：財(cái)付通支付科技有限公司財(cái)付通10位海關(guān)注冊(cè)編碼：4403169D3W。

支付單申報(bào)規(guī)則：

? 如果沒(méi)有拆單，就以支付時(shí)的商戶訂單號(hào)out_trade_no、微信支付訂單號(hào)transaction_id、原支付單對(duì)應(yīng)的人民幣金額（如有部分退款，減去部分退款金額）申報(bào)。

? 如果拆單了，就以申報(bào)接口傳的商戶子單號(hào)sub_order_no和接口返回的子支付單號(hào)sub_order_id、申報(bào)接口傳的order_fee金額申報(bào)。

? 拆單的判斷標(biāo)準(zhǔn)：調(diào)用支付申報(bào)接口時(shí)，商戶傳了商戶子單號(hào)sub_order_no就認(rèn)為是拆單。

1. 接口說(shuō)明

適用對(duì)象: 直連模式機(jī)構(gòu)模式

請(qǐng)求URL: https://apihk.mch.weixin.qq.com/v3/global/customs/orders

請(qǐng)求方式: POST

Path指該參數(shù)為路徑參數(shù)

Query指該參數(shù)為URL參數(shù)

Body指該參數(shù)需在請(qǐng)求JSON傳參

2. 請(qǐng)求參數(shù)

參數(shù)名	變量	類(lèi)型[長(zhǎng)度限制]	必填	描述
機(jī)構(gòu)APPID	appid	string[1,32]	是	Body 微信分配的公眾賬號(hào)ID 示例值：wxd678efh567hg6787
商戶號(hào)	mchid	string[1,32]	是	Body 微信支付分配的商戶號(hào) 示例值：1230000109
商戶訂單號(hào)	out_trade_no	string[1,32]	是	Body 商戶系統(tǒng)內(nèi)部訂單號(hào)，要求32個(gè)字符內(nèi)，只能是數(shù)字、大小寫(xiě)字母_-\|*@ ，且在同一個(gè)商戶號(hào)下唯一示例值：20150806125346
微信訂單號(hào)	transaction_id	string[1,32]	是	Body 微信支付返回的訂單號(hào) 示例值：1000320306201511078440737890
海關(guān)	customs	string[1,32]	是	Body 海關(guān)代碼，枚舉值參見(jiàn)海關(guān)列表示例值：SHANGHAI_ZS
商戶海關(guān)備案號(hào)	merchant_customs_no	string[1,32]	是	Body 商戶在海關(guān)登記的備案號(hào) 示例值：123456
關(guān)稅	duty	int	否	Body 關(guān)稅，以分為單位，非必填項(xiàng)，不會(huì)提交給海關(guān) 示例值：888
商戶子訂單號(hào)	sub_order_no	string[1,32]	否	Body 商戶子訂單號(hào)，如有拆單則必傳注意：僅適用于機(jī)構(gòu)模式示例值：20150806125346
貨幣類(lèi)型	fee_type	string[1,32]	否	Body 微信支付訂單支付時(shí)使用的幣種，暫只支持人民幣CNY，如有拆單則必傳示例值：CNY
子訂單金額	order_fee	int	否	Body 子訂單金額，以分為單位，不能超過(guò)原訂單金額，order_fee=transport_fee+product_fee（應(yīng)付金額=物流費(fèi)+商品價(jià)格），如有拆單則必傳示例值：888
物流費(fèi)用	transport_fee	int	否	Body 物流費(fèi)用，以分為單位，如有拆單則必傳示例值：888
商品費(fèi)用	product_fee	int	否	Body 商品費(fèi)用，以分為單位，如有拆單則必傳示例值：888

請(qǐng)求示例

JSON


{
  "appid": "wxd678efh567hg6787",
  "mchid": "1230000109",
  "out_trade_no": "20150806125346",
  "transaction_id": "1000320306201511078440737890",
  "customs": "SHANGHAI_ZS",
  "merchant_customs_no": "123456",
  "duty": 888,
  "sub_order_no": "20150806125346",
  "fee_type": "CNY",
  "order_fee": 888,
  "transport_fee": 888,
  "product_fee": 888
}

{
    "appid": "wx2421b1c4370ec43b",
    "m",
      "device_id" : "013467007045764",
      "operator_id": "P001",
      "store_info" : {
        "id": "SZTX001"
      }
    }
}


									{
										"stock_id": ".NET",
										"limit": 10,
									}


									{
										"stock_id": "Python",
										"stock_creator_mchid": "123456",
										"limit": 10,
									}

3. 返回參數(shù)

正常返回

參數(shù)名	變量	類(lèi)型[長(zhǎng)度限制]	必填	描述
機(jī)構(gòu)APPID	appid	string[1,32]	是	微信分配的公眾賬號(hào)ID 示例值：wxd678efh567hg6787
商戶號(hào)	mchid	string[1,32]	是	微信支付分配的商戶號(hào) 示例值：1230000109
報(bào)關(guān)狀態(tài)	state	string[1,32]	是	申報(bào)結(jié)果狀態(tài)碼 PROCESSING：申報(bào)中 UNDECLARED：未申報(bào) SUBMITTED：已修改未申報(bào) SUCCESS：申報(bào)成功 FAIL：申報(bào)失敗 EXCEPT：海關(guān)接口異常示例值：PROCESSING
商戶訂單號(hào)	out_trade_no	string[1,32]	是	商戶系統(tǒng)內(nèi)部訂單號(hào)，要求32個(gè)字符內(nèi)，只能是數(shù)字、大小寫(xiě)字母_-\|*@ ，且在同一個(gè)商戶號(hào)下唯一示例值：20150806125346
微信訂單號(hào)	transaction_id	string[1,32]	是	微信支付返回的訂單號(hào) 示例值：1000320306201511078440737890
商戶子訂單號(hào)	sub_order_no	string[1,32]	否	商戶子訂單號(hào)，如有拆單則返回注意：僅適用于機(jī)構(gòu)模式示例值：20150806125346
微信子訂單號(hào)	sub_order_id	string[1,32]	否	微信子訂單號(hào)，如有拆單則返回注意：僅適用于機(jī)構(gòu)模式示例值：20150806125346
核驗(yàn)機(jī)構(gòu)	verify_department	string[1,16]	是	核驗(yàn)機(jī)構(gòu)代碼 UNIONPAY：銀聯(lián) NETSUNION：網(wǎng)聯(lián) OTHERS：其他注：商戶需將該字段取值UNIONPAY, NETSUNION, OTHERS映射至海關(guān)verDept字段的1、2、3 示例值：UNIONPAY
核驗(yàn)機(jī)構(gòu)交易流水號(hào)	Verify_department_trade_id	string[1,64]	是	交易流水號(hào)，來(lái)自驗(yàn)核機(jī)構(gòu)，如銀聯(lián)記錄的交易流水號(hào)，供商戶報(bào)備海關(guān) 示例值：2018112288340107038204310100000

異常返回

參數(shù)名

變量

類(lèi)型[長(zhǎng)度限制]

必填

描述

返回狀態(tài)碼

code

string[1, 32]

是

錯(cuò)誤碼，枚舉值見(jiàn)錯(cuò)誤碼列表
示例值：INVALID_REQUEST

返回信息

message

string[1, 256]

是

返回信息，如非空，為錯(cuò)誤原因
示例值：參數(shù)格式校驗(yàn)錯(cuò)誤

詳細(xì)的錯(cuò)誤描述

detail

object

否

當(dāng)code為PARAM_ERROR時(shí)返回，詳細(xì)說(shuō)明見(jiàn)下

參數(shù)名	變量	類(lèi)型[長(zhǎng)度限制]	必填	描述
指示錯(cuò)誤參數(shù)的位置	field	string[1, 256]	是	當(dāng)錯(cuò)誤參數(shù)位于請(qǐng)求body的JSON時(shí)，填寫(xiě)指向參數(shù)的JSON Pointer 當(dāng)錯(cuò)誤參數(shù)位于請(qǐng)求的url或者querystring時(shí)，填寫(xiě)參數(shù)的變量名示例值：#/properties/payer
錯(cuò)誤參數(shù)的值	value	string[1, 256]	是	錯(cuò)誤參數(shù)的值示例值：1346177081915535577
具體錯(cuò)誤原因	issue	string[1, 256]	是	具體錯(cuò)誤原因示例值：與ALLOF schema不符
錯(cuò)誤參數(shù)的位置	location	string[1, 256]	否	body：錯(cuò)誤參數(shù)位于請(qǐng)求body的JSON中 url：錯(cuò)誤參數(shù)位于請(qǐng)求url中 query：錯(cuò)誤參數(shù)位于請(qǐng)求的querystring中示例值：body

收起

返回示例

正常示例異常示例

{
  "appid": "wxd678efh567hg6787",
  "mchid": "1230000109",
  "state": "PROCESSING",
  "out_trade_no": "20150806125346",
  "transaction_id": "1000320306201511078440737890",
  "sub_order_no": "20150806125346",
  "sub_order_id": "20150806125346",
  "verify_department": "UNIONPAY",
  "verify_department_trade_id": "2018112288340107038204310100000"
}

 
{
	"code": "INVALID_REQUEST",
	"message": "Parameter format verification error",
	"detail": {
		"field": "#/properties/payer",
		"value": "1346177081915535577",
		"issue": "與ALLOF schema不符",
		"location": "body"
	}
}

4. 錯(cuò)誤碼

錯(cuò)誤碼	描述	解決方案
INVALID_REQUEST	商戶海關(guān)申報(bào)重入信息不一致	若需要修改支付單信息，請(qǐng)使用報(bào)關(guān)修改接口；若需要重新推送支付單，請(qǐng)使用信息重推接口
	海關(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)訂單的金額是否正確
	已退款訂單不允許申報(bào)	訂單已退款，不允許申報(bào)
NOAUTH	商戶未在當(dāng)前申報(bào)的海關(guān)進(jìn)行備案	商戶未在申報(bào)的海關(guān)中備案，請(qǐng)商戶完成備案后重試；
NOAUTH	未開(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	商戶號(hào)(mch_id)未設(shè)置	商戶號(hào)為必傳參數(shù)，請(qǐng)求時(shí)必傳。請(qǐng)檢查商戶號(hào)是否為空
	無(wú)效的商戶號(hào)長(zhǎng)度	請(qǐng)檢查商戶號(hào)長(zhǎng)度是否為10位
	幣種類(lèi)型未設(shè)置	拆單情況下，幣種為必填參數(shù)。請(qǐng)檢查fee_type是否為空。
	商戶訂單號(hào)(out_trade_no)未設(shè)置	請(qǐng)檢查商戶訂單號(hào)(out_trade_no）是否為空
	微信訂單號(hào)(transaction_id)未設(shè)置	請(qǐng)檢查微信訂單號(hào)(transaction_id)是否為空
	無(wú)效的微信訂單號(hào)長(zhǎng)度	微信訂單號(hào)為28位數(shù)字，請(qǐng)確保長(zhǎng)度一致，請(qǐng)檢查微信訂單號(hào)(transaction_id)是否正確
	海關(guān)信息未設(shè)置	海關(guān)信息為必傳字段，請(qǐng)檢查海關(guān)信息是否為空
	海關(guān)備案號(hào)未設(shè)置	請(qǐng)檢查備案號(hào)是否為空
	無(wú)效的海關(guān)備案號(hào)長(zhǎng)度	海關(guān)備案號(hào)一般為6位字符串，請(qǐng)檢查海關(guān)備案號(hào)是否正確
	無(wú)效的子訂單號(hào)長(zhǎng)度(sub_order_no]	子訂單號(hào)要求是32位以內(nèi)的字符串，請(qǐng)檢查子訂單號(hào)長(zhǎng)度是否正確
	AppId未設(shè)置	請(qǐng)檢查appid是否正確
	交易幣種與商戶結(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)系微信支付小助手排查原因

頁(yè)面導(dǎo)航

视频一区二区三区自拍_千金肉奴隷1985未删减版在线观看_国产成人黄色视频在线播放_少女免费播放片高清在线观看_国产精品v欧美精品v

WeChat Pay

Feedback

Feedback

Submitted successfully

Feedback

Network exception, please try again later

支付產(chǎn)品

資金類(lèi)產(chǎn)品

其他產(chǎn)品

報(bào)關(guān)API

1. 接口說(shuō)明

2. 請(qǐng)求參數(shù)

請(qǐng)求示例

3. 返回參數(shù)

正常返回

異常返回

返回示例

4. 錯(cuò)誤碼