常见问题

v3更新须知

目录
后台相关修改
新旧路由对比

后台相关修改

后台写死访问前台商城首页链接修改

  • 旧的商城首页链接==> 1,域名+/wap/ 2,域名+/wap/mall/ 3,域名+'/wap/mall/index' 统一修改为:域名+/wap/pages/mall/index
  • 访问独立域名不带/wap/ 情况,也是重定向到 域名+/wap/pages/mall/index,或直接 域名+/wap/ (后面需带/)

微信公众号配置相关修改

  • 支付目录修改或添加 (建议添加,不删除旧的目录) => /wap/packages/pay/
  • 支付回调地址修改:h5微信支付,支付宝支付(其他跳转脱离商城的支付回调都需要修改) => 域名/wap/packages/pay/result?out_trade_no=外部交易号

微信公众号模板消息相关修改

  • 查看订单信息的链接修改 :
  • 查看全部订单: 域名/wap/pages/order/list
  • 查看状态的订单: 域名/wap/pages/order/list?status=状态值
  • 查看订单详情: 域名/wap/packages/order/detail?order_id=订单id
  • 如有其他模板消息前台链接都要修改(暂时只知道订单)

小程序新版本标识

  • newconfig为新版的配置接口,请求参数传入version:3 ,表示新版本小程序已提交发布,后台所有涉及生成太阳码地方的小程序路径都必须是新版本的路径

后台相关修改

商城=>装修

小程序和app全部一同修改,统一链接;app装修不再使用现有的装修内容,将采用移动端一致的装修内容,保持全端一致;

公众号=>自定义菜单

  • 跳转网页和跳转小程序链接也一同修改为新路由

1、商品=>列表

  • 生成链接与二维码 商品详情链接 统一修改为:
  • h5=> '域名'+'/wap/packages/goods/detail?goods_id='+商品id
  • 小程序太阳码:
  • path:packages/goods/detail
  • scene:goods_id=商品id

2、应用=>积分商城=>商品列表

  • 生成链接与二维码 积分商城商品详情 统一修改为:
  • h5=> '域名'+'/wap/packages/integral/goods/detail?goods_id='+商品id
  • 小程序太阳码:
  • path:packages/integral/goods/detail
  • scene:goods_id=商品id

3、应用=>刮刮乐=>列表

  • 生成链接与二维码 刮刮乐详情 统一修改为:
  • h5=> '域名'+'/wap/packages/scratchcard/index?scratch_card_id='+刮刮乐id
  • 小程序太阳码:
  • path:packages/scratchcard/index
  • scene:scratch_card_id=刮刮乐id

4、应用=>拼团=>列表

  • 生成链接与二维码 商品详情链接 统一修改为:
  • h5=> '域名'+'/wap/packages/goods/detail?goods_id='+商品id
  • 小程序太阳码:
  • path:packages/goods/detail
  • scene:goods_id=商品id

5、应用=>砸金蛋=>列表

  • 生成链接与二维码 砸金蛋详情 统一修改为:
  • h5=> '域名'+'/wap/packages/smashegg/index?smash_egg_id=砸金蛋id
  • 小程序太阳码:
  • path:packages/smashegg/index
  • scene:smash_egg_id=砸金蛋id

6、应用=>大转盘=>列表

  • 生成链接与二维码 大转盘详情 统一修改为:
  • h5=> '域名'+'/wap/packages/wheelsurf/index?wheelsurf_id=大转盘id
  • 小程序太阳码:
  • path:packages/wheelsurf/index
  • scene:wheelsurf_id=大转盘id

7、应用=>券包=>列表

  • 生成链接与二维码 券包详情 统一修改为:
  • h5=> '域名'+'/wap/packages/voucherpackage/index?voucher_package_id=券包id
  • 小程序太阳码:
  • path:packages/voucherpackage/index
  • scene:voucher_package_id=券包id

8、应用=>礼品券=>列表

  • 生成链接与二维码 礼品券详情 统一修改为:
  • h5=> '域名'+'/wap/packages/giftvoucher/receive?gift_voucher_id=礼品券id
  • 小程序太阳码:
  • path:packages/giftvoucher/receive
  • scene:gift_voucher_id=礼品券id

9、应用=>预售=>列表

  • 生成链接与二维码 商品详情链接 统一修改为:
  • h5=> '域名'+'/wap/packages/goods/detail?goods_id='+商品id
  • 小程序太阳码:
  • path:packages/goods/detail
  • scene:goods_id=商品id

