支付寶小程序API 小程序跳轉(zhuǎn)

2020-09-16 15:50 更新

my.navigateBackMiniProgram

跳轉(zhuǎn)回上一個(gè)小程序,只有當(dāng)另一個(gè)小程序跳轉(zhuǎn)到當(dāng)前小程序時(shí)才會(huì)能調(diào)用成功。 相關(guān)問(wèn)題請(qǐng)參見(jiàn)下文 小程序跳轉(zhuǎn) FAQ。

示例代碼

my.navigateBackMiniProgram({
    extraData:{
       "data1":"test"
    },
    success: (res) => {
       console.log(JSON.stringify(res))
    },
    fail: (res) => {
       console.log(JSON.stringify(res))
    }
});

入?yún)?/h4>

Object 類(lèi)型,屬性如下:

屬性 類(lèi)型 必填 描述
extraData Object 需要傳遞給目標(biāo)小程序的數(shù)據(jù),目標(biāo)小程序可在 App.onLaunch()、App.onShow() 中獲取到這份數(shù)據(jù)。
success Function 調(diào)用成功的回調(diào)函數(shù)。
fail Function 調(diào)用失敗的回調(diào)函數(shù)。
complete Function 調(diào)用結(jié)束的回調(diào)函數(shù)(調(diào)用成功、失敗都會(huì)執(zhí)行)。

my.navigateToMiniProgram

跳轉(zhuǎn)到其他小程序。

相關(guān)問(wèn)題請(qǐng)參見(jiàn)下文 小程序跳轉(zhuǎn) FAQ。

示例代碼

my.navigateToMiniProgram({
      appId: 'xxxx',
      path: 'pages/index/index',
      extraData:{
        "data1":"test"
      },
      success: (res) => {
        console.log(JSON.stringify(res))
      },
      fail: (res) => {
        console.log(JSON.stringify(res))
      }
    });

入?yún)?/h4>

Object 類(lèi)型,屬性如下:

屬性 類(lèi)型 必填 描述
appId String 要跳轉(zhuǎn)的目標(biāo)小程序 appId。
path String 打開(kāi)的頁(yè)面路徑,如果為空則打開(kāi)首頁(yè)。
extraData Object 需要傳遞給目標(biāo)小程序的數(shù)據(jù),為鍵值對(duì)的格式,數(shù)值的類(lèi)型為字符串。目標(biāo)小程序可在 App.onLaunch() 、 App.onShow() 中獲取到這份數(shù)據(jù)。
success Function 調(diào)用成功的回調(diào)函數(shù)。
fail Function 調(diào)用失敗的回調(diào)函數(shù)。
complete Function 調(diào)用結(jié)束的回調(diào)函數(shù)(調(diào)用成功、失敗都會(huì)執(zhí)行)。

常見(jiàn)問(wèn)題 FAQ

my.navigateToMiniProgram 的 extraData 的參數(shù)在哪里獲取? extraData 是否可以添加多個(gè)參數(shù)?自定義參數(shù)中間使用的什么符號(hào)進(jìn)行拼接?

目標(biāo)小程序可在 App.onLaunch( )、App.onShow( ) 中獲取到這份數(shù)據(jù)。

extraData 可以添加多個(gè)參數(shù),自定義參數(shù)都是從這里傳入的。

自定義參數(shù)中間使用 & 符號(hào)進(jìn)行拼接。

小程序如何跳轉(zhuǎn)收藏有禮頁(yè)面?

可參考如下代碼。

my.navigateToMiniProgram({
     appId: '2018122562686742',//收藏有禮小程序的appid,固定值請(qǐng)勿修改
     path: 'pages/index/index?originAppId=2017082508366123&newUserTemplate=20190130000000119123',//收藏有禮跳轉(zhuǎn)地址和參數(shù)
     success: (res) => {
       // 跳轉(zhuǎn)成功
       my.alert({ content: 'success' });
     },
     fail: (error) => {
       // 跳轉(zhuǎn)失敗
       my.alert({ content: 'fail' });
     }
   });

小程序跳轉(zhuǎn) FAQ

小程序如何跳轉(zhuǎn)到 H5、其他小程序、已關(guān)聯(lián)的生活號(hào)、生活號(hào)文章、部分支付寶官方業(yè)務(wù)頁(yè)面?

