通用场景
该接口主要用来商品状态变更消息同步，包括但不限于商品审核通过、审核驳回、商品被冻结等引起的状态变更，商家/服务商可以监听本接口感知商品状态信息的变更。
该消息仅包含简单的状态变更通知，更多商品信息需通过 alipay.open.app.item.query（商品状态查询接口）获取。
该消息仅包含简单的状态变更通知，更多商品信息需通过 alipay.open.app.item.query（商品状态查询接口）获取。
公共请求参数
| 参数 | 类型 | 是否必选 | 最大长度 | 描述 | 示例值 |
|---|---|---|---|---|---|
| notify_id | string | 必选 | 50 | 通知id | 5608cccc09ddb39d41c2e3c06e3d9fejh2 |
| utc_timestamp | string | 必选 | 13 | 消息发送时的服务端时间 | 1514210452731 |
| msg_method | string | 必选 | 100 | 消息接口名称 | alipay.open.app.item.status.notify |
| app_id | string | 必选 | 20 | 消息接受方的应用id | 2014060600164699 |
| version | string | 必选 | 5 | 版本号(1.1版本为标准消息) | 1.0或者1.1 |
| biz_content | string | 必选 | 消息报文 | 参见消息属性 | |
| sign | string | 必选 | 签名 | wco t3d8kg71dtlkwn7r9pzuoxeabjwp8/fousxcuskxsovyxbpsaidpryscjhcjmaglncjokjqlj28/asl93jotw39fx6i07lxhnbpknezalwmvpdnqui01hzszf9v1i6ggzjbiad5lg8bzttxzoj87ub2i9guj3nr/nuc9vey= | |
| sign_type | string | 必选 | 10 | 签名类型 | rsa2 |
| charset | string | 必选 | 10 | 编码集，该字符集为验签和解密所需要的字符集 | utf-8 |
消息属性
item_id｜平台侧商品id必选string(64)
【描述】平台侧商品id
【示例值】2023010100000000000001
out_item_id｜商家侧商品id必选string(100)
【描述】商家侧商品id
【示例值】beijingkaoya
event_time｜事件创建时间必选string(15)
【描述】事件创建时间，精确到毫秒
【示例值】1677237573000
type｜事件类型必选string(20)
【描述】消息事件类型,type字段不一定会返回，以实际返回为准
【枚举值】
商品处置变更: item_dispose
商品操作变更: item_config
商品审核变更: item_audit
【示例值】item_config
spu_status｜状态必选string(15)
【描述】spu状态
【枚举值】
审核驳回: audit_reject
已冻结: freeze
审核中: auditing
【示例值】freeze
reasons｜审核驳回原因必选appitemrejectreasonvo[]
【描述】审核驳回原因
risk_name｜风险项名称可选string(128)
【描述】风险项名称
【示例值】商品名称
remark｜备注原因可选string(2048)
【描述】备注原因
【示例值】您提报的商品名称与时机页面内容无关
problem_pic｜示例图片url可选string[](2048)
【描述】示例图片url
【示例值】["http://www.alipay.com"]
data｜商品变更内容必选appitemnotifydatavo
【描述】商品操作、审核动作所带来的变更内容
【注意事项】该字段仅支持普通商品变更触达。
source｜来源必选string(10)
【描述】当前操作所发生的站点
【枚举值】
b站: b_merchant
p站: p_merchant
openapi: open_api
【示例值】b_merchant
event_type｜事件类型必选string(20)
【描述】商品数据变更所属的事件类型
【枚举值】
新建: create
修改: modify
免审更新: direct_modify
【示例值】create
before｜商品数据变更前内容可选appitemdatadiffvo
【描述】商品数据变更前内容
title｜商品名称必选string(60)
【描述】商品名称，字符类型，最少不低于3，最长不超过60个字。注：1.商品标题只允许汉字、数字、英文字母、特殊字符集；2.商品标题不得仅为数字、字母、特殊字符集或上述三种的组合
【示例值】美味甜甜圈
head_img｜商品主体必选string(128)
【描述】【描述】商品主图的文件id/url，图片宽高为750px*750px，宽高比1:1，800kb以内。 支持jpg、jpeg、png格式的图片。
【示例值】https://mdn.alipayobjects.com/openpt_appstore/afts/img/a*phfasaesf_0aaaaaaaaaaaaaatcnaq/original
skus｜商品sku变更内容列表必选appitemskudiffvo[]
【描述】商品sku变更内容列表
sku_modify_type｜sku数据变更类型必选string(20)
【描述】sku信息新增（create），sku信息修改（modify），sku信息删除（delete）
【枚举值】
新增: create
修改: modify
删除: delete
【示例值】modify
out_sku_id｜商家侧skuid必选string(128)
【描述】商家侧sku id，appid维度下全局唯一
【示例值】99999
original_price｜原价必选string(32)
【描述】sku原价，分为单位
【示例值】12000
sale_price｜售价必选string(32)
【描述】sku售价，分为单位
【示例值】3000
bar_code｜条形码必选string(64)
【描述】sku条形码
【示例值】12345678
stock_num｜库存可选number(32)
【描述】sku库存，目前支持库存区间为0-99999
【示例值】9999
sale_status｜售卖状态可选string(16)
【描述】sku售卖状态，包含以下两种状态： 已下架(delisting) 可售卖(available)
【枚举值】
可售卖: available
已下架: delisting
【示例值】available
thumb_img｜sku小图可选string(256)
【描述】图片url，宽高为400px*400px，宽高比1:1
【示例值】https://mdgwdev.alipay.net/mrch_material/afts/img/a*wjvvrz9174eaaaaaaaaaaaaaav91aq/original
image_list｜商品子图可选string[](1000)
【描述】商品子图，作为平台详情页组件的轮播图，图片宽高为750px*750px，宽高比1:1，800kb以内，不超过 3 个图片。 支持jpg、jpeg、png格式的图片。
【示例值】["https://mdn.alipayobjects.com/openpt_appstore/afts/img/a*phfasaesf_0aaaaaaaaaaaaaatcnaq/original"]
sale_status｜商品售卖状态可选string(20)
【描述】商品售卖状态
【枚举值】
审核失败: audit_reject
审核中: auditing
已下架: delisting
【示例值】available
after｜商品数据变更后内容可选appitemdatadiffvo
【描述】商品数据变更后内容
title｜商品名称必选string(60)
【描述】商品名称，字符类型，最少不低于3，最长不超过60个字。注：1.商品标题只允许汉字、数字、英文字母、特殊字符集；2.商品标题不得仅为数字、字母、特殊字符集或上述三种的组合
【示例值】美味甜甜圈
head_img｜商品主体必选string(128)
【描述】【描述】商品主图的文件id/url，图片宽高为750px*750px，宽高比1:1，800kb以内。 支持jpg、jpeg、png格式的图片。
【示例值】https://mdn.alipayobjects.com/openpt_appstore/afts/img/a*phfasaesf_0aaaaaaaaaaaaaatcnaq/original
skus｜商品sku变更内容列表必选appitemskudiffvo[]
【描述】商品sku变更内容列表
sku_modify_type｜sku数据变更类型必选string(20)
【描述】sku信息新增（create），sku信息修改（modify），sku信息删除（delete）
【枚举值】
新增: create
修改: modify
删除: delete
【示例值】modify
out_sku_id｜商家侧skuid必选string(128)
【描述】商家侧sku id，appid维度下全局唯一
【示例值】99999
original_price｜原价必选string(32)
【描述】sku原价，分为单位
【示例值】12000
sale_price｜售价必选string(32)
【描述】sku售价，分为单位
【示例值】3000
bar_code｜条形码必选string(64)
【描述】sku条形码
【示例值】12345678
stock_num｜库存可选number(32)
【描述】sku库存，目前支持库存区间为0-99999
【示例值】9999
sale_status｜售卖状态可选string(16)
【描述】sku售卖状态，包含以下两种状态： 已下架(delisting) 可售卖(available)
【枚举值】
可售卖: available
已下架: delisting
【示例值】available
thumb_img｜sku小图可选string(256)
【描述】图片url，宽高为400px*400px，宽高比1:1
【示例值】https://mdgwdev.alipay.net/mrch_material/afts/img/a*wjvvrz9174eaaaaaaaaaaaaaav91aq/original
image_list｜商品子图可选string[](1000)
【描述】商品子图，作为平台详情页组件的轮播图，图片宽高为750px*750px，宽高比1:1，800kb以内，不超过 3 个图片。 支持jpg、jpeg、png格式的图片。
【示例值】["https://mdn.alipayobjects.com/openpt_appstore/afts/img/a*phfasaesf_0aaaaaaaaaaaaaatcnaq/original"]
sale_status｜商品售卖状态可选string(20)
【描述】商品售卖状态
【枚举值】
审核失败: audit_reject
审核中: auditing
已下架: delisting
【示例值】available
消息示例
默认示例
curl -x post 'notify_url' \
--header 'content-type: application/x-www-form-urlencoded; charset=utf-8' \
--data-urlencode 'charset=utf-8' \
--data-urlencode 'biz_content={
"item_id":"2023010100000000000001",
"out_item_id":"beijingkaoya",
"event_time":"1677237573000",
"type":"item_config",
"spu_status":"freeze",
"reasons":[
{
"problem_pic":[
"http://www.alipay.com"
],
"remark":"您提报的商品名称与时机页面内容无关",
"risk_name":"商品名称"
}
],
"data":{
"event_type":"create",
"before":{
"skus":[
{
"out_sku_id":"99999",
"original_price":"12000",
"sku_modify_type":"modify",
"stock_num":9999,
"bar_code":"12345678",
"sale_status":"available",
"sale_price":"3000",
"thumb_img":"https://mdgwdev.alipay.net/mrch_material/afts/img/a*wjvvrz9174eaaaaaaaaaaaaaav91aq/original"
}
],
"head_img":"https://mdn.alipayobjects.com/openpt_appstore/afts/img/a*phfasaesf_0aaaaaaaaaaaaaatcnaq/original",
"sale_status":"available",
"title":"美味甜甜圈",
"image_list":[
"https://mdn.alipayobjects.com/openpt_appstore/afts/img/a*phfasaesf_0aaaaaaaaaaaaaatcnaq/original"
]
},
"source":"b_merchant",
"after":{
"skus":[
{
"out_sku_id":"99999",
"original_price":"12000",
"sku_modify_type":"modify",
"stock_num":9999,
"bar_code":"12345678",
"sale_status":"available",
"sale_price":"3000",
"thumb_img":"https://mdgwdev.alipay.net/mrch_material/afts/img/a*wjvvrz9174eaaaaaaaaaaaaaav91aq/original"
}
],
"head_img":"https://mdn.alipayobjects.com/openpt_appstore/afts/img/a*phfasaesf_0aaaaaaaaaaaaaatcnaq/original",
"sale_status":"available",
"title":"美味甜甜圈",
"image_list":[
"https://mdn.alipayobjects.com/openpt_appstore/afts/img/a*phfasaesf_0aaaaaaaaaaaaaatcnaq/original"
]
}
}
}' \
--data-urlencode 'utc_timestamp=${now}' \
--data-urlencode 'sign=${sign}' \
--data-urlencode 'app_id=${appid}' \
--data-urlencode 'version=1.1' \
--data-urlencode 'sign_type=rsa2' \
--data-urlencode 'notify_id=${notify_id}' \
--data-urlencode 'msg_method=alipay.open.app.item.status.notify'说明：notify_url是开发者在开放平台控制台上设置的应用网关地址
通知应答
| 响应报文 | 描述 | 是否重试 | 是否区分大小写 |
|---|---|---|---|
| success | 消息处理成功 | 否 | 否 |
| fail | 消息处理失败 | 是 | 否 |
说明：消息服务会根据响应报文判断商户系统是否已经成功处理消息。如果http同步响应报文返回 success 字符串，消息服务则认为消息已经处理成功，停止投递，如果返回 fail ，表示消息获取失败，支付宝会根据投递重试策略重新发送消息到应用网关地址；
投递重试策略：一般情况下，25 小时以内完成 8 次通知，除了第一次是实时投递外，后续的每次重试都会间隔一段时间，间隔频率一般是：2m、10m、10m、1h、2h、6h、15h（第二次消息投递是在第一次投递失败后的 2 分钟；第三次投递是在第二次投递失败后的 10 分钟，以此类推）
接口工具
消息服务文档
获取sdk