视频一区二区三区自拍_千金肉奴隷1985未删减版在线观看_国产成人黄色视频在线播放_少女免费播放片高清在线观看_国产精品v欧美精品v

Login expired. Please log in again.

Feedback

0/300

Feedback

Submitted successfully

ok

Feedback

Network exception, please try again later

ok

APP簽約API

最新更新時(shí)間:2024.03.18 版本說(shuō)明

用戶(hù)在商戶(hù)的APP中發(fā)起簽約,跳轉(zhuǎn)到微信客戶(hù)端簽約小程序完成簽約,簽約完成后重新打開(kāi)商戶(hù)APP。 移動(dòng)應(yīng)用(APP)接入開(kāi)放平臺(tái)SDK后,用戶(hù)即可以在 APP 中跳轉(zhuǎn)至微信某一小程序的指定頁(yè)面,完成服務(wù)后再跳回至商戶(hù)APP 。

注意:

? APP簽約分為兩個(gè)步驟,步驟1通過(guò)預(yù)簽約接口獲得session_id,再通過(guò)步驟2調(diào)起簽約

步驟1:預(yù)簽約API

1. 接口說(shuō)明

適用對(duì)象: 直連模式 機(jī)構(gòu)模式

請(qǐng)求URL:https://apihk.mch.weixin.qq.com/v3/global/papay/contracts/app-pre-entrust-sign

請(qǐng)求方式:POST


Path指該參數(shù)為路徑參數(shù)
Query指該參數(shù)為URL參數(shù)
Body指該參數(shù)需在請(qǐng)求JSON傳參

2. 請(qǐng)求參數(shù)

參數(shù)名 變量 類(lèi)型[長(zhǎng)度限制] 必填 描述
應(yīng)用ID appid string[1, 32] Body商戶(hù)號(hào)綁定的AppID
注意:僅適用于直連模式
示例值:wxcbda96de0b165486
子商戶(hù)號(hào) sub_mchid string[1, 32] Body微信支付分配的子商戶(hù)號(hào)
注意:僅適用于機(jī)構(gòu)模式
示例值:10000097
服務(wù)商應(yīng)用ID sp_appid string[1, 32] Body服務(wù)商綁定的AppID
注意:僅適用于機(jī)構(gòu)模式
示例值:wxcbda96de0b165486
子商戶(hù)應(yīng)用ID sub_appid string[1, 32] Body發(fā)起簽約的子商戶(hù)號(hào)綁定的AppID
注意:僅適用于機(jī)構(gòu)模式
示例值:wxcbda96de0b165484
模板ID plan_id int Body協(xié)議模板ID,該模板ID是商戶(hù)在向微信支付提交代扣權(quán)限申請(qǐng)時(shí)由微信支付生成
示例值:123
商戶(hù)側(cè)簽約協(xié)議號(hào) out_contract_code string[1, 32] Body商戶(hù)請(qǐng)求簽約時(shí)傳入的簽約協(xié)議號(hào),商戶(hù)側(cè)須唯一
示例值:100001256
用戶(hù)賬戶(hù)展示名稱(chēng) user_display_name string[1, 32] Body簽約用戶(hù)的名稱(chēng),用于頁(yè)面展示,不需要對(duì)值進(jìn)行URL編碼,參數(shù)值不支持UTF8非3字節(jié)編碼的字符,例如表情符號(hào),所以請(qǐng)勿傳微信昵稱(chēng)到該字段
示例值:張三
簽約成功通知URL success_notify_url string[1, 256] BodyHTTPS開(kāi)頭的回調(diào)通知URL ,不需要對(duì)值進(jìn)行URL編碼
示例值:https://yoursite.com
商戶(hù)AppID下的用戶(hù)標(biāo)識(shí) openid string[1, 128] Body用戶(hù)在商戶(hù)AppID下的OpenID,服務(wù)商模式為子商戶(hù)下的用戶(hù)OpenID,可詳見(jiàn)獲取openid
示例值:ouFhd5X9s9WteC3eWRjXV3lea123
用戶(hù)客戶(hù)端IP user_client_ip string[1, 32] Body該字段要求填入用戶(hù)客戶(hù)端的IP,用戶(hù)簽約時(shí)會(huì)校驗(yàn)用戶(hù)客戶(hù)端IP與商戶(hù)傳的用戶(hù)客戶(hù)端IP一致,若不一致則視為商戶(hù)引導(dǎo)的用戶(hù)和實(shí)際訪(fǎng)問(wèn)用戶(hù)不一致,會(huì)拒絕該簽約請(qǐng)求。
示例值:119.145.83.6
過(guò)期時(shí)間 expired_time string[1, 64] Body境外代扣簽約會(huì)話(huà)ID過(guò)期時(shí)間,遵循rfc3339標(biāo)準(zhǔn)格式,格式為YYYY-MM-DDTHH:mm:ss+TIMEZONE,YYYY-MM-DD表示年月日,T出現(xiàn)在字符串中,表示time元素的開(kāi)頭,HH:mm:ss表示時(shí)分秒,TIMEZONE表示時(shí)區(qū)(+08:00表示東八區(qū)時(shí)間,領(lǐng)先UTC 8小時(shí),即北京時(shí)間)。例如:2021-11-20T13:29:35+08:00表示,北京時(shí)間2021年11月20日 13點(diǎn)29分35秒。
示例值:2021-11-20T13:29:35+08:00

