最新更新時間：2020.09.10 版本說明
該接口主要用于Native支付模式一中的二維碼鏈接轉(zhuǎn)成短鏈接(weixin://wxpay/s/XXXXXX)，減小二維碼數(shù)據(jù)量，提升掃描速度和精確度。。
適用對象： 直連商戶 服務(wù)商
請求URL： https://api.mch.weixin.qq.com/tools/shorturl
冗災(zāi)備用URL： https://api2.mch.weixin.qq.com/tools/shorturl(備用域名)見跨城冗災(zāi)方案
請求方式： POST
數(shù)據(jù)格式： XML
是否需要證書： 否
| 參數(shù)名 | 變量 | 類型 | 必填 | 描述 |
|---|---|---|---|---|
| 應(yīng)用ID | appid | string[1,32] | 是 | 微信分配的應(yīng)用ID 示例值：wx8888888888888888 |
| 商戶號 | mch_id | string[1,32] | 是 | 微信支付分配的商戶號 示例值：1900000109 |
| 子商戶應(yīng)用ID | sub_appid | string[1,32] | 否 | 微信分配的子商戶應(yīng)用ID，如需在支付完成后獲取sub_openid則此參數(shù)必傳。 注意：僅適用于服務(wù)商模式 示例值：wx8888888888888888 |
| 子商戶號 | sub_mch_id | string[1,32] | 是 | 微信支付分配的子商戶號 注意：僅適用于服務(wù)商模式 示例值：1900000109 |
| URL鏈接 | long_url | string[1,512 | 是 | 需要轉(zhuǎn)換的URL，簽名用原串，傳輸需URL encode 示例值：weixin：//wxpay/bizpayurl?sign=XXXXX&appid=XXXXX&mch_id=XXXXX&product_id=XXXXXX&time_stamp=XXXXXX&nonce_str=XXXXX |
| 隨機字符串 | nonce_str | string[1,32] | 是 | 隨機字符串，不長于32位。推薦隨機數(shù)生成算法 示例值：5K8264ILTKCH16CQ2502SI8ZNMTM67VS |
| 簽名 | sign | string[1,64] | 是 | 簽名，詳見簽名生成算法 示例值：C380BEC2BFD727A4B6845133519F3AD6 |
<xml>
<appid>wxe062425f740c30d8</appid>
<mch_id>1900000109</mch_id>
<nonce_str>5K8264ILTKCH16CQ2502SI8ZNMTM67VS</nonce_str>
<short_url>weixin：//wxpay/s/XXXX</short_url>
<sign>3AE1368BD96B4644FA5823E024CFE938F1B852EFA87919EDDEE324AE24C8C04F</sign>
</xml>| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 返回狀態(tài)碼 | return_code | string[1,16] | 是 | SUCCESS/FAIL 此字段是通信標(biāo)識，非交易標(biāo)識，交易是否成功需要查看result_code來判斷 示例值：SUCCESS |
| 返回信息 | return_msg | string[1,128] | 否 | 返回信息，如非空，為錯誤原因 簽名失敗 參數(shù)格式校驗錯誤 示例值：簽名失敗 |
返回狀態(tài)碼(return_code)為SUCCESS的時候,包含以下字段
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 應(yīng)用ID | appid | string[1,32] | 是 | 服務(wù)商商戶的APPID 示例值：wx8888888888888888 |
| 子商戶應(yīng)用ID | sub_appid | string[1,32] | 是 | 調(diào)用接口提交的子商戶公眾賬號ID 注意：僅適用于服務(wù)商模式 示例值：wx8888888888888888 |
| 商戶號 | mch_id | string[1,32] | 是 | 調(diào)用接口提交的商戶號 示例值：1900000109 |
| 子商戶號 | sub_mch_id | string[1,32] | 是 | 調(diào)用接口提交的子商戶號 注意：僅適用于服務(wù)商模式 示例值：2100000109 |
| 設(shè)備號 | device_info | string[1,32] | 否 | 調(diào)用接口提交的終端設(shè)備號， 示例值：013467007045764 |
| 隨機字符串 | nonce_str | string[1,32] | 是 | 微信返回的隨機字符串 示例值：5K8264ILTKCH16CQ2502SI8ZNMTM67VS |
| 簽名 | sign | string[1,64] | 是 | 微信返回的簽名，詳見簽名生成算法 示例值：C380BEC2BFD727A4B6845133519F3AD6 |
| 業(yè)務(wù)結(jié)果 | result_code | string[1,16] | 是 | SUCCESS/FAIL 示例值：SUCCESS |
| 錯誤代碼 | err_code | string[1,32] | 否 | 枚舉值： SYSTEMERROR：系統(tǒng)錯誤 URLFORMATERROR：URL格式錯誤 示例值：SYSTEMERROR |
| URL鏈接 | short_url | string[1,64] | 是 | 轉(zhuǎn)換后的URL 示例值：weixin：//wxpay/s/XXXXXX |
返回狀態(tài)碼(return_code)和業(yè)務(wù)結(jié)果（result_code）都為SUCCESS的時候,包含以下字段
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 交易類型 | trade_type | string[1,16] | 是 | 支付類型為MICROPAY(即掃碼支付) 示例值：MICROPAY |
| 預(yù)支付交易會話標(biāo)識 | prepay_id | string[1,64] | 是 | 微信生成的預(yù)支付會話標(biāo)識，用于后續(xù)接口調(diào)用中使用，該值有效期為2小時 示例值：wx201410272009395522657a690389285100 |
| 二維碼鏈接 | code_url | string[1,64] | 是 | trade_type=NATIVE時有返回，此url用于生成支付二維碼，然后提供給用戶進(jìn)行掃碼支付。 注意：code_url的值并非固定，使用時按照URL格式轉(zhuǎn)成二維碼即可 示例值：weixin://wxpay/bizpayurl/up?pr=NwY5Mz9&groupid=00 |
<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[GOp3TRyMXzbMlkun]]></nonce_str> <sign><![CDATA[D6C76CB785F07992CDE05494BB7DF7FD]]></sign> <result_code><![CDATA[SUCCESS]]></result_code> <short_url><![CDATA[weixin：//wxpay/s/XXXXXX]]></short_url> </xml>
| 錯誤碼 | 描述 | 解決方案 |
|---|---|---|
| SIGNERROR | 簽名錯誤 | 請檢查簽名參數(shù)和方法是否都符合簽名算法要求 |
| REQUIRE_POST_METHOD | 請使用post方法 | 請檢查請求參數(shù)是否通過post方法提交 |
| APPID_NOT_EXIST | APPID不存在 | 請檢查APPID是否正確 |
| MCHID_NOT_EXIST | MCHID不存在 | 請檢查MCHID是否正確 |
| APPID_MCHID_NOT_MATCH | appid和mch_id不匹配 | 請確認(rèn)appid和mch_id是否匹配 |
| LACK_PARAMS | 缺少參數(shù) | 請檢查參數(shù)是否齊全 |
| XML_FORMAT_ERROR | XML格式錯誤 | 請檢查XML參數(shù)格式是否正確 |
| POST_DATA_EMPTY | post數(shù)據(jù)為空 | 請檢查post數(shù)據(jù)是否為空 |