开发者社区
社区提问意见反馈
开发者钉组织
扫描二维码
加入支付宝开发者钉组织
支付产品
私域产品
小程序产品
权限集列表
搜索关键词
搜索直达
收藏
消息
小程序码
小程序服务
订单中心
小程序开发管理
生物核身
交易组件
小程序商品
接入指南
普通商品接入指南
本地生活商品接入指南
api 列表
相关资料
支付有礼
商家粉丝群
营销产品
资金产品
会员产品
信用产品
广告产品
开发 > 服务端 > 私域产品 > 小程序产品 > 权限集列表 > 小程序商品 > 接入指南 >  > 租赁类(实物)商品接入指南
已更新
文档更新记录 >
收藏
订阅更新
我的文档
设置
接入检测
即可查看检测结果)
若有未通过的接入检测项,接口将无法调通
租赁类(实物)商品目前可以用于芝麻租物、直播间、消息盒子、商家群中商品分发,商家可以将商品提报至支付宝商品库,便于在支付宝各类公域场景获取更多流量。
目前商品有 2 种提报方式:
批量对接(建议):商家可直接调用 alipay.open.app.item.create(小程序商品创建接口)。对接完成后,商家通过自有小程序管理后台同步商品到支付宝侧。 注意:同步后请不要再通过 支付宝商家平台 对商品进行修改。
手工录入(不建议):可采用手工录入的方式,将少量商品的信息从自有小程序管理后台提报至 支付宝商家平台 > 运营中心 > 商品管理注意:请务必确保两个平台的信息一致性。
接入步骤

获取可提报的类目信息
商家可通过 alipay.open.app.item.allcategory.query(获取普通商品类目接口)查询可以使用的商品类目信息,后续创建以及修改商品的时候都需要使用类目信息。

注意
类目信息决定了商品入库时需要填写的字段信息,以及后续商品交易相关数据,请正确填写。
提报前可获取该商家可提报的全部商品类目信息,可通过 cat_status 作为筛选项,查到已开通的商品类目。
获取普通商品模板信息(可选)
建议接入。商家可通过 获取不同类目下需要添加的个性化属性信息,接口里面的类目 id 编码是从 alipay.open.app.item.allcategory.query(获取普通商品类目接口)中获取到的。
注意
随着平台发展,部分类目要求填入的属性逐步更新(如黄金商品要求传入克重信息等),请商家及时调用并获取平台要求填入的属性信息。
图片优化上传
商家可以调用 alipay.marketing.image.enhance.upload(营销图片优化上传接口)用于优化上传具体的介质图片,比如商品主图、子图等;调用时指定上传场景,比如商品主图场景,即可对原图按照商品主图规范进行校验和优化。如商品主子图等。

创建商品
商家可通过 alipay.open.app.item.create(小程序商品创建接口) 向支付宝提报小程序内的商品详情页。创建成功后支付宝会返回支付宝平台侧商品id作为该商品的支付宝全局唯一商品编码供后续使用。 租赁商品的 item_type 为 租赁类(实物): 2。
重要请求参数
参数英文名
参数中文名
示例值
参数说明
out_item_id
商家侧商品id
"test20230021"
商家侧商品id,要求 appid 下全局唯一。
title
商品名称
"实物租赁商品创建示例"
【描述】商品名称,字符类型,最少不低于 3,最长不超过 60 个字。
【注意事项】
1.商品标题只允许汉字、数字、英文字母、特殊字符集;
2.商品标题不得仅为数字、字母、特殊字符集或上述三种的组合。
head_img
商品主图
"a*phfasaesf_0aaaaaaaaaaaaaatcnaq"
商品主图,图片宽高为750px*750px,宽高比1:1,800kb以内。支持jpg、jpeg、png格式的图片。
可以通过 alipay.marketing.image.enhance.upload(营销图片优化上传接口) 自动优化,并且获取图片文件id。
category_id
平台类目
"c001375054"
平台类目,填写的类目必须在类目表列出,多级类目只填最后一级。商品类目 id 及信息可通过 alipay.open.app.item.allcategory.query(获取普通商品类目接口)获取,仅叶子类目支持创建商品。
item_type
商品类型
-
租赁类(实物): 2
path
商品详情页url
-
商品详情页url,请填写您的小程序侧商品详情页链接。
image_list
商品子图
-
商品子图,作为平台详情页组件的轮播图,图片宽高为750px*750px,宽高比1:1,800kb以内,不超过 3 个图片。支持jpg、jpeg、png格式的图片。
可以通过 alipay.marketing.image.enhance.upload(营销图片优化上传接口) 获取图片文件id。
skus
sku数组
-
-
l out_sku_id
l 商家侧sku id
-
-
l sale_status
l 售卖状态
-
-
l sku_attrs
l 商品销售属性
-
-
ll attr_key
ll 销售属性key
-
销售属性key 见下文 sku_attrs 销售属性
ll attr_type
ll 销售属性类型
custom
选填。枚举值:
spec:规格
custom:自定义属性
如果需要填写,attr_key 为 rent_commodity 时该字段填 custom;不填默认为 spec。
ll attr_value
ll 销售属性值
-
-
l sku_type
l sku类型
rent
特殊可选(租售模式必填)。
枚举值:
rent:租赁sku
sale: 售卖sku
l sale_price
l sku售价
-
如果有起租天数总租金,该字段不用填写。
l original_price
l sku原价
-
如果有起租天数总租金,该字段不用填写。
l stock_num
l sku库存
-
-
l price_unit
l 价格单元
"元/日"
租赁sku:元/日
售卖sku:元
l sale_status
l 销售状态
"available"
-
attrs
商品属性
-
-
ll attr_key
ll 商品属性key
商品属性key 见下文 attrs 商品属性
sku_attrs 销售属性
属性名
属性key(attr_key)
是否必填
示例值
说明
租赁套餐
rent_commodity

