常见问题

1. 初次接入小程序,需要申请哪些权限?

权限分为客户端接口权限和服务端接口权限,需要在管理平台上申请权限后才能使用。具体可以参考【小程序快速接入】申请API权限

2. 小程序对浏览器API支持是否完整;在SPA应用下,是否支持History模式?

都支持的。闲鱼小程序可以理解为一个能力增强,但是被平台管控受限的H5。

3. 入驻闲鱼小程序,必须要部署“聚石塔服务”吗?

是的。闲鱼小程序调用的后端接口,都必须部署到聚石塔上。

4. 聚石塔如何接入?

参考文档:https://open.taobao.com/docV3.htm?docId=982&docType=1&source=search#s2

5. 部署到聚石塔的接口可以调用外部接口吗?

可以。聚石塔内外互通是通过奇门接口实现的。具体可以参考:聚石塔内外互通说明

6. 小程序内使用的闲鱼账号和淘宝开发者账号,可以用个人账号吗?如果是用个人账号,后期还能再变更为公司账户吗?

为保障整体业务流畅,请使用与闲鱼签约的企业账号申请闲鱼账号和淘宝开发者账号;如果使用个人账号,后期不支持变更,所以推荐使用企业账号。理论上淘宝开放平台入驻主体 、闲鱼入驻主体、合同签约主体,三者应该一致。

7. 隐藏标题栏后,iOS上状态栏显示错乱

解决办法可以参考:https://blog.csdn.net/weixin_62192841/article/details/130687086

8. 闲鱼小程序内如何打开页面?

  • 小程序内打开页面,直接使用window.location.href;如果想打开三方的H5页面,需要去管理平台配置isv容器地址域名,走审批流程。
  • 这里需要注意!!! openWindow API是用于打开闲鱼App的页面,并不是提供给小程序去打开自己的页面。

9. 闲鱼小程序如何打开三方的H5页面,以及打开其他App页面

  • 小程序内打开三方H5页面,需要联系我们说明原因,获准后去管理平台配置,走审批流程。通过后使用window.location.href打开。
  • 打开其他App页面,暂时不支持,有特殊需求请与我们联系。

10. 订单的交易链路

订单交易链路

11. 什么时候需要使用闲鱼订单链路

当小程序中有 拉起支付 的功能,就需要接入闲鱼的订单链路

12. 商品如何发布、订单里的商品是个什么概念

  • 服务商注册一个卖家账号在闲鱼app内发一个通用的闲鱼商品用来走订单【将商品分享在浏览器内打开可在地址中获取到商品ID、或分享到群里告知闲鱼技术同学】
  • 小程序内的那些商品只在服务商自己系统
  • 统一使用一个商品ID进行拉起创单

13. 订单里的金额流转

注册一个卖家账号,用户付款后,会到闲鱼担保账户,发货后自动确认收货时,就会打到卖家支付宝账户

14. 订单支付后如何感知支付结果

  • 调用前端支付API Goosefish.tradePay 时,会返回支持是否成功的结果。
  • 服务端可以再次调用订单查询接口(alibaba.idle.isv.order.query)验证订单是否已支付,如果返回结果的 order_status 更新成2,代表订单已付款完成。
  • 订单支付成功后,会发送订单状态变更消息。注意:消息可能会有延迟。

15. 授权拒绝后怎么感知用户信息

用户拒绝授权后,目前只有一个设备ID标识, 在API列表里 获取系统和闲鱼App相关信息接口可以查阅到详细信息

16. 能否在H5里直接调用小程序业务接口

可以在h5里直接调用外部接口,配置可信目标请求域就行