闲管家虚拟货源标准接口
    • 接入说明
    • 虚拟货源-自研接入教程
    • 虚拟货源-下单流程示例
    • 基础接口
      • 查询平台信息（必看）
        POST
      • 查询商户信息
        POST
    • 商品接口
      • 查询商品列表
        POST
      • 查询商品详情
        POST
      • 查询订阅商品列表（自动调价）
        POST
      • 订阅商品变更通知（自动调价）
        POST
      • 取消商品变更通知（自动调价）
        POST
    • 订单接口
      • 创建直充订单
        POST
      • 创建卡密订单
        POST
      • 创建券码订单（囤囤券）
        POST
      • 查询订单详情
        POST
    • 退款接口
      • 订单退款申请（自动撤单）
        POST
      • 订单退款通知（自动撤单）
        POST
    • 回调接口（货源方调闲管家）
      • 商品回调通知
        POST
      • 订单回调通知
        POST
      • 退款回调通知
        POST
      • 券码回调通知
        POST

    虚拟货源-自研接入教程

    📢必要条件：因为需要写接口，必须要有代码开发能力，没有开发能力可以选择使用应用市场-虚拟货源应用#

    常见问题答疑#

    1.
    Q：是否提供闲鱼消息接口？
    A：抱歉，目前消息相关接口暂不开放，后续也没有开放的计划，聊天消息也不支持导出，闲管家客服端目前也不支持接入AI
    2.
    Q：是否提供试用或沙箱环境？
    A：在闲管家首次绑定过的闲鱼店铺有7天试用，没有沙箱环境，也不提供测试账号（包含闲管家账号+闲鱼账号）

    重要 && 必看#

    image.png

    如何使用自己的接口网关地址调试#

    image.png

    接入流程#

    一、订购可使用开放平台的版本#

    ⚠️注意高级版不能创建应用，只有ERP专业版、铂金版才可以
    选择试用/订购
    image.png

    二、创建自研虚拟货源应用#

    image.png
    进入【我的应用】列表，查看刚刚创建的应用，
    image.png

    三、应用详情相关参数说明#

    应用概况：
    AppKey：对接接口时签名使用
    AppSecret：对接接口时签名使用
    货源授权信息说明：
    接口网关：管家请求自研系统的地址，示例：https://yourdomain.com/xgj/open、http://公网IP, 必须是公网可以请求的地址
    AppKey：货源平台提供的商户ID, 对应签名时mch_id参数，请求Query的mch_id参数
    AppSecret：货源平台提供的商户对接秘钥，对应签名时mch_secret参数
    ⭐自研系统只有一个商户, 提供一组值即可，示例：mch_id=2333，mch_secret=md5(2333xxx) 能保证签名不易破解即可
    image.png

    四、接口开发#

    ⚠️接口不用全部开发，需要用到什么功能就开发对应功能的接口；
    比如只有直充，就只对接【一定要实现的接口】+【直充实现接口】部分即可；
    ========= 一定要实现的接口========= ：
    查询平台信息
    查询商户信息
    查询商品列表
    查询商品详情
    ========= 卡密实现接口========= ：
    创建卡密订单
    订单回调通知
    查询订单详情
    ========= 直充实现接口========= ：
    创建直充订单
    订单回调通知
    查询订单详情
    ========= 券码订单实现接口========= ：
    创建券码订单
    订单回调通知
    查询订单详情
    券码回调通知
    券码订单退款申请
    券码订单退款通知
    ========= 商品调价实现接口========= ：
    查询商品订阅列表
    订阅商品变更通知
    取消商品变更通知
    商品回调通知
    （PS：用不到调价可以不开发）

    1、首先看【接入说明】，签名参数来源：#

    注意：签名body里面的参数不用排序，管家传参body是什么，原样参与签名
    body一定要使用压缩后的json，示例：{"keyword":"","goods_type":2,"page_no":1,"page_size":50}
    image.png

    2、基础接口#

    注意这两个接口的返回值为整数，所有请求、返回参数都要严格按照文档的类型开发，否则会对接失败。
    【查询平台信息】返回的app_id 为当前对接的应用概况AppKey
    【查询商户信息】需要返回balance 商户余额，自研系统固定返回大于0的整数就可以。
    image.png
    保存失败时，检查请求地址、签名、返回值是否正确
    image.png

    3、商品接口#

    【查询商品列表】 + 【查询商品详情】
    这两个API 会在直充、卡密获取关联商品调用
    image.png
    image.png
    【订阅商品变更通知】
    需要货源服务商把 goods_no、notify_url的对应关系保存起来，商品价格、库存、状态变更时请求notify_url通知到管家
    【查询商品订阅列表】管家查询使用
    【取消商品变更通知】目前没有用到，可以不对接
    image.png

    4、订单接口#

    【创建直充订单】+【创建卡密订单】 看业务需要，有哪个业务就对接哪个接口
    下单结果是同步返回时，直接返回成功、失败，就不需要使用notify_url
    下单结果是异步时，需要保存notify_url，充值结果通过notify_url通知到闲管家
    【查询订单详情】 用于管家检查订单的充值结果
    image.png
    image.png

    新增券码相关接口#

    相当于卡密接口的进阶版，对比卡密订单，增加了：券码有效期、是否支持过期自动退款、是否支持未使用可退款，实现券码自动核销。
    image.png
    ================================================================
    注意：除了【回调接口】是货源方请求管家，其他接口都是管家请求货源方
    image.png

    闲管家IP段#

    若货源平台无IP白名单限制则不需要添加（20251029更新）:
    112.74.0.0 - 112.74.255.255
    120.24.0.0 - 120.24.255.255
    120.78.0.0 - 120.78.255.255
    120.79.0.0 - 120.79.255.255
    39.108.0.0 - 39.108.255.255
    47.106.0.0 - 47.106.255.255
    120.77.0.0 - 120.77.255.255
    修改于 2026-09-12 09:59:17
    上一页
    接入说明
    下一页
    虚拟货源-下单流程示例
    Built with