{
"attrkey": "rent_commodity",
"attrtype": "custom",
"attrvalue": "{
"name":"租完归还",
"durationunit":"天",
"buyoutprice":"220",
"priceunit":"元",
"durationpricelist":[
{
// 7天起租
"duration":"7",
"totaloriginalprice":"100",
"totalsaleprice":"80",
},
{
// 180天起租
"duration":"180",
"totaloriginalprice":"600",
"totalsaleprice":"599",
},
{
// 365天起租
"duration":"365",
"totaloriginalprice":"800",
"totalsaleprice":"799",
}
]
}
}
套餐名称(name):不得出现金融相关词汇,如分期、免洗、0元/1元买断、租完即送、征信等金融属性词汇。 注意:套餐名称不能重复。
请填写租期天数(durationpricelist 中 duration),每个套餐的租期天数允许不同。可选择:1、3、7、15、30、90、180、365、455、545 天,支持添加自定义天数。
priceunit 代表价格单位,请填写元。
durationunit 代表租期单位,请填写日。
总租金售价(totalsaleprice):请填写各规格下不同租期对应的租金信息,系统将自动计算出日租金;在支付宝侧对商品进行展示时,将展示可售规格中的最低日租金。
总租金原价(totaloriginalprice):可选项,若您对某一租期进行了优惠活动,则允许设置租金原价。
买断价(buyoutprice):请填写各个规格下到期买断价,买断价格为:用户所支付的到期尾款 总租金(如下图);若不支持买断,则可将开关关闭。

注意totalsaleprice、totaloriginalprice、buyoutprice 必须是整数字符串。
自定义
自定义规格

