統(tǒng)一下單
應用場景
H5支付是指商戶在微信客戶端外的移動端網頁展示商品或服務,用戶在前述頁面確認使用微信支付時,商戶發(fā)起本服務呼起微信客戶端進行支付。 主要用于觸屏版的手機瀏覽器請求微信支付的場景。可以方便的從外部瀏覽器喚起微信支付。
接口鏈接
URL地址:https://api.mch.weixin.qq.com/pay/unifiedorder
是否需要證書
否
請求參數
字段名 | 變量名 | 必填 | 類型 | 示例值 | 描述 |
---|---|---|---|---|---|
公眾賬號ID | appid | 是 | String(32) | wxd678efh567hg6787 | 微信分配的公眾賬號ID(企業(yè)號corpid即為此appid) |
商戶號 | mch_id | 是 | String(32) | 1230000109 | 微信支付分配的商戶號 |
設備號 | device_info | 否 | String(32) | 013467007045764 | 終端設備號(門店號或收銀設備ID),注意:PC網頁或公眾號內支付請傳"WEB" |
隨機字符串 | nonce_str | 是 | String(32) | 5K8264ILTKCH16CQ2502SI8ZNMTM67VS | 隨機字符串,不長于32位。推薦隨機數生成算法 |
簽名 | sign | 是 | String(32) | C380BEC2BFD727A4B6845133519F3AD6 | 簽名,詳見簽名生成算法 |
簽名類型 | sign_type | 否 | String(32) | HMAC-SHA256 | 簽名類型,目前支持HMAC-SHA256和MD5,默認為MD5 |
商品描述 | body | 是 | String(128) | 騰訊充值中心-QQ會員充值 | 商品簡單描述,該字段須嚴格按照規(guī)范傳遞,具體請見參數規(guī)定 |
商品詳情 | detail | 否 | String(6000) | [{ "goods_detail":[ { "goods_id":"iphone6s_16G", "wxpay_goods_id":"1001", "goods_name":"iPhone6s 16G", "quantity":1, "price":528800, "goods_category":"123456", "body":"蘋果手機" }, { "goods_id":"iphone6s_32G", "wxpay_goods_id":"1002", "goods_name":"iPhone6s 32G", "quantity":1, "price":608800, "goods_category":"123789", "body":"蘋果手機" } ] }] |
單品優(yōu)惠字段(暫未上線) |
附加數據 | attach | 否 | String(127) | 深圳分店 | 附加數據,在查詢API和支付通知中原樣返回,該字段主要用于商戶攜帶訂單的自定義數據 |
商戶訂單號 | out_trade_no | 是 | String(32) | 20150806125346 | 商戶系統(tǒng)內部訂單號,要求32個字符內(最少6個字符),只能是數字、大小寫字母_-|*且在同一個商戶號下唯一。詳見商戶訂單號 |
貨幣類型 | fee_type | 否 | String(16) | CNY | 符合ISO 4217標準的三位字母代碼,默認人民幣:CNY,其他值列表詳見貨幣類型 |
總金額 | total_fee | 是 | int | 888 | 訂單總金額,單位為分,詳見支付金額 |
終端IP | spbill_create_ip | 是 | String(64) | 123.12.12.123 | 必須傳正確的用戶端IP,支持ipv4、ipv6格式,獲取方式詳見獲取用戶ip指引 |
交易起始時間 | time_start | 否 | String(14) | 20091225091010 | 訂單生成時間,格式為yyyyMMddHHmmss,如2009年12月25日9點10分10秒表示為20091225091010。其他詳見時間規(guī)則 |
交易結束時間 | time_expire | 否 | String(14) | 20091227091010 | 訂單失效時間,格式為yyyyMMddHHmmss,如2009年12月27日9點10分10秒表示為20091227091010。 |
商品標記 | goods_tag | 否 | String(32) | WXG | 商品標記,代金券或立減優(yōu)惠功能的參數,說明詳見代金券或立減優(yōu)惠 |
通知地址 | notify_url | 是 | String(256) | https://www.weixin.qq.com/wxpay/pay.php | 接收微信支付異步通知回調地址,通知url必須為直接可訪問的url,不能攜帶參數。 |
交易類型 | trade_type | 是 | String(16) | MWEB | H5支付的交易類型為MWEB |
商品ID | product_id | 否 | String(32) | 12235413214070356458058 | trade_type=NATIVE,此參數必傳。此id為二維碼中包含的商品ID,商戶自行定義。 |
指定支付方式 | limit_pay | 否 | String(32) | no_credit | no_credit--指定不能使用信用卡支付 |
用戶標識 | openid | 否 | String(128) | oUpF8uMuAJO_M2pxb1Q9zNjWeS6o | trade_type=JSAPI,此參數必傳,用戶在商戶appid下的唯一標識。openid如何獲取,可參考【獲取openid】。企業(yè)號請使用【企業(yè)號OAuth2.0接口】獲取企業(yè)號內成員userid,再調用【企業(yè)號userid轉openid接口】進行轉換 |
電子發(fā)票入口開放標識 | receipt | 否 | String(8) | Y | Y,傳入Y時,支付成功消息和支付詳情頁將出現(xiàn)開票入口。需要在微信支付商戶平臺或微信公眾平臺開通電子發(fā)票功能,傳此字段才可生效 |
場景信息 | scene_info | 是 | String(256) |
//IOS移動應用 {"h5_info": {"type":"IOS","app_name": "王者榮耀","bundle_id": "com.tencent.wzryIOS"}} //安卓移動應用 {"h5_info": {"type":"Android","app_name": "王者榮耀","package_name": "com.tencent.tmgp.sgame"}} //WAP網站應用 {"h5_info": {"type":"Wap","wap_url": "https://pay.qq.com","wap_name": "騰訊充值"}} //門店信息 {"store_info" : { "id": "SZTX001", "name": "騰大餐廳", "area_code": "440305", "address": "科技園中一路騰訊大廈" }} |
該字段用于上報支付的場景信息,針對H5支付有以下三種場景,請根據對應場景上報,H5支付不建議在APP端使用,針對場景1,2請接入APP支付,不然可能會出現(xiàn)兼容性問題 1,IOS移動應用 {"h5_info": //h5支付固定傳"h5_info" {"type": "", //場景類型 "app_name": "", //應用名 "bundle_id": "" //bundle_id } } 2,安卓移動應用 {"h5_info": //h5支付固定傳"h5_info" {"type": "", //場景類型 "app_name": "", //應用名 "package_name": "" //包名 } } 3,WAP網站應用 {"h5_info": //h5支付固定傳"h5_info" {"type": "", //場景類型 "wap_url": "",//WAP網站URL地址 "wap_name": "" //WAP 網站名 } } 4,門店信息 {"store_info" : { "id": "", //門店ID "name": "", //門店名稱 "area_code": "", //門店所在地行政區(qū)劃碼,詳細見《最新縣及縣以上行政區(qū)劃代碼》 "address": "" //門店地址 }} |
舉例如下:
<xml>
<appid>wx2421b1c4370ec43b</appid>
<attach>支付測試</attach>
<body>H5支付測試</body>
<mch_id>10000100</mch_id>
<nonce_str>1add1a30ac87aa2db72f57a2375d8fec</nonce_str>
<notify_url>https://wxpay.wxutil.com/pub_v2/pay/notify.v2.php</notify_url>
<openid>oUpF8uMuAJO_M2pxb1Q9zNjWeS6o</openid>
<out_trade_no>1415659990</out_trade_no>
<spbill_create_ip>14.23.150.211</spbill_create_ip>
<total_fee>1</total_fee>
<trade_type>MWEB</trade_type>
<scene_info>{"h5_info": {"type":"IOS","app_name": "王者榮耀","package_name": "com.tencent.tmgp.sgame"}}</scene_info>
<sign>0CB01533B8C1EF103065174F50BCA001</sign>
</xml>
注:參數值用XML轉義即可,CDATA標簽用于說明數據不被XML解析器解析。
返回結果
字段名 | 變量名 | 必填 | 類型 | 示例值 | 描述 |
---|---|---|---|---|---|
返回狀態(tài)碼 | return_code | 是 | String(16) | SUCCESS |
SUCCESS/FAIL 此字段是通信標識,非交易標識,交易是否成功需要查看trade_state來判斷 |
返回信息 | return_msg | 是 | String(128) | OK |
當return_code為FAIL時返回信息為錯誤原因 ,例如 簽名失敗 參數格式校驗錯誤 |
以下字段在return_code為SUCCESS的時候有返回
字段名 | 變量名 | 必填 | 類型 | 示例值 | 描述 |
---|---|---|---|---|---|
公眾賬號ID | appid | 是 | String(32) | wx8888888888888888 | 調用接口提交的公眾賬號ID |
商戶號 | mch_id | 是 | String(32) | 1900000109 | 調用接口提交的商戶號 |
設備號 | device_info | 否 | String(32) | 013467007045764 | 調用接口提交的終端設備號, |
隨機字符串 | nonce_str | 是 | String(32) | 5K8264ILTKCH16CQ2502SI8ZNMTM67VS | 微信返回的隨機字符串 |
簽名 | sign | 是 | String(32) | C380BEC2BFD727A4B6845133519F3AD6 | 微信返回的簽名,詳見簽名算法 |
業(yè)務結果 | result_code | 是 | String(16) | SUCCESS | SUCCESS/FAIL |
錯誤代碼 | err_code | 否 | String(32) | SYSTEMERROR | 詳細參見錯誤列表 |
錯誤代碼描述 | err_code_des | 否 | String(128) | 系統(tǒng)錯誤 | 錯誤返回的信息描述 |
以下字段在return_code 和result_code都為SUCCESS的時候有返回
字段名 | 變量名 | 必填 | 類型 | 示例值 | 描述 |
---|---|---|---|---|---|
交易類型 | trade_type | 是 | String(16) | MWEB | 調用接口提交的交易類型,取值如下:JSAPI,NATIVE,APP,,H5支付固定傳MWEB |
預支付交易會話標識 | prepay_id | 是 | String(64) | wx201410272009395522657a690389285100 | 微信生成的預支付會話標識,用于后續(xù)接口調用中使用,該值有效期為2小時,針對H5支付此參數無特殊用途 |
支付跳轉鏈接 | mweb_url | 是 | String(64) | https://wx.tenpay.com/cgi-bin/mmpayweb-bin/checkmweb?prepay_id=wx2016121516420242444321ca0631331346&package=1405458241 | mweb_url為拉起微信支付收銀臺的中間頁面,可通過訪問該url來拉起微信客戶端,完成支付,mweb_url的有效期為5分鐘。 |
舉例如下:
<xml>
<return_code><![CDATA[SUCCESS]]></return_code>
<return_msg><![CDATA[OK]]></return_msg>
<appid><![CDATA[wx2421b1c4370ec43b]]></appid>
<mch_id><![CDATA[10000100]]></mch_id>
<nonce_str><![CDATA[IITRi8Iabbblz1Jc]]></nonce_str>
<sign><![CDATA[7921E432F65EB8ED0CE9755F0E86D72F]]></sign>
<result_code><![CDATA[SUCCESS]]></result_code>
<prepay_id><![CDATA[wx201411101639507cbf6ffd8b0779950874]]></prepay_id>
<trade_type><![CDATA[MWEB]]></trade_type>
<mweb_url><![CDATA[https://wx.tenpay.com/cgi-bin/mmpayweb-bin/checkmweb?prepay_id=wx2016121516420242444321ca0631331346&package=1405458241]]></mweb_url>
</xml>
錯誤碼
名稱 | 描述 | 原因 | 解決方案 |
---|---|---|---|
NOAUTH | 商戶無此接口權限 | 商戶未開通此接口權限 | 請商戶前往申請此接口權限 |
ORDERPAID | 商戶訂單已支付 | 商戶訂單已支付,無需重復操作 | 商戶訂單已支付,無需更多操作 |
ORDERCLOSED | 訂單已關閉 | 當前訂單已關閉,無法支付 | 當前訂單已關閉,請重新下單 |
SYSTEMERROR | 系統(tǒng)錯誤 | 系統(tǒng)超時 | 系統(tǒng)異常,請用相同參數重新調用 |
APPID_NOT_EXIST | APPID不存在 | 參數中缺少APPID | 請檢查APPID是否正確 |
MCHID_NOT_EXIST | MCHID不存在 | 參數中缺少MCHID | 請檢查MCHID是否正確 |
APPID_MCHID_NOT_MATCH | appid和mch_id不匹配 | appid和mch_id不匹配 | 請確認appid和mch_id是否匹配 |
LACK_PARAMS | 缺少參數 | 缺少必要的請求參數 | 請檢查參數是否齊全 |
OUT_TRADE_NO_USED | 商戶訂單號重復 | 同一筆交易不能多次提交 | 請核實商戶訂單號是否重復提交 |
SIGNERROR | 簽名錯誤 | 參數簽名結果不正確 | 請檢查簽名參數和方法是否都符合簽名算法要求 |
XML_FORMAT_ERROR | XML格式錯誤 | XML格式錯誤 | 請檢查XML參數格式是否正確 |
REQUIRE_POST_METHOD | 請使用post方法 | 未使用post傳遞參數 | 請檢查請求參數是否通過post方法提交 |
POST_DATA_EMPTY | post數據為空 | post數據不能為空 | 請檢查post數據是否為空 |
NOT_UTF8 | 編碼格式錯誤 | 未使用指定編碼格式 | 請使用UTF-8編碼格式 |