10、应用=>优惠券=>列表

  • 生成链接与二维码 优惠券 统一修改为:
  • h5=> '域名'+'/wap/packages/coupon/receive?coupon_type_id=优惠券id
  • 小程序太阳码:
  • path:packages/coupon/receive
  • scene:coupon_type_id=优惠券id

11、应用=>砍价=>列表

  • 生成链接与二维码 商品详情链接 统一修改为:
  • h5=> '域名'+'/wap/packages/goods/detail?goods_id='+商品id
  • 小程序太阳码:
  • path:packages/goods/detail
  • scene:goods_id=商品id

12、应用=>超级海报=>列表

  • 生成链接与二维码
  • 示例:/wap/pages/mall/index 表示path路径(由前端传给接口,获取超级海报接口的path参数),最终超级海报二维码链接为如下情况(app生成的跟h5的二维码一样)
  • h5-商城海报=> '域名'+'/wap/pages/mall/index?extend_code='+推广码&poster_id=海报id&poster_type=海报类型
  • h5-商品海报=> '域名'+'/wap/packages/goods/detail?goods_id='+商品id&poster_id=海报id&poster_type=海报类型
  • h5-关注海报=> '域名'+'/wap/pages/mall/index?extend_code='+推广码&poster_id=海报id&poster_type=海报类型
  • h5-微店海报=> '域名'+'/wap/packages/microshop/home?shopkeeper_id=店主id&extend_code='+推广码&poster_id=海报id&poster_type=海报类型
  • 小程序太阳码示例:pages/mall/index 表示path路径(由前端传给接口,获取超级海报接口的path参数),最终超级海报太阳码的场景值是由后台生成的场景值scene,前端需要拿到场景值scene解析并得到最终的参数(如何解析场景值scene?
  • 小程序太阳码-商城海报:
  • page:pages/mall/index
  • scene:extend_code=推广码&poster_id=海报id&poster_type=海报类型
  • 小程序太阳码-商品海报:
  • page:packages/goods/detail
  • scene:goods_id='+商品id&extend_code=推广码&poster_id=海报id&poster_type=海报类型
  • 小程序太阳码-关注海报:
  • page:pages/mall/index
  • scene:extend_code=推广码&poster_id=海报id&poster_type=海报类型
  • 小程序太阳码-微店海报:
  • page:packages/microshop/home
  • scene:shopkeeper_id=店主id&extend_code=推广码&poster_id=海报id&poster_type=海报类型

13、应用=>授权证书=>列表

  • 生成链接与二维码
  • h5-微店证书=>
  • h5-代理证书=>
  • h5-全球股东证书=>
  • h5-区域代理证书=>
  • h5-团队队长证书=>
  • h5-渠道商证书=>
  • h5-分销商证书=>
  • 小程序太阳码=>

14、应用=>小程序直播

  • 生成链接与二维码:
  • path:
  • scene:live_id=直播id&anchor_id=主播id

新旧路由对比


页面名称 旧路由 新路由
首页(默认tabbar) h5:/mall/index
mp:/pages/index/index
/pages/mall/index

FAQ

v3版本更新常见问题,以及解决方案


1、h5端微信支付时,提示 xxxx/wap/packages/pay/ 未注册页面?

  • 由于新版本修改过页面路由,提示未注册页面需前往商户平台添加支付目录,https://xxx.com/wap/packages/pay
  • (xxx.com)表示域名

2、小程序端访问商城跳转页面提示找不到你要访问的页面?

  • 由于新版本修改过页面路由,跳转的页面均由后台装修时添加的路由,存在旧的页面链接,部分页面链接未完全兼容旧页面链接,如跳转时出现找不到页面,可以在后台装修重新选择页面

3、原先转发给好友的小程序卡片,新版本更新后好友点击卡片重新进入将不能访问

  • 由于新版本修改过页面路由,转发给好友的小程序卡片,新版本小程序重新点击可能会提示小程序找不到页面,将不能访问,如左上角有返回首页按钮,点击可进入首页
  • 如已经分享过的海报图片带小程序码,新版本已做兼容处理

4、后台显示小程序太阳码地方,发现不能正常显示?

  • 请先确保是是否发布过新版本小程序还是旧版小程序,如果是发布过新版小程序并审核通过,一般不会存在不显示太阳码;如不显示,咨询客服