开发者社区
社区提问意见反馈
开发者钉组织
扫描二维码
加入支付宝开发者钉组织
支付产品
私域产品
小程序产品
权限集列表
搜索关键词
搜索直达
收藏
消息
小程序码
小程序服务
订单中心
小程序开发管理
生物核身
交易组件
小程序商品
接入指南
api 列表
相关资料
支付有礼
商家粉丝群
营销产品
资金产品
会员产品
信用产品
广告产品
开发 > 服务端 > 私域产品 > 小程序产品 > 权限集列表 > 小程序商品 >  > 普通商品属性介绍
已更新
文档更新记录 >
收藏
订阅更新
我的文档
设置
以下普通商品所有属性均可传入
属性名
是否必选
属性key(attr_key)
示例值(attr_value)
说明
商品履约信息
可选
delivery_info
[
{
"delivery_id": "20230530021000800000001",
"shop_ids": [
"1",
"2"
]
},
{
"delivery_id": "20230530021000800000002",
"shop_ids": [
"3",
"4",
"5"
]
}
]
delivery_id:履约信息 id
shop_ids:门店 id 列表
履约信息和门店的关联关系:
一个商品在一个门店可以有多种不同类型的履约方式;一个商品在同一个履约类型下,不能关联相同的门店。
导购标签
可选
selling_point_tag
["标签一","标签二"]
导购标签
商品白底图
可选
white_ground_image
{
"url_list":[
"url1",
"url2"
]
}
商品白底图的文件 id 列表。宽度及宽高比为 1:1 ,750px*750px,支持 jpg、jpeg、png 格式的图片。 文件 id 通过 alipay.marketing.image.enhance.upload(营销图片优化上传接口) 获取 image_id。
现货发货时效
可选
shipping_time_limit
"0"
请使用字符串格式。
现货,用户付款后大于 72 小时发货:"0"
现货,用户付款后 72 小时内发货:"1"
现货,用户付款后 48 小时内发货:"2"
现货,用户付款后次日发:"3"
预售,付款后 7 天内发货:"4"
预售,付款后 15 天内发货:"5"
预售,付款后 30 天内发货:“6”
商品视频素材
可选
cover_video
{\"coverimageid\":\"a*rj8itxxxxxxxxxaadig8aq\",\"covervideoid\":\"a*vujwqp-n5xxxxxxxxavtp1aq\"}
coverimageid:视频封面图,支持750px*750px,png/jpg/jpeg,大小≤ 800kb,文件 id 通过alipay.marketing.image.enhance.upload(营销图片优化上传接口)获取 image_id。 covervideoid:视频,仅支持mp4格式上传,大小100m内,比例支持3:4比例视频,视频长度需<=60秒,建议 30 秒内短视频最佳,文件 id 通过 获取 file_id
付费充值/兑换类(虚拟)——电影/演出/体育赛事/休闲娱乐/运动健身类目特殊字段
属性名
是否必选
属性key(attr_key)
示例值(attr_value)
说明
开售时间
可选。仅以下类目可调用该字段:
电影/演出/体育赛事-演出 下的叶子类目
电影/演出/体育赛事-展览活动 下的叶子类目
电影/演出/体育赛事-体育赛事 下的叶子类目
休闲娱乐-电竞桌游活动 下的叶子类目
休闲娱乐-生活体验活动 下的叶子类目
运动健身-体育活动 下的叶子类目
运动健身-户外活动 下的叶子类目
教育培训-技能学习活动 下的叶子类目
教育培训-个人成长活动 下的叶子类目
注意
以下类目支持通过 售卖时间(sold_time)属性传入开售时间及售卖截止时间。
电影/演出/体育赛事-展览活动 下的 展览/展会 叶子类目
休闲娱乐-电竞桌游活动 下的叶子类目
休闲娱乐-生活体验活动 下的叶子类目
运动健身-体育活动 下的叶子类目
运动健身-户外活动 下的叶子类目
教育培训-技能学习活动 下的叶子类目
教育培训-个人成长活动 下的叶子类目
sale_time
"2024-01-17 01:58:46"
开售时间。
支持传入售卖时间的类目,建议不再传入 开售时间(sale_time),而是通过售卖时间(sold_time)传入。当 开售时间 与 售卖时间 同时传入时,优先生效 售卖时间。
售卖时间
必选。
注意:仅以下类目可调用该字段:
电影/演出/体育赛事-展览活动 下的 展览/展会 叶子类目
休闲娱乐-电竞桌游活动 下的叶子类目
休闲娱乐-生活体验活动 下的叶子类目
运动健身-体育活动 下的叶子类目
运动健身-户外活动 下的叶子类目
教育培训-技能学习活动 下的叶子类目
教育培训-个人成长活动 下的叶子类目
sold_time
{"start_time":""2024-01-17 01:58:46"",
"end_time":""2024-02-17 01:58:46""}
售卖时间
活动时间
必选。
注意:仅以下类目可调用该字段:
电影/演出/体育赛事-展览活动 下的 展览/展会 叶子类目
休闲娱乐-电竞桌游活动 下的叶子类目
休闲娱乐-生活体验活动 下的叶子类目
运动健身-体育活动 下的叶子类目
运动健身-户外活动 下的叶子类目
教育培训-技能学习活动 下的叶子类目
教育培训-个人成长活动 下的叶子类目
activity_time
{"start_time":""2024-01-17 01:58:46"",
"end_time":""2024-02-17 01:58:46""}
活动时间
演出日期
1必选,以下类目下 必须 传入。注意:仅以下类目可调用该字段:
电影/演出/体育赛事-演出 下的叶子类目
电影/演出/体育赛事-体育赛事 下的叶子类目
2可选,以下类目下 可选 传入:
电影/演出/体育赛事-展览活动 下的 展览/展会 叶子类目
休闲娱乐-电竞桌游活动 下的叶子类目
休闲娱乐-生活体验活动 下的叶子类目
运动健身-体育活动 下的叶子类目
运动健身-户外活动 下的叶子类目
教育培训-技能学习活动 下的叶子类目
教育培训-个人成长活动 下的叶子类目
performance_date_range
{"start_date":"2024-01-18",
"end_date":"2024-02-01"}
start_date:演出开始时间,需要晚于/等于开售时间。
end_date:演出结束时间
票务代理类型
必选,以下类目下必须传入。
注意:仅以下类目可调用该字段:
电影/演出/体育赛事-演出 下的叶子类目
电影/演出/体育赛事-展览活动 下的叶子类目
电影/演出/体育赛事-体育赛事 下的叶子类目
休闲娱乐-电竞桌游活动 下的叶子类目
休闲娱乐-生活体验活动 下的叶子类目
运动健身-体育活动 下的叶子类目
运动健身-户外活动 下的叶子类目
教育培训-技能学习活动 下的叶子类目
教育培训-个人成长活动 下的叶子类目
agent_type
"1"
选择演出商品发布者的票务代理类型,请使用字符串格式。
【枚举值】
ip/主办方自运营:0
一级票务平台(票务总代理):1
一级票务平台(票务代理):2
二级票务平台:3
演出举办地区
1必选,以下类目下必须传入。 注意:仅以下类目可调用该字段:
电影/演出/体育赛事-演出 下的叶子类目
电影/演出/体育赛事-体育赛事 下的叶子类目
2可选,以下类目下 可选 传入。
电影/演出/体育赛事-展览活动 下的 展览/展会 叶子类目
休闲娱乐-电竞桌游活动 下的叶子类目
休闲娱乐-生活体验活动 下的叶子类目
运动健身-体育活动 下的叶子类目
运动健身-户外活动 下的叶子类目
教育培训-技能学习活动 下的叶子类目
教育培训-个人成长活动 下的叶子类目
performance_area
{"city_code":"120100"}
city_code:地区编码,具体到市级,按照
填写。

演出场馆名称
1必选,以下类目下必须传入。 注意:仅以下类目可调用该字段:
电影/演出/体育赛事-演出 下的叶子类目
电影/演出/体育赛事-体育赛事 下的叶子类目
2可选,以下类目下 可选 传入。
电影/演出/体育赛事-展览活动 下的 展览/展会 叶子类目
休闲娱乐-电竞桌游活动 下的叶子类目
休闲娱乐-生活体验活动 下的叶子类目
运动健身-体育活动 下的叶子类目
运动健身-户外活动 下的叶子类目
教育培训-技能学习活动 下的叶子类目
教育培训-个人成长活动 下的叶子类目
venue_name
"xxxx演艺中心"
演出场馆名称;长度限制中文长度 30 字符,英文长度 60 字符。

演出海报(图片)
必选,以下类目下必须传入。
注意:仅以下类目可调用该字段:
电影/演出/体育赛事-演出 下的叶子类目
电影/演出/体育赛事-展览活动 下的叶子类目
电影/演出/体育赛事-体育赛事 下的叶子类目
休闲娱乐-电竞桌游活动 下的叶子类目
休闲娱乐-生活体验活动 下的叶子类目
运动健身-体育活动 下的叶子类目
运动健身-户外活动 下的叶子类目
教育培训-技能学习活动 下的叶子类目
教育培训-个人成长活动 下的叶子类目
post_img
{
"url_list":[
"url1",
"url2"
]
}
演出关联的宣传海报图片的文件 id 列表,图片宽度为 348px,高度为 464px。体积限制 5mb;png,jpg,jpeg;可上传最多 1 张。文件 id 通过 alipay.marketing.image.enhance.upload(营销图片优化上传接口)获取 image_id。

地址信息
可选。
注意:仅以下类目可调用该字段:
以下类目该属性为 可选 传入:
电影/演出/体育赛事-展览活动 下的 展览/展会 叶子类目
休闲娱乐-电竞桌游活动 下的叶子类目
休闲娱乐-生活体验活动 下的叶子类目
运动健身-体育活动 下的叶子类目
运动健身-户外活动 下的叶子类目
教育培训-技能学习活动 下的叶子类目
教育培训-个人成长活动 下的叶子类目
address_info
{
"city_code":"城市编码",
"district_code":"区县编码",
"poi_name":"地址名称",
"address":"地址",
"longitude":"经度",
"latitude":"纬度"
}
选填,地址信息。
若传入该属性,左侧示例代码中如下字段必须传入,包括:城市编码、区县编码、地址、经度及纬度。
省份/城市区县/编码,按照  表格中填写。
经纬度,浮点型,小数点后最多保留 6 位。如需要录入经纬度,请以高德坐标系为准,录入时请确保经纬度参数准确,
实名规则
可选。
注意:仅以下类目可调用该字段:
以下类目该属性为 可选 传入:
电影/演出/体育赛事-展览活动 下的 展览/展会 叶子类目
休闲娱乐-电竞桌游活动 下的叶子类目
休闲娱乐-生活体验活动 下的叶子类目
运动健身-体育活动 下的叶子类目
运动健身-户外活动 下的叶子类目
教育培训-技能学习活动 下的叶子类目
教育培训-个人成长活动 下的叶子类目
real_name_rule
"0"
选填,选择实名规则,请使用字符串格式。
【枚举值】
实名参与:0
非实名参与:1
候补规则
可选。
注意:仅以下类目可调用该字段:
以下类目该属性为 可选 传入:
电影/演出/体育赛事-展览活动 下的 展览/展会 叶子类目
休闲娱乐-电竞桌游活动 下的叶子类目
休闲娱乐-生活体验活动 下的叶子类目
运动健身-体育活动 下的叶子类目
运动健身-户外活动 下的叶子类目
教育培训-技能学习活动 下的叶子类目
教育培训-个人成长活动 下的叶子类目
alternate_rule
"0"
选填,选择候补规则,请使用字符串格式。
【枚举值】
可候补:0
不可候补:1
参与规则
可选。
注意:仅以下类目可调用该字段:
以下类目该属性为 可选 传入:
电影/演出/体育赛事-展览活动 下的 展览/展会 叶子类目
休闲娱乐-电竞桌游活动 下的叶子类目
休闲娱乐-生活体验活动 下的叶子类目
运动健身-体育活动 下的叶子类目
运动健身-户外活动 下的叶子类目
教育培训-技能学习活动 下的叶子类目
教育培训-个人成长活动 下的叶子类目
engagement_rule
"0"
选填,选择参与规则,请使用字符串格式。
【枚举值】
抽签:0
直接参与:1
保险设置
可选。
注意:仅以下类目可调用该字段:
以下类目该属性为 可选 传入:
电影/演出/体育赛事-展览活动 下的 展览/展会 叶子类目
休闲娱乐-电竞桌游活动 下的叶子类目
休闲娱乐-生活体验活动 下的叶子类目
运动健身-体育活动 下的叶子类目
运动健身-户外活动 下的叶子类目
教育培训-技能学习活动 下的叶子类目
教育培训-个人成长活动 下的叶子类目
insurance_setting
"0"
选填,选择是否设置保险,请使用字符串格式。
【枚举值】
是:0
否:1
活动核销方式
可选。
注意:仅以下类目可调用该字段:
以下类目该属性为 可选 传入:
电影/演出/体育赛事-展览活动 下的 展览/展会 叶子类目
休闲娱乐-电竞桌游活动 下的叶子类目
休闲娱乐-生活体验活动 下的叶子类目
运动健身-体育活动 下的叶子类目
运动健身-户外活动 下的叶子类目
教育培训-技能学习活动 下的叶子类目
教育培训-个人成长活动 下的叶子类目
activity_verify_type
"1"
选填,选择活动核销方式,请使用字符串格式。
【枚举值】
电子票:0
签到:1
无需核销:2
活动人数
可选。
注意:仅以下类目可调用该字段:
以下类目该属性为 可选 传入:
电影/演出/体育赛事-展览活动 下的 展览/展会 叶子类目
休闲娱乐-电竞桌游活动 下的叶子类目
休闲娱乐-生活体验活动 下的叶子类目
运动健身-体育活动 下的叶子类目
运动健身-户外活动 下的叶子类目
教育培训-技能学习活动 下的叶子类目
教育培训-个人成长活动 下的叶子类目
activity_capacity
"50"
活动人数,请使用字符串格式。
退款规则
可选。
注意:仅以下类目可调用该字段:
以下类目该属性为 可选 传入:
电影/演出/体育赛事-展览活动 下的 展览/展会 叶子类目
休闲娱乐-电竞桌游活动 下的叶子类目
休闲娱乐-生活体验活动 下的叶子类目
运动健身-体育活动 下的叶子类目
运动健身-户外活动 下的叶子类目
教育培训-技能学习活动 下的叶子类目
教育培训-个人成长活动 下的叶子类目
refund_rule
{
     "refund_policy": ["8"],
     "conditional_refund_rule":
[{
         "hour_start": 6
    }]
}
选填,针对凯发app官方网站的线下活动商品:
1. refund_policy:请使用字符串列表格式。
2. refund_policy 取值范围:
"4":"不可退";
"8":"部分时段可退";
3. conditional_refund_rule 可为空,仅当 refund_policy 为 "8" 时有效,传入开始前小时数 hour_start,代表活动开始前 x 小时可退款。
生活号id
可选。注意:仅以下类目可调用该字段:
休闲娱乐-电竞桌游活动 下的叶子类目
休闲娱乐-生活体验活动 下的叶子类目
运动健身-体育活动 下的叶子类目
运动健身-户外活动 下的叶子类目
教育培训-技能学习活动 下的叶子类目
教育培训-个人成长活动 下的叶子类目
public_id
"2030019997976095"
选填,生活号 id 传入后,凯发app官方网站的线下活动商品后续详情页可展示生活号对应的头像、名称。
客服电话
必选。
注意:仅以下类目可调用该字段:
电影/演出/体育赛事-展览活动 下的 展览/展会 叶子类目
休闲娱乐-电竞桌游活动 下的叶子类目
休闲娱乐-生活体验活动 下的叶子类目
运动健身-体育活动 下的叶子类目
运动健身-户外活动 下的叶子类目
教育培训-技能学习活动 下的叶子类目
教育培训-个人成长活动 下的叶子类目
customer_service_mobile
{
     "phone_type": "1",
     "phone_number": "1**********"
}
客服电话,必填。
1. phone_type:电话类型,字符串格式。
  取值范围:
手机:"1"
座机:"2"
2. phone_number:电话号码,字符串格式。
售卖类(实物)商品属性字段特殊字段
属性名称
是否必选
属性key(attr_key)
示例值(attr_value)
说明
服务承诺
可选
service_commitment
["1","7"]
请使用字符串格式。 实物商品支持“1”,“7”。
极速退款:“1”
包邮:“7”
租赁类(实物)商品属性字段
属性名
是否必选
属性key(attr_key)
示例值(attr_value)
说明
起租天数
租赁类(实物)商品必选。
rent_from_numbers_of_day
"3"
租赁类(实物)商品必填,请选择起租天数。
可选择值为:1,3,7,15,30,90,180,365。
商品成色
租赁类(实物)商品必选
item_fineness
"wholenew"
"secondhand"
租赁类(实物)商品必填。
全新是指官方全新未拆封的;
资源机、99 新等属于二手。
是否支持免押
租赁类(实物)商品可
whether_support_free_deposit
"1"
租赁类(实物)商品选填。
请选择是否支持芝麻免押。
1 代表支持,0 代表不支持。
可续租
租赁类(实物)商品可
whether_continue_rent
"1"
租赁类(实物)商品选填。
请选择是否可续租。
1 代表支持,0 代表不支持。
可买断
租赁类(实物)商品可
whether_buyout
"1"
租赁类(实物)商品选填。
请选择是否可买断。
1 代表支持,0 代表不支持。
最低首期实付租金
租赁类(实物)商品可
minimum_initial_rent_payment
"100"
租赁类(实物)商品选填。
用户首期最低实际支付的租金,单位为元。
商品最低售价(最低日租金)对应的租期天数
租赁类(实物)商品可
minimum_rent_price_numbers_of_day
"365"
租赁类(实物)商品选填。
数值类型,单位为天。
请填写最低租金售价对应的天数,假设商品租金最低为 3 元/天,对应的租期为 1 年,则填写 365。
增值服务
租赁类(实物)商品可选。
value_added_services
[{
     "service_name": "增值服务名称",             "service_introduction": "增值服务说明",
     "service_price": "100"
}]
1增值服务最多 5 组。
2service_name:增值服务名称, [1,60] 字符。
3service_introduction:增值服务描述, [1,1000] 个字符。
4service_price:增值服务金额, [0,99999900] 分。
服务承诺
租赁类(实物)商品可选。
service_commitment
["2"]
请使用字符串格式。
租赁商品支持“2”,“11”
寄出包邮:“2”
顺丰包邮:“11”
租赁类(实物)商品可选。
注意:仅以下类目可调用该字段(类目名称以实际展示名称为准)
手机
电脑
数码相机/单反相机/摄像机
车船模/军模/无人机/穿越机
智能设备-智能飞行智能摄像
3c数码配件-直播/摄影配件数码相机配件胶片相机配件
影音电器-麦克风/话筒
二手3c数码-手机整机
["2","3","5","6","8"]
请使用字符串格式。
租赁商品支持“2”,“3”,“4”,“5”,“6”,“8”,“11”。
寄出包邮:“2”
租期质保:“3”
随租随还:“4”
免赔保障:“5”
隐私保护:“6”
极速审核:“8”
顺丰包邮:“11”
租赁类(实物)商品可选。
注意:仅以下类目可调用该字段(类目名称以实际展示名称为准)
电玩/配件/游戏/攻略
智能设备-智能眼镜/vr头盔xr设备
["2","6","11"]
请使用字符串格式。
租赁商品支持“2”,“6”,“8”,“11”。
寄出包邮:“2”
隐私保护:“6”
极速审核:“8”
顺丰包邮:“11”
租赁类(实物)商品可选。
注意:仅以下类目可调用该字段(类目名称以实际展示名称为准)
箱包皮具/热销女包/男包-女士包袋男士包袋
["9","10","11"]
请使用字符串格式。
租赁商品支持“2”,“9”,“10”,“11”。
寄出包邮:“2”
专业鉴定:“9”
免赔服务:“10”
顺丰包邮:“11”
付费充值/兑换类(虚拟)iap商品特殊字段
属性名称
是否必选
属性key
解释
示意值
appstore产品id
否,付费充值/兑换类(虚拟)选填
product_id
苹果产品码,是 app 在苹果商店中申请审核通过商品对应的唯一标识,是唤起 iap 支付必须的参数,长度为 0-100 个字符。
402200003
商品摘要
否,付费充值/兑换类(虚拟)选填
summary
在苹果商店中设置的商品名称或商品简介,长度为 0-100 个字符。
xxapp
appstore价格
否,付费充值/兑换类(虚拟)选填
iapprice
app 在苹果商店中申请审核通过商品对应的定价,单位为分。
1300
专家预测类目字段
属性名称
是否必选
属性key
说明
作者头像
专家预测类目下必填
author_avatar
【大小要求】图片大小 800kb 以内。 【格式支持】png,jpg,jpeg 【尺寸要求】80*80px(高宽均不小于 80*80px 即可上传通过尺寸验证) 支付宝开放平台对应,商品专家预测图场景: item_experts_predict_img
文件 id 通过 alipay.marketing.image.enhance.upload(营销图片优化上传接口) 获取 image_id。
作者名称
专家预测类目下必填
author_name
预测比赛的专家名称。
说明:最多 10 个字。
近期战绩
非必填
recent_record
示例:近10中8
说明:请按照真实成绩进行宣传
连红战绩
非必填
wins_record
示例:9连红
预测标题
专家预测类目下必填
forecast_title
专家预测比赛的标题
准确率
非必填
accuracy_rate
示例:96
说明:请填写具体数值,单位为 %
发布时间
专家预测类目下必填
release_time
2024-10-10 00:00:00
说明:时间格式 yyyy-mm-dd hh:mm:ss
场次id
专家预测类目下必填
session_id
144675
说明:请填写比赛场次id
比赛场次名称
专家预测类目下必填
session_name
请填写比赛场次
内容详情
专家预测类目下必填
content_details
接入商家将支付付费内容通过接口传入,请填写文本信息
黄金类目字段
属性名称
是否必选
属性key(attr_key)
示意值
说明
克重
选择类目为珠宝/钻石/翡翠/黄金-投资金、珠宝/钻石/翡翠/黄金-首饰金时填入,非必填
gram_weight
2.11
商品克重,保留 2 位小数,单位为 g。
加工费
选择类目为珠宝/钻石/翡翠/黄金-投资金、珠宝/钻石/翡翠/黄金-首饰金时填入,非必填
processing_fee
55.61
生产投资金或首饰金的加工费,单位为分。
传参示例
内容没有解决您的问题?您还可以前往 或 寻求帮助
凯发k8官方网娱乐官方 copyright © 2022 支付宝(杭州)信息技术有限公司  | icp证浙b2-20160559
该文档对你是否有帮助?
当前页面目录
网站地图