最新更新時間：2023.05.18 版本說明
外部App拉起微信客戶端發(fā)起簽約前，需先后臺調(diào)用預(yù)簽約接口完成預(yù)簽約，獲取pre_entrustweb_id，再拉起微信客戶端，完成簽約，返回App。
? 該業(yè)務(wù)接口暫未全面開放，暫只支持由微信支付運營人員代為申請，如有需求請咨詢與您對接的微信支付運營人員。如無對接的微信支付人員，請等待產(chǎn)品全面開放，我們將另行通知。
適用對象：直連商戶
請求URL： https://api.mch.weixin.qq.com/papay/preentrustweb
請求方式： POST
數(shù)據(jù)格式： XML
簽名方式： HMAC-SHA256、MD5
是否需要證書： 否
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 應(yīng)用ID | appid | string[1,32] | 是 | 直連商戶申請的公眾號或移動應(yīng)用appid。 （請登錄開放平臺查看，注意與公眾號的APPID不同） 示例值：wxcbda96de0b165486 |
| 商戶號 | mch_id | string[1,32] | 是 | 商戶號是商戶在微信申請微信支付成功后分配的賬號ID，登錄平臺為www.tg885.com 示例值：1200009811 |
| 模板id | plan_id | string[1,28] | 是 | 協(xié)議模板id，設(shè)置路徑見開發(fā)步驟。 示例值：12535 |
| 簽約協(xié)議號 | contract_code | string[1,128] | 是 | 商戶側(cè)的簽約協(xié)議號，由商戶生成，只能是數(shù)字、大小寫字母的描述。 示例值：100000 |
| 請求序列號 | request_serial | int 64 | 是 | 商戶請求簽約時的序列號，要求唯一性。禁止使用0開頭，序列號主要用于排序，不作為查詢條件，純數(shù)字，范圍不能超過int64的范圍（9223372036854775807）。 示例值：1000 |
| 用戶賬戶展示名稱 | contract_display_account | string[1,128] | 是 | 簽約用戶的名稱，用于頁面展示，參數(shù)值不支持UTF8非3字節(jié)編碼的字符，例如表情符號，所以請勿傳微信昵稱到該字段 示例值：微信代扣 |
| 回調(diào)通知url | notify_url | string[1,256] | 是 | 用于接收簽約成功消息的回調(diào)通知地址，以http或https開頭，通知url必須為外網(wǎng)可訪問的url，不能攜帶參數(shù)。 |
| 版本號 | version | string[1,8] | 是 | 固定值1.0 示例值：1.0 |
| 簽名類型 | sign_type | string[1,32] | 否 | MD5或者HMAC-SHA256，不填默認MD5 注意：app預(yù)簽約的默認簽名方式是(sign_type為空或無該字段)：MD5 示例值：MD5 |
| 簽名 | sign | string[1,64] | 是 | 詳見簽名生成算法 示例值：C380BEC2BFD727A4B6845133519F3AD6 |
| 時間戳 | timestamp | string[1,10] | 是 | 系統(tǒng)當(dāng)前時間，10位 示例值：1414488825 |
| 返回app | return_app | string[1,1] | 否 | 用來控制簽約頁面結(jié)束后的返回路徑（不傳此參數(shù)，則簽約完成后停留在微信內(nèi)）。 Y表示返回app, 不填則不返回 注：簽約參數(shù)appid必須為發(fā)起簽約的app所有，且在微信開放平臺注冊過。 ios和android用戶點完成按鈕才返回原APP，直接右劃關(guān)閉頁面或左上角不支持返回APP 示例值：Y |
<xml>
<appid>wxcbda96de0b165486</appid>
<mch_id>1200009811</mch_id>
<plan_id>12535</plan_id>
<contract_code>100000</contract_code>
<request_serial>1000</request_serial>
<contract_display_account>微信代扣</contract_display_account>
<notify_url>https://weixin.qq.com</notify_url>
<version>1.0</version>
<sign_type>MD5</sign_type>
<sign>C380BEC2BFD727A4B6845133519F3AD6</sign>
<timestamp>1414488825</timestamp>
<return_app>Y</return_app>
</xml>
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 返回狀態(tài)碼 | return_code | string[1,16] | 是 | SUCCESS/FAIL 非簽約結(jié)果標(biāo)識，簽約發(fā)起是否成功需要查看result_code來判斷。 示例值：SUCCESS |
| 返回信息 | return_msg | string[1,128] | 否 | 返回信息，如非空，為錯誤原因 如：簽名失敗 等。 示例值：簽名失敗 |
以下字段在return_code為SUCCESS的時候有返回
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 業(yè)務(wù)結(jié)果 | result_code | string[1,16] | 是 | SUCCESS/FAIL 示例值：SUCCESS |
| 錯誤代碼 | err_code | string[1,32] | 否 | 錯誤碼 示例值：SIGN_ERROR |
| 錯誤代碼描述 | err_code_des | string[1,32] | 否 | 錯誤碼描述 示例值：簽名錯誤 |
| 應(yīng)用ID | appid | string[1,32] | 是 | 直連商戶申請的公眾號或移動應(yīng)用appid。 （請登錄開放平臺查看，注意與公眾號的APPID不同） 示例值：wxcbda96de0b165486 |
| 商戶號 | mch_id | string[1,32] | 是 | 商戶號是商戶在微信申請微信支付成功后分配的賬號ID，登錄平臺為www.tg885.com 示例值：1200009811 |
| 簽名 | sign | string[1,64] | 是 | 詳見簽名生成算法 示例值：C380BEC2BFD727A4B6845133519F3AD6 |
| 隨機字符串 | nonce_str | string[1,32] | 是 | 隨機字符串，不長于32位。推薦隨機數(shù)生成 示例值：5K8264ILTKCH16CQ2502SI8ZNMTM67VS |
以下字段在return_code 、result_code都為SUCCESS時有返回
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 預(yù)簽約id | pre_entrustweb_id | string[1,128] | 是 | 預(yù)簽約id，兩個小時內(nèi)有效 示例值：5778aadY9nltAsZzXixCkFIGYnV2V |
<xml>
<return_code><![CDATA[SUCCESS]]></return_code>
<return_msg><![CDATA[OK]]></return_msg>
<result_code><![CDATA[SUCCESS]]></result_code>
<appid><![CDATA[wxcbda96de0b165486]]></appid>
<mch_id><![CDATA[10000098]]></mch_id>
<nonce_str><![CDATA[IITRi8Iabbblz1Jc]]></nonce_str>
<sign><![CDATA[E1EE61A91C8E90F299DE6AE075D60A2D]]></sign>
<pre_entrustweb_id><![CDATA[5778aadY9nltAsZzXixCkFIGYnV2V]]></pre_entrustweb_id>
</xml>
| 錯誤碼 | 描述 | 解決方案 |
|---|---|---|
| SYSTEMERROR | 接口返回錯誤 | 請使用相同參數(shù)再次調(diào)用API |
| PARAMERROR | 參數(shù)錯誤 | 請根據(jù)接口返回的詳細信息檢查您的程序 |
| SIGNERROR | 簽名錯誤 | 請根據(jù)指引生成正確簽名 |
| PAYAUTHERROR | 權(quán)限校驗錯誤 | 確認商戶委托代扣權(quán)限權(quán)限 |
一、該接口需要額外申請OpenBusinessWebview權(quán)限，請聯(lián)系對接您的運營同學(xué)協(xié)助申請，具體參看接入流程
郵件模板如下：
標(biāo)題：OpenBusinessWebview權(quán)限申請_APP純簽約
正文：
（1）說明使用背景
（2）appid、mchid（appid和mchid需要有綁定關(guān)系）
二、在微信開放平臺（open.weixin.qq.com）注冊APP信息
三、在開放平臺-資源中心下載SDK：資源下載
四、按照下面的接口指引文檔完成對接
適用對象：直連商戶 服務(wù)商
請求方式： POST
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 預(yù)簽約id | pre_entrustweb_id | string[1,128] | 是 | 預(yù)簽約id 示例值：5778aadY9nltAsZzXixCkFIGYnV2V |
WXOpenBusinessWebViewReq *req = [[WXOpenBusinessWebViewReq alloc] init];
req.businessType =12; //固定值
NSMutableDictionary *queryInfoDic = [NSMutableDictionary dictionary];
[queryInfoDic setObject:"5778aadY9nltAsZzXixCkFIGYnV2V" forKey:"pre_entrustweb_id"];
req.queryInfoDic = queryInfoDic;
[WxApi sendReq:req];