{
"attrkey": "尺码",
"attrvalue": "l"
}
sku 规格。
attrkey 代表规格名称,如内存。
attrvalue 代表销售属性值,如 216g。
attrs 商品属性
属性名
属性key(attr_key)
是否必填
示例值
说明
起租天数
rent_from_numbers_of_day
租赁类(实物)商品特殊可选。
"3"
起租天数特殊可选,如果在套餐中填写租期天数,则该字段无需填写,以套餐中最小天数作为起租天数记录。
商品成色
item_fineness
租赁类(实物)商品必填。
"wholenew"
"secondhand"
全新是指官方全新未拆封的;资源机、99 新等属于二手。
成色等级
item_fineness_grade
租赁类(实物)商品选填,商品成色为“secondhand”时可填。
"99new"
"95new"
"90new"
"80new"
"70new"
99new :99新
95new :95新
90new :9成新
80new :8成新
70new :7成新
是否支持免押
whether_support_free_deposit
租赁类(实物)商品选填。
"1"
请选择是否支持芝麻免押。1 代表支持,0 代表不支持。
可续租
whether_continue_rent
租赁类(实物)商品选填。
"1"
请选择是否可续租。1 代表支持,0 代表不支持。
可买断
whether_buyout
租赁类(实物)商品选填。
"1"
请选择是否可买断。1 代表支持,0 代表不支持。如果套餐中填写规格的买断价,则默认套餐中的规格可买断。
租期计算规则
rent_duration_cal_rule
租赁类(实物)商品选填。
"1"
请选择租期计算规则
签收当日:1
签收次日:2
最低首期实付租金
minimum_initial_rent_payment
租赁类(实物)商品选填。
"100"
用户首期最低实际支付的租金,单位为元。
商品最低售价对应的租期天数
minimum_rent_price_numbers_of_day
租赁类(实物)商品选填。
"365"
若sku中已经传入套餐及租期信息,则无需传入该参数。
数值类型,单位为天。请填写最低租金售价对应的天数,假设商品租金最低为 3 元/天,对应的租期为 1 年,则填写 365。
规格
spec
租赁类(实物)商品选填。
sku 规格,如果需要规格配图,需在该属性中传入图片,规格配图仅支持单个属性。
属性值内容填写格式示例如下,转成 jsonstring 后填入 attrvalue。
示例:
[
   {
      "name": "尺寸",
      "has_image": "0",
      "values": [
        {
      "val": "l"
         }
     ]
   },
   {
      "name": "颜色",
      "has_image": "1",
      "values": [
       {
      "val": "红色",
      "image": "a*ay7przhufh0aaaaaaaaaaaaadun1aq"
       },
       {
      "val": "蓝色",
      "image": "a*ay7przhufh0aaaaaaaaaaaaadun1aq"
        }
    ]
  }
]
如果需要针对规格配图,需在该属性中传入图片,规格配图仅支持某个属性传入。如图示意:
属性值内容填写格式,转成 jsonstring 后填入 attrvalue。
增值服务
value_added_services
租赁类(实物)商品选填。
[{
"service_name": "增值服务名称",
"service_introduction": "说明",
"service_price": "100"
}]
请使用字符串格式。
增值服务最多 5 组;
增值服务名称 [1,60] 字符;
服务描述 [1,1000] 个字符;
增值服务金额 [0,99999900] 分。
商品详情描述
description_text
租赁类(实物)商品选填。
"商品详情描述"
请使用字符串格式。
最大长度:2000。
售卖模式
sales_model
租赁类(实物)商品选填。
[\"rent\",\"sales\"]
请使用字符串格式。
租赁:[\"rent\"]
租售:[\"rent\",\"sales\"]
现货发货时效
shipping_time_limit
租赁类(实物)商品选填。
"0"
请使用字符串格式。
现货,用户付款后大于 72 小时发货:"0"
现货,用户付款后 72 小时内发货:"1"
现货,用户付款后 48 小时内发货:"2"
现货,用户付款后次日发:"3"
预售,付款后 7 天内发货:"4"
预售,付款后 15 天内发货:"5"
预售,付款后 30 天内发货:“6”
服务承诺
service_commitment
租赁类(实物)商品选填。
["1","7"]
请使用字符串格式。
极速退款:“1”
寄出包邮:“2”
租期质保:“3”
随租随还:“4”
免赔保障:“5”
隐私保护:“6”
包邮:“7”
极速审核 “8”
专业鉴定 “9”
免赔服务 “10”
顺丰包邮 “11”
注意
类目:可使用 alipay.open.app.item.category.consult(商品类目预测咨询接口) 进行类目推荐,获取平台推荐的类目信息。
同步数量:您可以将在自有小程序后台中完成上架的商品,全部自动“同步”至支付宝侧;也可选择批量将部分商品“同步”至支付宝侧,支付宝商品库不对单个商家同步数量做任何限制。
信息修改:若选择通过接口进行同步商品,请不要再使用手工在支付宝商家平台进行信息修改,否则将造成数据不一致等问题。
审核相关:同步至支付宝的商品将完成信息审核,请遵循商品发布规范,否则将无法通过审核。审核过程中,信息将无法更改。
目前针对租赁类(实物)商品,租赁套餐限制填写 5 个,规格限制 300 个。
更新商品
商家可使用 alipay.open.app.item.modify(小程序商品更新接口),通过上传商家侧商品id,或是返回的支付宝平台侧商品id查询已经创建的商品信息。
注意
请保持商品价格、上下架状态、库存状态(有货/缺货)可以免审更新,并实时同步至支付宝,保持双边数据一致。(注意:请务必自动调用,不要让运营人员手工同步。)
不可修改内容规则:大促活动限制商品不可修改售价、规格。商家需要通过 alipay.open.app.item.query(小程序商品详情查询接口) 获取参与大促活动的商品及限制修改的信息,获取商品信息后需在 服务商平台/小程序自有平台做好限制。
接收支付宝消息
商家/服务商可以监听 alipay.open.app.item.status.notify(商品状态变更消息同步接口),感知商品状态信息的变更。商品审核通过或驳回,以及后续商品售罄或冻结(违规/质量异常)均会通过本消息进行通知。
注意
商品审核通过、审核驳回、商品被冻结等引起的状态变更,商家/服务商可以监听本接口感知商品状态信息的变更。
针对被冻结的商品,商家可以通过访问至 申请复核。 操作说明:在管理页面中选择 已冻结 申请复核。
消息示例
删除商品
商家可使用 alipay.open.app.item.delete(小程序商品移除接口),通过上传商家侧商品id列表,或是返回的支付宝平台侧商品id删除不需要的商品信息。
注意
当小程序侧商品已删除,请调用支付宝删除接口,将商品删除。
商品删除会将生效中的版本删除并从场景侧下线,并且删除是不可逆的,谨慎操作。
内容没有解决您的问题?您还可以前往 或 寻求帮助
凯发k8官方网娱乐官方 copyright © 2022 支付宝(杭州)信息技术有限公司  | icp证浙b2-20160559
该文档对你是否有帮助?
当前页面目录
网站地图