請(qǐng)求示例

{
	  "appid": "wxcbda96de0b165486",
	  "expired_time": "2021-11-20T13:29:35+08:00",
	  "openid": "ouFhd5X9s9WteC3eWRjXV3lea123",
	  "out_contract_code": "100001256",
	  "plan_id": 123,
	  "success_notify_url": "https://yoursite.com",
	  "user_client_ip": "119.145.83.6",
	  "user_display_name": "張三"
}
{
	  "expired_time": "2021-11-20T13:29:35+08:00",
	  "openid": "ouFhd5X9s9WteC3eWRjXV3lea123",
	  "out_contract_code": "100001256",
	  "plan_id": 123,
	  "sp_appid": "wxcbda96de0b165486",
	  "sub_appid": "wxcbda96de0b165484",
	  "sub_mchid": "10000097",
	  "success_notify_url": "https://yoursite.com",
	  "user_client_ip": "119.145.83.6",
	  "user_display_name": "張三"
}

3. 返回參數(shù)

參數(shù)名 變量 類(lèi)型[長(zhǎng)度限制] 必填 描述
委托代扣簽約會(huì)話(huà)ID session_id string[1,128] 微信返回的委托代扣簽約會(huì)話(huà)ID
示例值:201710180325670965

返回示例

{
  "session_id": "201710180325670965"
}

4. 錯(cuò)誤碼

狀態(tài)碼 錯(cuò)誤碼 描述 解決方案
403 CONTRACT_NOT_EXIST Result Empty 查詢(xún)的簽約協(xié)議不存在,或者傳入正確查詢(xún)參數(shù)重試
403 CONTRACT_EXISTED 已開(kāi)通自動(dòng)扣費(fèi)服務(wù)功能,無(wú)需重復(fù)開(kāi)通 已開(kāi)通自動(dòng)扣費(fèi)服務(wù)功能,無(wú)需重復(fù)開(kāi)通;如需重新簽約,需解約后再發(fā)起簽約
400 PARAM_ERROR 參數(shù)錯(cuò)誤 傳入正確查詢(xún)參數(shù)
500 SYSTEM_ERROR 系統(tǒng)錯(cuò)誤 請(qǐng)稍等重試


步驟2:簽約接口

時(shí)序圖

簡(jiǎn)介

App跳轉(zhuǎn)微信側(cè)小程序需要引用新的openSDK

Android openSDK下載地址(版本>=5.3.1):Android資源下載

Android 接入文檔鏈接:openSDK說(shuō)明文檔/

iOS openSDK下載地址(版本>=1.8.4):iOS資源下載

iOS 接入文檔鏈接:openSDK說(shuō)明文檔

