Skip to content

概述与适用场景 ​

承信租平台支持无缝接入支付宝官方分时租赁机柜行业底座插件(goodsDetailPlugin),使线下自提柜能够直接承接支付宝官方“租享”中心化公域大盘流量与营销展位曝光。

本指南适用于需要将机柜纳入支付宝官方租享矩阵、获取平台公域流量赋能的商户与技术运营团队。

NOTE

若您的业务主要是线下直营网点、合作商户自主扫码运营,强烈推荐优先采用平台自带的线下私域微页面模式,详情参考 《分时租赁柜配置指南》。私域模式无需等待支付宝外部导购计划审批加白,即配即用。


准入全流程概览 ​


核心准入步骤与硬性要求 ​

1. 交易侧场景加白(AppID 白名单) ​

  • 必须联系支付宝行业运营 / BD,为当前小程序 AppID 申请开通 TIME_SLICE_RENTAL(分时租赁场景编码);
  • 未加白后果:小程序端内无法调起分时免押创单与周期扣款签约接口。

2. 线下自提门店与履约模板匹配 ​

  • 门店建档:必须在支付宝商家中心完成自提门店认证,获取平台统一的 shop_id;
  • 自提模板:在支付宝开放平台商品发布时,必须关联类型为“自提”(PICKUP)的履约模板;
  • 门店关联:自提履约模板中必须包含该机柜绑定的 shop_id,且门店营业状态必须为正常营业(status: "01"),否则插件无法匹配该网点。

3. 商品库发布与支付宝平台 ID 获取 ​

  1. 将本地分时商品通过 API 同步至支付宝行业商品库;
  2. 审核通过后,支付宝会回传官方平台商品 ID(itemId,如 2026102822000355189336)与规格 ID(skuId);
  3. 系统在后台保存机柜 SKU 时会自动建立映射与校验。

★ 后羿营销展位圈选加白(核心避坑点) ​

在对接公域机柜插件过程中,最常见的问题是扫码后真机提示 “本机柜暂无可租用设备”。排查经验表明,90% 以上的原因是未完成展位圈选加白:

CAUTION

导购计划圈选必做操作 ​

  1. 商品成功发布至支付宝商品库后生成的 itemId,必须提交给支付宝行业运营;
  2. 由运营在支付宝后羿营销平台的机柜导购计划中将该 itemId 圈选入池:
    • 后羿导购计划编号:GP202605190000066453
    • 营销展位编码:HOUYI_RENT_NO_COMMISSION_VIRTUAL_PROD
  3. 重要警告:即使商户后端接口返回了完整的商品和门店数据,若后羿营销展位未圈选该商品 ID,支付宝端内 RPC 接口会自动在底层过滤剔除,直接导致前端插件无任何商品展示。

商户初始化回调数据规范 ​

官方插件在端内初始化时会调用商户注册的 setRentCabinetDetailInitCallback 回调:

javascript
// 回调响应轻量化结构示例
{
  "success": true,
  "cabinetName": "西湖银泰相机柜01",
  "cabinetNo": "CAB-2026-001",
  "shopId": "202605200007700000001",
  "hourItemFreeTime": "10",
  "itemSkuList": [
    {
      "appId": "202100xxxx",
      "outItemId": "10023",
      "outSkuId": "20045",
      "itemId": "2026102822000355189336",
      "skuId": "2026102822000355189337",
      "hourItemFreeTime": "10"
    }
  ]
}

IMPORTANT

报文轻量化规范 ​

  • itemSkuList 必须为极简扁平结构,严禁塞入设备 SN、槽位号或多层自循环嵌套对象;
  • 嵌套对象或过大报文会导致支付宝端内 RPC 反序列化异常或报文长度截断,引发白屏崩溃。

公域二维码与物料投放 ​

  1. 进入总后台【商品管理 -> 分时租赁柜】,点击对应机柜的 【机柜码】;
  2. 选择 【公域码】,下载生成的二维码图片;
  3. 文件物理路径:系统自动保存为 /uploads/timerent/qrcode/cabinet_{id}_public.png;
  4. 打印物料张贴于机柜表面,承租人使用支付宝扫码即可唤起支付宝官方机柜插件借还。

安徽用易软件科技有限公司 · 承信租 V4 官方技术文档中心