常见问题#

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里直接调用外部接口，配置可信目标请求域就行

17. 订单支付失败常见原因#

前端对long类型的订单号处理会出现精度会丢失，导致传入的订单号和实际的订单号不一致，出现支付失败的情况。