小程序之間支持互相跳轉(zhuǎn)。小程序支持跳轉(zhuǎn)到內(nèi)嵌型 H5 、關(guān)聯(lián)的生活號(hào)、生活號(hào)文章頁(yè)面及部分支付寶官方業(yè)務(wù)頁(yè)面。小程序不支持跳轉(zhuǎn)到其他 App(例如淘寶、釘釘、高德等 App)。如下圖所示。

小程序跳轉(zhuǎn).png

小程序A跳轉(zhuǎn) 是否支持 使用限制 實(shí)現(xiàn)方法
H5 web-view 內(nèi)嵌式跳轉(zhuǎn) H5,僅限企業(yè)賬號(hào)小程序使用。 跳轉(zhuǎn)小程序內(nèi)嵌式 H5 頁(yè)面可通過(guò) web-view H5頁(yè)面承載組件實(shí)現(xiàn)在小程序內(nèi)打開(kāi) H5頁(yè)面。(僅限企業(yè)賬號(hào)小程序使用)。
小程序B(小程序A、小程序B由同一主體賬戶(hù)創(chuàng)建) 同主體小程序可直接互跳。支付寶客戶(hù)端 10.1.10 及以上版本支持。 使用 my.navigateToMiniProgramAPI 實(shí)現(xiàn)跳轉(zhuǎn)。
小程序C(小程序A、小程序C由不同一主體賬戶(hù)創(chuàng)建) 不同主體小程序互跳,需對(duì)方在 小程序管理后臺(tái),設(shè)置 > 基礎(chǔ)設(shè)置 > 小程序相互跳轉(zhuǎn) 中設(shè)置為“允許所有小程序跳轉(zhuǎn)”或“指定小程序跳轉(zhuǎn)”支付寶客戶(hù)端 10.1.25 及以上版本支持。 使用 my.navigateToMiniProgramAPI 實(shí)現(xiàn)跳轉(zhuǎn)。
關(guān)聯(lián)的生活號(hào) 小程序需與生活號(hào)進(jìn)行關(guān)聯(lián)綁定。 使用 life-follow 組件和 lifestyle 組件,可跳轉(zhuǎn)至已和當(dāng)前小程序關(guān)聯(lián)的生活號(hào)。
生活號(hào)文章頁(yè)面/部分支付寶官方業(yè)務(wù)頁(yè)面 僅支持跳轉(zhuǎn)到部分支付寶官方業(yè)務(wù)或運(yùn)營(yíng)活動(dòng)頁(yè)面。可跳轉(zhuǎn)域名以 https://render.alipay.com/p開(kāi)頭的生活號(hào)文章頁(yè)面。 請(qǐng)參見(jiàn):my.ap.navigateToAlipayPage
其他 APP - -

H5、小程序、生活號(hào)、其他 App 如何跳轉(zhuǎn)到小程序?

小程序之間可以互相跳轉(zhuǎn)。關(guān)聯(lián)的生活號(hào)也可以跳轉(zhuǎn)到小程序。生活號(hào)文章頁(yè)面、支付寶內(nèi)的 H5 頁(yè)面、其他 App 可通過(guò) scheme 拼接的方式,打開(kāi)支付寶小程序頁(yè)面。如下圖所示。

小程序跳轉(zhuǎn)2 (3).png

跳轉(zhuǎn)到小程序A 是否支持 使用限制 實(shí)現(xiàn)方法
小程序B 當(dāng)小程序A跳轉(zhuǎn)至小程序B,小程序B再跳轉(zhuǎn)到當(dāng)前小程序A時(shí)才會(huì)調(diào)用成功。 my.navigateBackMiniProgram
關(guān)聯(lián)的生活號(hào) 小程序需與生活號(hào)進(jìn)行關(guān)聯(lián)綁定。
其他 App 或 外部 H5 支付寶小程序不限制來(lái)自 H5 頁(yè)面或者其他 APP 的跳轉(zhuǎn),只要 H5 頁(yè)面或者其他 App 支持外跳小程序即可跳轉(zhuǎn)。至少需要上架一次小程序,才能使用該跳轉(zhuǎn)方式測(cè)試。沒(méi)有上架的小程序無(wú)法被跳轉(zhuǎn)。(即體驗(yàn)版小程序不能使用該方式跳轉(zhuǎn)。) 其他 APP 或 外部 H5 跳轉(zhuǎn)小程序目前有兩種方式可以跳轉(zhuǎn):Scheme 拼接方式: 前綴https://ds.alipay.com/?scheme= 后拼接 Scheme alipays://platformapi/startapp?appId=xxx&page=x/y/z&query=xx%3dxx具體實(shí)現(xiàn)方式請(qǐng)參考 從 Scheme 傳參喚起小程序。2. 小程序二維碼 方式:生成小程序二維碼,獲取二維碼包含的內(nèi)容鏈接,使用該內(nèi)容鏈接跳轉(zhuǎn)。例如 小程序官方示例 的二維碼鏈接為: https://qr.alipay.com/s6x09210ka4u33onnn3sud0
生活號(hào)文章頁(yè)面 支付寶小程序不限制來(lái)自生活號(hào)文章 H5 頁(yè)面的跳轉(zhuǎn)。 可在生活號(hào)文章 H5頁(yè)面內(nèi)嵌入小程序跳轉(zhuǎn)鏈接,實(shí)現(xiàn)方式與上方“其他 App 或外部 H5”完全相同。

