已更新更新时间：2024-10-23 18:08:47文档更新记录 >配置项检测工具收藏订阅更新我的文档设置接入检测（即可查看检测结果）若有未通过的接入检测项，接口将无法调通去登录返回文档完成 接入准备 后，商家和服务商可根据本文指引快速集成 租房商品。说明：●租房商品 仅支持自研商家/服务商通过 自研应用 或 第三方应用 代调用（传入 app_auth_token）方式，调用 api 接入。 ●租房商品 支持沙箱调试。查询商品类目信息商家可通过 alipay.open.app.localitem.allcategory.query（获取本地商品类目接口）获取支付宝小程序当前支持的所有本地商品类目信息，商家可以根据自己小程序的资质情况选择合适的类目进行商品提报。注意●需要提前开通租房商品相关的类目。●商品类型（item_type）：13 - 固定值，代表租房商品。查询商品模板信息商家可通过 alipay.open.app.localitem.template.query（获取本地商品模板信息接口）获取不同类目下需要添加的个性化属性信息，接口里面的类目 id 编码是从类目列表查询接口中获取到的。注意●不同的类目对应的个性化属性及其校验规则是不一样，需要动态实时查询。●商品类型（item_type）：13 - 固定值，代表租房商品。创建租房商品商家可通过 向支付宝提报小程序内的商品详情页 url。创建成功后支付宝会返回支付宝平台侧商品 id 作为该商品的支付宝全局唯一商品编码供后续使用。注意●需保证商品的商家侧商品编码在该小程序下的唯一性。● 里面的属性列表（attr）字段需要和 alipay.open.app.localitem.template.query（获取本地商品模板信息接口）查询的类目模板中属性列表（attr）字段对齐，所有的必填属性都需要存在，非必填属性可以不用填写。更新租房商品信息商家可通过 修改支付宝侧的商品数据。注意●商品首先需要同步到支付宝侧后才能支持修改，如果商品已经有一个版本是在审核中，商品不支持修改。免审更新租房商品信息正常情况下修改商品详情页的基础字段等信息都需要进行审核。为了方便商家及时的修改状态信息，商家可通过 使用平台侧商品编码上下架商品。注意●商品首先需要同步到支付宝侧后才能支持上下架，审核中的商品不支持操作。查询租房商品详情商家可通过 查询已同步到支付宝侧的商品数据。注意●商品查询需要传入创建时返回的支付宝侧商品 id，或者商家侧商品 id，两者不可同时为空。分页查询租房商品详情商家可通过 查询已同步到支付宝侧的商品数据。注意●商品查询需要传入创建时返回的平台侧商品 id 列表，或者商家侧 id 列表，两者不可同时为空，不可以混传。●该接口只能查询生效的商品，不能根据不同的 id 返回不同版本的数据。移除租房商品商家可通过 ，上传商家侧商品 id 列表移除商品。注意●商品首先需要同步到支付宝侧后才能支持删除。●商品删除会同时将生效中的版本和审核中的版本全部删除并从场景侧下线，并且删除是不可逆的，请谨慎操作。商品状态变更消息通知商家/服务商可以监听 alipay.open.app.item.status.notify（商品状态变更消息同步接口），感知商品状态信息的变更。商品审核通过或驳回，以及后续商品售罄或冻结（违规/质量异常）均会通过本消息进行通知。注意1商品状态变更通知会在商品状态变更时发出，包括审核、售罄、冻结等操作生效之后发出。2变更推广计划通知仅包含简单的推广计划变更通知信息，更多商品信息需通过 获取。消息示例：
