开发者社区
社区提问意见反馈
开发者钉组织
扫描二维码
加入支付宝开发者钉组织
基础 api
基础
应用级事件
界面
跳转
小程序相互跳转
打开半屏小程序
跳转支付宝应用或页面
重启/退出小程序
多媒体
缓存
文件
位置
网络
设备
worker
数据安全
分享
收藏
自定义通用菜单
更新管理
web-view组件控制
升级支付宝最新版本
隐私信息授权
小程序广告
开放能力 api
开发 > api > 基础 api > 跳转 > 跳转支付宝应用或页面
收藏
我的文档
设置
检测到你在内网环境,请查询专为内部编写的

my.ap.navigatetoalipaypage(object object)

此 api 已停止维护,文档即将下线(线上已有业务不受影响)

替代方案:

  • 已知目标业务的 appcode,请使用 my.ap.openalipayapp 跳转。
  • 已知目标页面的 url 或 scheme,请尝试使用 my.ap.openurl推荐优先使用 检测和生成代码

基础库 1.10.0 或更高版本, 且 支付宝客户端 10.1.32 或更高版本。 若版本较低,建议采取 兼容处理

小程序开发者工具: 不支持。

主体: 企业支付宝小程序个人支付宝小程序

相关文档: 小程序外跳和内嵌能力导航my.ap.openalipayappmy.ap.openurl

my.ap.navigatetoalipaypage 跳转到支付宝官方业务或运营活动页面。

在小程序中跳转支付宝业务或打开链接,请按下表分情况处理:

跳转目标跳转方法
支付宝业务appcode 列表 所列举的业务使用 my.ap.openalipayapp
已知 appid 的官方小程序使用 my.navigatetominiprogram
其他情况不支持跳转
支付宝 url
https://*.alipay.com/*
以 https://render.alipay.com/p/ 开头的 url使用 my.ap.openurl
域名为 ur.alipay.com 或 m.alipay.com 的短链接
或以 https://ds.alipay.com/?scheme= 开头的 url
使用 检测并生成代码
其他情况开放范围 内的小程序,使用 my.ap.openurl(需在小程序控制台申请添加白名单);其他类目的小程序,暂不支持跳转
支付宝 scheme
alipays://*
scheme 中的 appid 为 16 位转换成 my.navigatetominiprogram 调用,参考其常见问题 拿到目标小程序的 scheme (以 alipays:// 开头),应该如何跳转
scheme 中的 appid 为 20000067使用 检测并生成代码
其他情况开放范围 内的小程序,使用 my.ap.openurl(需在小程序控制台申请添加白名单);其他类目的小程序,暂不支持跳转
非支付宝 url开发者自有页面使用 web-view 组件
需要在小程序后台添加域名并上传校验文件
第三方页面开放范围 内的小程序,使用 my.ap.openurl(需在小程序控制台申请添加白名单);其他类目的小程序,暂不支持跳转

注:上表中链接类目标的跳转逻辑,均已集成到 ,推荐使用它来做检测并生成代码。

object object

查看示例
属性类型默认值必填兼容性描述
appcodestring-
支付宝: 10.1.62
跳转目标业务代码。与 path 二选一。
枚举值描述兼容性
alipayscan支付宝扫一扫-
redpacket收到的红包页面-
collectoil爱攒油页面-
tinyappshh小程序快报生活号-
antforest蚂蚁森林。appparams 可以传 autoshowprops。-
antfarm蚂蚁庄园-
stockdetail股票详情页。appparams 可以传 symbol 和 market 。-
paycode支付宝付款码。
注意:个人小程序不支持跳转付款码。
-
appparamsobject--与 appcode 配套使用的跳转参数。
属性类型描述
autoshowpropsnumber是否显示背包,取值 0 或者 1,默认为 0(不显示)。
当 appcode 为 antforest 时生效
symbolstring股票代码,如 'baba';若不传,则跳转到股票自选页面。
当 appcode 为 stockdetail 时生效。
marketstring股票所在市场,可取值为 'sh' / 'sz' / 'hk' / 'a' / 'o' / 'n' / 'usi';若不传,则跳转到股票自选页面。
当 appcode 为 stockdetail 时生效。
pathstring--跳转目标支付宝页面 url,请传入 encodeuricomponent(url),其中 url 为支付宝页面,必须以 https://render.alipay.com/p/ 开头。与 appcode 二选一。
注:如需打开非支付宝页面,请使用 my.ap.openurl
successfunction--调用成功的回调函数。
failfunction--调用失败的回调函数。
completefunction--调用结束的回调函数(调用成功、失败都会执行)。

fail 回调的参数为 object,error 属性为错误码,errormessage 属性为错误消息。

错误码错误消息凯发app官方网站的解决方案
2跳转失败

可通过以下方式检查:

  • 请检查入参拼写是否正确,如:appcode 拼写错误,ios 上会报此错。
  • 如果入参无误,请通过本页右下角 “在线咨询” 排查解决。
参数错误请检查入参是否正确,可以参考入参描述。
参数无效请检查 path 是否为正确页面地址。
30指定参数不可跳转,请申请权限

请检查入参 path 是否可以跳转,可参考入参 path 的描述,或通过 检查。

注:此错误码在支付宝 10.5.36 版本支持,之前版本为 错误码 2 。

60001处理异常,请稍后再试。api 内部异常,请稍后重试。
使用 path 跳转
使用 appcode 打开支付宝扫一扫
使用 appcode 打开指定股票详情页
// 打开支付宝运营活动页
my.ap.navigatetoalipaypage({
    path: encodeuricomponent('https://render.alipay.com/p/404'), // 注意只支持特定前缀的 url 
    success: res => {
        console.log('navigatetoalipaypage success', res);
    },
    fail: err => {
        console.log('navigatetoalipaypage fail', err);
    },
});
my.ap.navigatetoalipaypage({
    appcode: 'alipayscan',
    success: res => {
        console.log('navigatetoalipaypage success', res);
    },
    fail: err => {
        console.log('navigatetoalipaypage fail', err);
    },
});
my.ap.navigatetoalipaypage({
  appcode: 'stockdetail',
  appparams: {
    symbol: 'baba',
    market: 'n',
  },
  success: res => {
    console.log('navigatetoalipaypage success', res);
  },
  fail: err => {
    console.log('navigatetoalipaypage fail', err);
  },
});

q:使用 my.ap.navigatetoalipaypage 打开 h5 页面为何提示“参数错误,打开失败”?

a:
一般都是因为目标链接不在允许范围内(不是以 'https://render.alipay.com/p/' 开头)导致跳转失败(进入 fail 回调),低版本客户端伴有 toast 提示。

q:使用 my.ap.navigatetoalipaypage 跳转生活号文章有一个过渡空白过程,是否正常?

a:
是正常的,属于生活号文章页本身特有的加载流程。

q:使用 my.ap.navigatetoalipaypage 是否可以跳转基金页面?

a:
暂不支持跳转基金页面。
内容没有解决您的问题?您还可以前往 或 寻求帮助
凯发k8官方网娱乐官方 copyright © 支付宝(杭州)信息技术有限公司  | icp证浙b2-20160559
该文档对你是否有帮助?
当前页面目录
网站地图