商戶(hù)會(huì)員卡/支付寶卡包與小程序之間如何相互跳轉(zhuǎn)?

商戶(hù)會(huì)員卡/支付寶卡包 如何跳轉(zhuǎn)小程序?

從 商戶(hù)會(huì)員卡/支付寶卡包 跳轉(zhuǎn)至小程序可使用 Scheme 頁(yè)面內(nèi)跳轉(zhuǎn)協(xié)議, alipays://platformapi/startApp?appId=xxx&page=x/yz ,對(duì)應(yīng)相應(yīng)的 appIdpage 名稱(chēng)即可。

小程序如何跳轉(zhuǎn)至商戶(hù)會(huì)員卡/支付寶卡包?

小程序跳轉(zhuǎn)商戶(hù)會(huì)員卡/支付寶卡包可使用以下接口:

接口名稱(chēng) 接口描述
my.openCardList 打開(kāi)支付寶卡包中的“卡”列表
my.openMerchantCardList 打開(kāi)當(dāng)前用戶(hù)領(lǐng)取某個(gè)商戶(hù)的“卡”列表
my.openCardDetail 打開(kāi)當(dāng)前用戶(hù)領(lǐng)取某張卡的詳情頁(yè)
my.openVoucherList 打開(kāi)支付寶卡包中的“券”列表
my.openMerchantVoucherList 打開(kāi)當(dāng)前用戶(hù)領(lǐng)取某個(gè)商戶(hù)的“券”列表
my.openVoucherDetail 打開(kāi)當(dāng)前用戶(hù)領(lǐng)取某張券的詳情頁(yè)(非口碑券)
my.openKBVoucherDetail 打開(kāi)當(dāng)前用戶(hù)領(lǐng)取某張券的詳情頁(yè)(口碑券)
my.openTicketList 打開(kāi)支付寶卡包中的“票”列表
my.openMerchantTicketList 打開(kāi)當(dāng)前用戶(hù)領(lǐng)取某個(gè)商戶(hù)的“票”列表
my.openTicketDetail 打開(kāi)當(dāng)前用戶(hù)領(lǐng)取某張票的詳情頁(yè)

支付寶小程序相互跳轉(zhuǎn)有個(gè)數(shù)限制嗎?

支付寶小程序相互跳轉(zhuǎn)無(wú)個(gè)數(shù)限制,只要滿(mǎn)足條件是允許跳轉(zhuǎn)的就可以進(jìn)行跳轉(zhuǎn)。

小程序跳轉(zhuǎn)其他頁(yè)面為何報(bào) query string length is more than %d,please do not use query string?

此錯(cuò)誤是由于頁(yè)面 query 字段過(guò)長(zhǎng)導(dǎo)致,建議將數(shù)據(jù)設(shè)置到全局或者緩存中。

小程序如何跳轉(zhuǎn)收藏有禮頁(yè)面?

可參考如下代碼。

my.navigateToMiniProgram({
     appId: '2018122562686742',//收藏有禮小程序的appid,固定值請(qǐng)勿修改
     path: 'pages/index/index?originAppId=2017082508366123&newUserTemplate=20190130000000119123',//收藏有禮跳轉(zhuǎn)地址和參數(shù)
     success: (res) => {
       // 跳轉(zhuǎn)成功
       my.alert({ content: 'success' });
     },
     fail: (error) => {
       // 跳轉(zhuǎn)失敗
       my.alert({ content: 'fail' });
     }
   });
以上內(nèi)容是否對(duì)您有幫助:
在線(xiàn)筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)