最新更新時(shí)間:2020.04.03 版本說(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ī)則:
a.如果沒(méi)有拆單,就以支付時(shí)的商戶訂單號(hào)out_trade_no、微信支付訂單號(hào)transaction_id、原支付單對(duì)應(yīng)的人民幣金額(如有部分退款,減去部分退款金額)申報(bào)。
b.如果拆單了,就以申報(bào)接口傳的商戶子單號(hào)sub_order_no和接口返回的子支付單號(hào)sub_order_id、申報(bào)接口傳的order_fee金額申報(bào)。
c.拆單的判斷標(biāo)準(zhǔn):調(diào)用支付申報(bào)接口時(shí),商戶傳了商戶子單號(hào)sub_order_no就認(rèn)為是拆單。
適用對(duì)象:直連模式
接口URL:https://apihk.mch.weixin.qq.com/global/v3/customs /orders
請(qǐng)求方式:POST
接口規(guī)則:https://wechatpay-api.gitbook.io/wechatpay-api-v3/
參數(shù)名 | 變量 | 類型 | 必填 | 描述 |
---|---|---|---|---|
機(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ù)字、大小寫字母_-|*@ ,且在同一個(gè)商戶號(hào)下唯一 示例值:20150806125346 |
微信訂單號(hào) | transaction_id | string(32) | 是 | 微信支付返回的訂單號(hào) 示例值:1000320306201511078440737890 |
海關(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 |
商戶子訂單號(hào) | sub_order_no | string(32) | 否 | 商戶子訂單號(hào),如有拆單則必傳 示例值:20150806125346 |
貨幣類型 | fee_type | string(32) | 否 | 微信支付訂單支付時(shí)使用的幣種,暫只支持人民幣CNY,如有拆單則必傳 示例值:CNY |
子訂單金額 | 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",
"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
}
參數(shù)名 | 變量 | 類型 | 必填 | 描述 |
---|---|---|---|---|
機(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)接口異常 示例值:PROCESSING |
商戶訂單號(hào) | out_trade_no | string(32) | 是 | 商戶系統(tǒng)內(nèi)部訂單號(hào),要求32個(gè)字符內(nèi),只能是數(shù)字、大小寫字母_-|*@ ,且在同一個(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 |
核驗(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ù)名 | 變量 | 類型 | 必填 | 描述 |
---|---|---|---|---|
返回狀態(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": "PROCESSING",
"out_trade_no": "20150806125346",
"transaction_id": "1000320306201511078440737890",
"sub_order_no": "20150806125346",
"sub_order_id": "20150806125346",
"verify_department": "UNIONPAY",
"verify_department_trade_id": "2018112288340107038204310100000"
}
客戶服務(wù)電話
業(yè)務(wù)發(fā)展
9:00-18:00
北京時(shí)間 星期一至星期五
開(kāi)發(fā)人員支持