接口名稱(chēng):WXOpenBusinessView

接口兼容:

● iOS兼容性表現(xiàn):若微信版本 >= 7.0.3,開(kāi)發(fā)者可以通過(guò)此openSDK接口跳轉(zhuǎn)到微信支付分小程序;若微信版本 < 7.0.3,開(kāi)發(fā)者通過(guò)此openSDK接口可以跳轉(zhuǎn)到微信,但不能跳轉(zhuǎn)到微信支付分小程序,此時(shí)微信會(huì)提示用戶(hù)可能由于應(yīng)用的請(qǐng)求非法或者微信版本過(guò)低。
● Android兼容性表現(xiàn):若微信版本>=7.0.3,開(kāi)發(fā)者可以通過(guò)此openSDK接口跳轉(zhuǎn)到微信支付分小程序;若微信版本 < 7.0.3,開(kāi)發(fā)者通過(guò)此openSDK接口不能跳轉(zhuǎn)到微信,此時(shí)開(kāi)發(fā)者應(yīng)提示用戶(hù)更新微信版本。


請(qǐng)求參數(shù)

參數(shù)名 變量 類(lèi)型[長(zhǎng)度限制] 必填 描述
跳轉(zhuǎn)類(lèi)型 businessType string[1, 32] 固定值:wxpayOverseaEntrustAuthorization
示例值:wxpayOverseaEntrustAuthorization
委托代扣簽約會(huì)話(huà)ID sessionId string[1, 128] 預(yù)簽約API中的返回值 session_id,由 APP 預(yù)簽約接口獲得
示例值:201710180325670965

請(qǐng)求示例

WXOpenBusinessViewReq *req = [WXOpenBusinessViewReq object];
req.businessType = @"wxpayOverseaEntrustAuthorization"; // 固定值
req.query = @"sessionId=20211115171992080208"; // 20211115171992080208為預(yù)簽約會(huì)話(huà)ID
req.extInfo = @"{\"miniProgramType\":0}"; // 固定值
[WXApi sendReq:req];
// 發(fā)起簽約
int wxSdkVersion = api.getWXAppSupportAPI();
if (wxSdkVersion >= Build.OPEN_BUSINESS_VIEW_SDK_INT) {
WXOpenBusinessView.Req req = new WXOpenBusinessView.Req();
req.businessType = "wxpayOverseaEntrustAuthorization"; // 固定值
String SesssionId = "20211115171992080208"; // 預(yù)簽約會(huì)話(huà)ID,通過(guò)下述預(yù)簽約API獲取
req.query = "sessionId=" + SesssionId; // 拼接參數(shù)
req.extInfo = "{\"miniProgramType\": 0}"; // 固定值
Boolean ret = api.sendReq(req);
} else {
// 微信版本太低,在這里提示用戶(hù)升級(jí)后再完成簽約
}

/********在WXEntryActivity的onResp里面接收簽約結(jié)束回調(diào),示例代碼*******/
@Override
public void onResp(BaseResp r) {
if (r.getType() == ConstantsAPI.COMMAND_OPEN_BUSINESS_VIEW) {
WXOpenBusinessView.Resp launchMiniProgramResp = (WXOpenBusinessView.Resp) r;
String text = String.format("nextMsg=%snerrStr=%snbusinessType=%s",
resp.extMsg, resp.errStr, resp.businessType);
Toast.makeText(this, text, Toast.LENGTH_lONG).show();
// 對(duì)應(yīng)時(shí)序圖步驟3.4 - 3.6,調(diào)用查詢(xún)簽約API獲取協(xié)議最新?tīng)顟B(tài),然后更新商戶(hù)側(cè)簽約狀態(tài)
}
}
    頁(yè)面導(dǎo)航

版本說(shuō)明

關(guān)閉
V1.0
2021年12月8日
1. APP簽約API上線(xiàn)

About  WeChat  Pay

Powered By Tencent & Tenpay Copyright©

2005-2024 Tenpay All Rights Reserved.

Contact Us
Wechat Pay Global

WeChat Pay Global

置頂