本文介紹微信支付下的報(bào)關(guān)接口的開發(fā)過程。微信報(bào)關(guān)是用于商戶提交海關(guān)需要的訂單信息。?
一、報(bào)關(guān)接口API
接口地址
https://api.mch.weixin.qq.com/cgi-bin/mch/customs/customdeclareorder
是否需要證書
不需要。
請求方式：post 數(shù)據(jù)格式：xml 簽名方式：MD5
注意：商戶訂單號(hào)金額以支付系統(tǒng)記錄的為準(zhǔn)，無需上傳，如有子訂單號(hào)則必須上傳子訂單應(yīng)付金額、物流費(fèi)、商品價(jià)格（應(yīng)付金額=物流費(fèi)+商品價(jià)格）。
| 字段名 | 變量名 | 必填 | 類型 | 示例值 | 說明 |
|---|---|---|---|---|---|
| 簽名 | sign | 是 | String(32) | C380BEC2BFD727A4B6845133519F3AD6 | 簽名，詳見簽名生成算法 |
| 公眾賬號(hào)ID | appid | 是 | String(32) | wxd678efh567hg6787 | 微信分配的公眾賬號(hào)ID |
| 商戶號(hào) | mch_id | 是 | String(32) | 1230000109 | 微信支付分配的商戶號(hào) |
| 商戶訂單號(hào) | out_trade_no | 是 | String(32) | 20150806125346 | 商戶系統(tǒng)內(nèi)部的訂單號(hào) |
| 微信支付訂單號(hào) | transaction_id | 是 | String(28) | 1000320306201511078440737890 | 微信支付返回的訂單號(hào) |
| 海關(guān) | customs | 是 | String(32) | SHANGHAI |
NO 無需上報(bào)海關(guān) GUANGZHOU 廣州 HANGZHOU 杭州 NINGBO 寧波 ZHENGZHOU_BS 鄭州（保稅物流中心） CHONGQING 重慶 XIAN 西安 SHANGHAI 上海 ZHENGZHOU_ZH 鄭州（綜保區(qū)） SHENZHEN 深圳 |
| 商戶海關(guān)備案號(hào) | mch_customs_no | 否 | String(32) | 123456 | 商戶在海關(guān)登記的備案號(hào)，customs非NO，此參數(shù)必填 |
| 關(guān)稅 | duty | 否 | Int | 888 | 關(guān)稅，以分為單位 |
以下字段在拆單或重新報(bào)關(guān)時(shí)必傳
| 字段名 | 變量名 | 必填 | 類型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 商戶子訂單號(hào) | sub_order_no | 否 | String(32) | 20150806125346 | 商戶子訂單號(hào)，如有拆單則必傳 |
| 幣種 | fee_type | 否 | String(3) | CNY | 微信支付訂單支付時(shí)使用的幣種，暫只支持人民幣CNY,如有拆單則必傳。 |
| 應(yīng)付金額 | order_fee | 否 | Int | 888 | 子訂單金額，以分為單位，不能超過原訂單金額，order_fee=transport_fee+product_fee（應(yīng)付金額=物流費(fèi)+商品價(jià)格），如有拆單則必傳。 |
| 物流費(fèi) | transport_fee | 否 | Int | 888 | 物流費(fèi)用，以分為單位，如有拆單則必傳。 |
| 商品價(jià)格 | product_fee | 否 | Int | 888 | 商品費(fèi)用，以分為單位，如有拆單則必傳。 |
以下字段在微信缺少用戶信息時(shí)必傳，如果商戶上傳了用戶信息，則以商戶上傳的信息為準(zhǔn)。
| 字段名 | 變量名 | 必填 | 類型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 證件類型 | cert_type | 否 | String(32) | IDCARD | 暫只支持身份證，該參數(shù)是指用戶信息，商戶若有用戶信息，可上送，系統(tǒng)將以商戶上傳的數(shù)據(jù)為準(zhǔn)，進(jìn)行海關(guān)通關(guān)報(bào)備； |
| 證件號(hào)碼 | cert_id | 否 | String(64) | 330821198809085211 | 身份證號(hào)，該參數(shù)是指用戶信息，商戶若有用戶信息，可上送，系統(tǒng)將以商戶上傳的數(shù)據(jù)為準(zhǔn)，進(jìn)行海關(guān)通關(guān)報(bào)備； |
| 姓名 | name | 否 | String(64) | 張三 | 用戶姓名，該參數(shù)是指用戶信息，商戶若有用戶信息，可上送，系統(tǒng)將以商戶上傳的數(shù)據(jù)為準(zhǔn)，進(jìn)行海關(guān)通關(guān)報(bào)備； |
舉例如下：
<xml> <appid>wx2421b1c4370ec43b</appid> <customs>ZHENGZHOU_BS</customs> <mch_customs_no>D00411</mch_customs_no> <mch_id>1262544101</mch_id> <order_fee>13110</order_fee> <out_trade_no>15112496832609</out_trade_no> <product_fee>13110</product_fee> <sign>8FF6CEF879FB9555CD580222E671E9D4</sign> <transaction_id>1006930610201511241751403478</transaction_id> <transport_fee>0</transport_fee> <fee_type>CNY</fee_type> <sub_order_no>15112496832609001</sub_order_no> </xml>
注：參數(shù)值用XML轉(zhuǎn)義即可，CDATA標(biāo)簽用于說明數(shù)據(jù)不被XML解析器解析。
應(yīng)答參數(shù)列表
| 字段名 | 變量名 | 必填 | 類型 | 示例值 | 說明 |
|---|---|---|---|---|---|
| 返回狀態(tài)碼 | return_code | 是 | String(16) | SUCCESS | SUCCESS/FAIL 此字段是通信標(biāo)識(shí)，非交易標(biāo)識(shí)，交易是否成功需要查看result_code來判斷 |
| 返回信息 | return_msg | 否 | String(128) | 簽名失敗 | 返回信息，如非空，為錯(cuò)誤原因 簽名失敗 參數(shù)格式校驗(yàn)錯(cuò)誤 |
以下字段在return_code為SUCCESS的時(shí)候有返回
| 字段名 | 變量名 | 必填 | 類型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 簽名類型 | sign_type | 是 | String(32) | MD5 | 暫只支持MD5 |
| 簽名 | sign | 是 | String(32) | C380BEC2BFD727A4B6845133519F3AD6 | 簽名，詳見簽名生成算法 |
| 公眾賬號(hào)ID | appid | 是 | String(32) | wxd678efh567hg6787 | 微信分配的公眾賬號(hào)ID |
| 商戶號(hào) | mch_id | 是 | String(32) | 1230000109 | 微信支付分配的商戶號(hào) |
| 業(yè)務(wù)結(jié)果 | result_code | 是 | String(16) | SUCCESS | SUCCESS/FAIL |
| 錯(cuò)誤代碼 | err_code | 否 | String(32) | SYSTEMERROR | 詳細(xì)參見錯(cuò)誤列表 |
| 錯(cuò)誤代碼描述 | err_code_des | 否 | String(128) | 系統(tǒng)錯(cuò)誤 | 錯(cuò)誤返回的信息描述 |
以下字段在return_code 和result_code都為SUCCESS的時(shí)候有返回
| 字段名 | 變量名 | 必填 | 類型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 狀態(tài)碼 | state | 是 | String(2) | UNDECLARED | 狀態(tài)碼 UNDECLARED -- 未申報(bào) SUBMITTED -- 申報(bào)已提交（訂單已經(jīng)送海關(guān)，商戶重新申報(bào)，并且海關(guān)還有修改接口，那么記錄的狀態(tài)會(huì)是這個(gè)） PROCESSING -- 申報(bào)中 SUCCESS -- 申報(bào)成功 FAIL-- 申報(bào)失敗 EXCEPT --海關(guān)接口異常 |
| 微信支付訂單號(hào) | transaction_id | 是 | String(28) | 1000320306201511078440737890 | 微信支付返回的訂單號(hào) |
| 商戶訂單號(hào) | out_trade_no | 是 | String(32) | 20150806125346 | 商戶系統(tǒng)內(nèi)部的訂單號(hào) |
| 商戶子訂單號(hào) | sub_order_no | 否 | String(32) | 20150806125346 | 商戶子訂單號(hào)，如有拆單則必傳 |
| 微信子訂單號(hào) | sub_order_id | 否 | String(32) | 20150806125346 | 微信子訂單號(hào) |
| 最后更新時(shí)間 | modify_time | 是 | String(14) | 20091227091010 | 最后更新時(shí)間，格式為yyyyMMddhhmmss，如2009年12月27日9點(diǎn)10分10秒表示為20091227091010。時(shí)區(qū)為GMT+8 beijing。該時(shí)間取自微信服務(wù)器 |
錯(cuò)誤碼
| 名稱 | 描述 | 原因 | 解決方案 |
|---|---|---|---|
| 132011004 | 參數(shù)錯(cuò)誤 | 報(bào)關(guān)時(shí)僅傳入訂單號(hào)，不傳入子訂單號(hào)（sub_order_no)時(shí)，不能填費(fèi)用信息，須以支付系統(tǒng)中的值為準(zhǔn) | 請檢查參數(shù)是否都正確 |
| 132021028 | 交易幣種與商戶結(jié)算幣種不一致】 | 報(bào)關(guān)時(shí)傳入子訂單號(hào)（sub_order_no)時(shí)，幣種參數(shù)（fee_type)必填 | 請檢查所傳幣種參數(shù)（fee_type）是否為空 |
| MCHID_NOT_SET | 商戶號(hào)未設(shè)置 | 商戶號(hào)為必傳參數(shù)，請求時(shí)必傳 | 請檢查商戶號(hào)是否為空 |
| MCHID_INVALID_LENGTH | 無效的商戶號(hào)長度 | 報(bào)關(guān)接口只支持12開頭10位數(shù)字的商戶號(hào) | 請檢查商戶號(hào)長度是否為10位 |
| CUSTOMSCONFIG_NOT_SET | 海關(guān)配置未設(shè)置 | 報(bào)關(guān)接口需要商戶已配置過海關(guān)信息才可以訪問 | 請參照上文中的海關(guān)備案指引，進(jìn)行海關(guān)信息報(bào)備 |
| FEETYPE_NOT_SET | 幣種類型未設(shè)置 | 拆單情況下，幣種為必填參數(shù) | 請檢查fee_type是否為空 |
| OUTTRADENO_NOT_SET | 商戶訂單號(hào)(out_trade_no)未設(shè)置 | 商戶訂單號(hào)為必傳參數(shù) | 請檢查商戶訂單號(hào)(out_trade_no）是否為空 |
| TRANSACTION_ID_NOT_SET | 微信訂單號(hào)(transaction_id)未設(shè)置 | 微信訂單號(hào)(transaction_id)為必傳參數(shù) | 請檢查微信訂單號(hào)(transaction_id)是否為空 |
| INVALID_TRANSACTION_ID | 無效的微信訂單號(hào)長度 | 微信訂單號(hào)為28位數(shù)字，請確保長度一致 | 請檢查微信訂單號(hào)(transaction_id)是否正確 |
| CUSTOMS_NOT_SET | 海關(guān)信息未設(shè)置 | 海關(guān)信息為必傳字段 | 請檢查海關(guān)信息是否為空 |
| CHCUSTOMSNO_NOT_SET | 海關(guān)備案號(hào)未設(shè)置 | 海關(guān)備案號(hào)為必傳字段 | 請檢查備案號(hào)是否為空 |
| INVALID_MCHCUSTOMSNO | 無效的海關(guān)備案號(hào)長度 | 海關(guān)備案號(hào)一般為6位字符串 | 請檢查海關(guān)備案號(hào)是否正確 |
| PAYFEE_NOT_MATCH | 金額不匹配 | 報(bào)關(guān)的訂單金額必須和支付的金額一致 | 請檢查報(bào)關(guān)訂單的金額是否正確 |
| INVALID_SUBORDER_NO | 無效的子訂單號(hào)長度(sub_order_no) | 子訂單號(hào)要求是32位以內(nèi)的字符串 | 請檢查子訂單號(hào)長度是否正確 |
| APPID_NOT_EXIST | AppId未設(shè)置(sub_order_no) | appid為必傳字段 | 請檢查appid是否正確 |
| MCHID_NOT_EXIST | 商戶號(hào)(mch_id)未設(shè)置 | MCH_ID為必傳字段 | 請檢查mch_id是否正確 |
| AUTHORITY_NOT_FOUND | 未開通自助清關(guān)功能 | 須先開通自助清關(guān)功能才可成功調(diào)用接口 | 請檢查是否已開通自助清關(guān)功能，開通路徑：微信支付商戶平臺(tái)-產(chǎn)品中心-自助清關(guān)中申請開通。 |
| NO_AUTH | 無權(quán)限 | 未獲得此接口的調(diào)用權(quán)限 | 請檢查當(dāng)前商戶號(hào)是否已獲得此接口的調(diào)用權(quán)限 |
二、SDK實(shí)現(xiàn)
sdk定義
三、調(diào)用方式
三、返回結(jié)果
發(fā)送數(shù)據(jù)如下
array(6) {
["appid"]=>
string(18) "wxa8092dd025e45123"
["mch_id"]=>
string(10) "1238298123"
["out_trade_no"]=>
string(22) "SH20160824095750086988"
["transaction_id"]=>
string(28) "4006742001201608242098415582"
["customs"]=>
string(6) "NINGBO"
["mch_customs_no"]=>
string(10) "3302461123"
}接收到的數(shù)據(jù)如下
array(12) {
["return_code"]=>
string(7) "SUCCESS"
["return_msg"]=>
string(6) "成功"
["sign"]=>
string(32) "91EFCEEAAD4322F331F3F63C4D8F1279"
["appid"]=>
string(18) "wxa8092dd025e45123"
["mch_id"]=>
string(10) "1238298123"
["result_code"]=>
string(7) "SUCCESS"
["err_code"]=>
string(1) "0"
["err_code_des"]=>
string(2) "OK"
["state"]=>
string(9) "SUBMITTED"
["transaction_id"]=>
string(28) "4006742001201608242098415582"
["out_trade_no"]=>
string(22) "SH20160824095750086988"
["modify_time"]=>
string(14) "20160825111049"
}
?
以上是微信公眾平臺(tái)開發(fā)微信支付報(bào)關(guān)接口 的詳細(xì)內(nèi)容。更多信息請關(guān)注PHP中文網(wǎng)其他相關(guān)文章！
熱AI工具
Undress AI Tool
免費(fèi)脫衣服圖片
Undresser.AI Undress
人工智能驅(qū)動(dòng)的應(yīng)用程序，用于創(chuàng)建逼真的裸體照片
AI Clothes Remover
用于從照片中去除衣服的在線人工智能工具。
Clothoff.io
AI脫衣機(jī)
Video Face Swap
使用我們完全免費(fèi)的人工智能換臉工具輕松在任何視頻中換臉！
熱門文章
熱工具
記事本++7.3.1
好用且免費(fèi)的代碼編輯器
SublimeText3漢化版
中文版，非常好用
禪工作室 13.0.1
功能強(qiáng)大的PHP集成開發(fā)環(huán)境
Dreamweaver CS6
視覺化網(wǎng)頁開發(fā)工具
SublimeText3 Mac版
神級(jí)代碼編輯軟件(SublimeText3)
PHP微信開發(fā)：如何實(shí)現(xiàn)消息加密解密
May 13, 2023 am 11:40 AM
PHP是一種開源的腳本語言，廣泛應(yīng)用于Web開發(fā)和服務(wù)器端編程，尤其在微信開發(fā)中得到了廣泛的應(yīng)用。如今，越來越多的企業(yè)和開發(fā)者開始使用PHP進(jìn)行微信開發(fā)，因?yàn)樗蔀榱艘豢钫嬲囊讓W(xué)易用的開發(fā)語言。在微信開發(fā)中，消息的加密和解密是一個(gè)非常重要的問題，因?yàn)樗鼈兩婕暗綌?shù)據(jù)的安全性。對(duì)于沒有加密和解密方式的消息，黑客可以輕松獲取到其中的數(shù)據(jù)，對(duì)用戶造成威脅
PHP微信開發(fā)：如何實(shí)現(xiàn)投票功能
May 14, 2023 am 11:21 AM
在微信公眾號(hào)開發(fā)中，投票功能經(jīng)常被運(yùn)用。投票功能是讓用戶快速參與互動(dòng)的好方式，也是舉辦活動(dòng)和調(diào)查意見的重要工具。本文將為您介紹如何使用PHP實(shí)現(xiàn)微信投票功能。獲取微信公眾號(hào)授權(quán)首先，你需要獲取微信公眾號(hào)的授權(quán)。在微信公眾平臺(tái)上，你需要配置微信公眾號(hào)的api地址、官方賬號(hào)和公眾號(hào)對(duì)應(yīng)的token。在我們使用PHP語言開發(fā)的過程中，我們需要使用微信官方提供的PH
用PHP開發(fā)微信群發(fā)工具
May 13, 2023 pm 05:00 PM
隨著微信的普及，越來越多的企業(yè)開始將其作為營銷工具。而微信群發(fā)功能，則是企業(yè)進(jìn)行微信營銷的重要手段之一。但是，如果只依靠手動(dòng)發(fā)送，對(duì)于營銷人員來說是一件極為費(fèi)時(shí)費(fèi)力的工作。所以，開發(fā)一款微信群發(fā)工具就顯得尤為重要。本文將介紹如何使用PHP開發(fā)微信群發(fā)工具。一、準(zhǔn)備工作開發(fā)微信群發(fā)工具，我們需要掌握以下幾個(gè)技術(shù)點(diǎn)：PHP基礎(chǔ)知識(shí)微信公眾平臺(tái)開發(fā)開發(fā)工具：Sub
PHP微信開發(fā)：如何實(shí)現(xiàn)客服聊天窗口管理
May 13, 2023 pm 05:51 PM
微信是目前全球用戶規(guī)模最大的社交平臺(tái)之一，隨著移動(dòng)互聯(lián)網(wǎng)的普及，越來越多的企業(yè)開始意識(shí)到微信營銷的重要性。在進(jìn)行微信營銷時(shí)，客服服務(wù)是至關(guān)重要的一環(huán)。為了更好地管理客服聊天窗口，我們可以借助PHP語言進(jìn)行微信開發(fā)。一、PHP微信開發(fā)簡介PHP是一種開源的服務(wù)器端腳本語言，廣泛運(yùn)用于Web開發(fā)領(lǐng)域。結(jié)合微信公眾平臺(tái)提供的開發(fā)接口，我們可以使用PHP語言進(jìn)行微信
PHP微信開發(fā)：如何實(shí)現(xiàn)用戶標(biāo)簽管理
May 13, 2023 pm 04:31 PM
在微信公眾號(hào)開發(fā)中，用戶標(biāo)簽管理是一個(gè)非常重要的功能，可以讓開發(fā)者更好地了解和管理自己的用戶。本篇文章將介紹如何使用PHP實(shí)現(xiàn)微信用戶標(biāo)簽管理功能。一、獲取微信用戶openid在使用微信用戶標(biāo)簽管理功能之前，我們首先需要獲取用戶的openid。在微信公眾號(hào)開發(fā)中，通過用戶授權(quán)的方式獲取openid是比較常見的做法。在用戶授權(quán)完成后，我們可以通過以下代碼獲取用
PHP微信開發(fā)：如何實(shí)現(xiàn)群發(fā)消息發(fā)送記錄
May 13, 2023 pm 04:31 PM
隨著微信成為了人們生活中越來越重要的一個(gè)通訊工具，其敏捷的消息傳遞功能迅速受到廣大企業(yè)和個(gè)人的青睞。對(duì)于企業(yè)而言，將微信發(fā)展為一個(gè)營銷平臺(tái)已經(jīng)成為趨勢，而微信開發(fā)的重要性也逐漸凸顯。在其中，群發(fā)功能更是被廣泛使用，那么，作為PHP程序員，如何實(shí)現(xiàn)群發(fā)消息發(fā)送記錄呢？下面將為大家簡單介紹一下。1.了解微信公眾號(hào)相關(guān)開發(fā)知識(shí)在了解如何實(shí)現(xiàn)群發(fā)消息發(fā)送記錄之前，我
使用PHP實(shí)現(xiàn)微信公眾號(hào)開發(fā)的步驟
Jun 27, 2023 pm 12:26 PM
如何使用PHP實(shí)現(xiàn)微信公眾號(hào)開發(fā)微信公眾號(hào)已經(jīng)成為了很多企業(yè)推廣和互動(dòng)的重要渠道，而PHP作為一種常用的Web語言，也可以用來進(jìn)行微信公眾號(hào)的開發(fā)。本文將介紹一下使用PHP實(shí)現(xiàn)微信公眾號(hào)開發(fā)的具體步驟。第一步：獲取微信公眾號(hào)的開發(fā)者賬號(hào)在開始微信公眾號(hào)開發(fā)之前，需要先去申請一個(gè)微信公眾號(hào)的開發(fā)者賬號(hào)。具體的注冊流程可以參見微信公眾平臺(tái)的官方網(wǎng)
如何使用PHP進(jìn)行微信開發(fā)？
May 21, 2023 am 08:37 AM
隨著互聯(lián)網(wǎng)和移動(dòng)智能設(shè)備的發(fā)展，微信成為了社交和營銷領(lǐng)域不可或缺的一部分。在這個(gè)越來越數(shù)字化的時(shí)代，如何使用PHP進(jìn)行微信開發(fā)已經(jīng)成為了很多開發(fā)者的關(guān)注點(diǎn)。本文主要介紹如何使用PHP進(jìn)行微信開發(fā)的相關(guān)知識(shí)點(diǎn)，以及其中的一些技巧和注意事項(xiàng)。一、開發(fā)環(huán)境準(zhǔn)備在進(jìn)行微信開發(fā)之前，首先需要準(zhǔn)備好相應(yīng)的開發(fā)環(huán)境。具體來說，需要安裝PHP的運(yùn)行環(huán)境，以及微信公眾平臺(tái)提
