Appearance
概述与适用场景
承信租平台支持无缝接入支付宝官方分时租赁机柜行业底座插件(goodsDetailPlugin),使线下自提柜能够直接承接支付宝官方“租享”中心化公域大盘流量与营销展位曝光。
本指南适用于需要将机柜纳入支付宝官方租享矩阵、获取平台公域流量赋能的商户与技术运营团队。
NOTE
若您的业务主要是线下直营网点、合作商户自主扫码运营,强烈推荐优先采用平台自带的线下私域微页面模式,详情参考 《分时租赁柜配置指南》。私域模式无需等待支付宝外部导购计划审批加白,即配即用。
准入全流程概览
核心准入步骤与硬性要求
1. 交易侧场景加白(AppID 白名单)
- 必须联系支付宝行业运营 / BD,为当前小程序 AppID 申请开通
TIME_SLICE_RENTAL(分时租赁场景编码); - 未加白后果:小程序端内无法调起分时免押创单与周期扣款签约接口。
2. 线下自提门店与履约模板匹配
- 门店建档:必须在支付宝商家中心完成自提门店认证,获取平台统一的
shop_id; - 自提模板:在支付宝开放平台商品发布时,必须关联类型为“自提”(
PICKUP)的履约模板; - 门店关联:自提履约模板中必须包含该机柜绑定的
shop_id,且门店营业状态必须为正常营业(status: "01"),否则插件无法匹配该网点。
3. 商品库发布与支付宝平台 ID 获取
- 将本地分时商品通过 API 同步至支付宝行业商品库;
- 审核通过后,支付宝会回传官方平台商品 ID(
itemId,如2026102822000355189336)与规格 ID(skuId); - 系统在后台保存机柜 SKU 时会自动建立映射与校验。
★ 后羿营销展位圈选加白(核心避坑点)
在对接公域机柜插件过程中,最常见的问题是扫码后真机提示 “本机柜暂无可租用设备”。排查经验表明,90% 以上的原因是未完成展位圈选加白:
CAUTION
导购计划圈选必做操作
- 商品成功发布至支付宝商品库后生成的
itemId,必须提交给支付宝行业运营; - 由运营在支付宝后羿营销平台的机柜导购计划中将该
itemId圈选入池:- 后羿导购计划编号:
GP202605190000066453 - 营销展位编码:
HOUYI_RENT_NO_COMMISSION_VIRTUAL_PROD
- 后羿导购计划编号:
- 重要警告:即使商户后端接口返回了完整的商品和门店数据,若后羿营销展位未圈选该商品 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 反序列化异常或报文长度截断,引发白屏崩溃。
公域二维码与物料投放
- 进入总后台【商品管理 -> 分时租赁柜】,点击对应机柜的 【机柜码】;
- 选择 【公域码】,下载生成的二维码图片;
- 文件物理路径:系统自动保存为
/uploads/timerent/qrcode/cabinet_{id}_public.png; - 打印物料张贴于机柜表面,承租人使用支付宝扫码即可唤起支付宝官方机柜插件借还。