my.ap.navigatetoalipaypage(object object)
此 api 已停止维护,文档即将下线(线上已有业务不受影响)。
替代方案:
- 已知目标业务的 appcode,请使用 my.ap.openalipayapp 跳转。
- 已知目标页面的 url 或 scheme,请尝试使用 my.ap.openurl 。推荐优先使用 检测和生成代码。
小程序开发者工具: 不支持。
主体: 企业支付宝小程序 、 个人支付宝小程序
相关文档: 小程序外跳和内嵌能力导航 、 my.ap.openalipayapp 、 my.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
查看示例
属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 | ||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
appcode | string | - | 是 | 支付宝: 10.1.62 | 跳转目标业务代码。与 path 二选一。 | ||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||
appparams | object | - | 否 | - | 与 appcode 配套使用的跳转参数。 | ||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||
path | string | - | 是 | - | 跳转目标支付宝页面 url,请传入 encodeuricomponent(url),其中 url 为支付宝页面,必须以 https://render.alipay.com/p/ 开头。与 appcode 二选一。 注:如需打开非支付宝页面,请使用 my.ap.openurl | ||||||||||||||||||||||||||||
success | function | - | 否 | - | 调用成功的回调函数。 | ||||||||||||||||||||||||||||
fail | function | - | 否 | - | 调用失败的回调函数。 | ||||||||||||||||||||||||||||
complete | function | - | 否 | - | 调用结束的回调函数(调用成功、失败都会执行)。 |
fail 回调的参数为 object,error
属性为错误码,errormessage
属性为错误消息。
错误码 | 错误消息 | 凯发app官方网站的解决方案 |
---|---|---|
2 | 跳转失败 | 可通过以下方式检查:
|
参数错误 | 请检查入参是否正确,可以参考入参描述。 | |
参数无效 | 请检查 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:
暂不支持跳转基金页面。