完成接入准备后，商家和服务商可根据本文指引快速集成 小程序商品。

说明：

小程序商品 仅支持自研商家/服务商通过自研应用或第三方应用代调用（传入 app_auth_token）方式，调用 API 接入。

小程序商品 支持沙箱调试。

接入步骤

类目查询接口

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

注意

类目信息决定了商品入库时需要填写的字段信息，以及后续商品交易相关数据，请正确填写。

获取普通商品模板信息接口

商家可通过 alipay.open.app.item.template.query（获取普通商品模板信息）获取不同类目下需要添加的个性化属性信息，接口里面的类目 ID 编码是从 alipay.open.app.item.allcategory.query（获取普通商品类目接口）中获取到的。

注意

不同类目以及不同商品类型，对应的个性化属性及其校验规则是不一样的，需要动态实时查询。

创建商品接口

商家可通过 alipay.open.app.item.create（小程序商品创建接口）向支付宝提报小程序内的商品详情页。创建成功后支付宝会返回支付宝平台侧商品ID作为该商品的支付宝全局唯一商品编码供后续使用。

注意

需保证商品的商家侧商品ID在该小程序下的唯一性。

商品 SPU 下的 SKU 信息为非必填，如果商品下没有 SKU 信息，则 SPU 的库存以及售卖状态需要单独设置，如果有 SKU，则 SPU 库存以及售卖状态是通过商品下的 SKU 的库存以及售卖状态计算得出来的，具体计算规则：

可售卖：只要有一个 SKU 的售卖状态是可售卖，则 SPU 的售卖状态为可售卖。

已下架：当所有商品的售卖状态是已下架，则 SPU 的售卖状态为已下架。

库存：SPU 库存为所有 SKU 库存之和。

查询商品接口

商家可通过 alipay.open.app.item.query（小程序商品详情查询接口）使用上传商家侧商品ID，或是返回的支付宝平台侧商品ID查询已经创建的商品信息。

注意

商品查询需要传入创建时返回的支付宝平台侧商品ID，或者商家侧商品ID，两者不可同时为空。

商品创建完成后通过审核，所以首次提交的商品在审核结果未出前，需要设置 need_edit_spu=1 才能查询到。

批量查询商品接口

商家可通过 alipay.open.app.item.list.query（小程序商品分页查询接口），通过上传商家侧id列表，或是返回的平台侧商品id列表查询已经创建的商品信息。

注意

商品查询需要传入创建时返回的平台侧商品id列表，或者商户自己的唯一商家侧id列表，两者不可同时为空，不可以混传。

该接口只能查询生效中的商品详情，不能根据不同的 ID 返回不同版本的数据。

更新商品接口

商家可使用 alipay.open.app.item.modify（小程序商品更新接口），通过上传商家侧商品ID，或是返回的支付宝平台侧商品ID查询已经创建的商品信息。

注意

商品首先需要同步到支付宝侧后才能支持修改，如果商品已经有一个版本是在审核中了，这时候商品是不支持修改的。

如果只修改了商品的商品售卖状态、库存、价格（商品售价、商品原价），则不用进入审核流程。

免审更新商品接口

正常情况下，修改商品详情页的基础字段等信息都需要进行审核。商家可通过 alipay.open.app.item.direct.modify（商品免审更新接口）使用上传商家侧商品ID，或是返回的支付宝平台侧商品ID修改商品以及子 SKU 的售卖状态、库存信息、价格。

注意

商品首先需要同步到支付宝侧后才能支持状态修改，审核中的商品不支持修改。

可以通过该接口对 SPU 以及下面的 SKU 售卖状态同时进行修改。

删除商品接口

商家可使用 alipay.open.app.item.delete（小程序商品移除接口），通过上传商家侧商品ID列表，或是返回的支付宝平台侧商品ID删除不需要的商品信息。

注意

商品首先需要同步到支付宝侧后才能支持删除。

商品删除会将生效中的版本删除并从场景侧下线，并且删除是不可逆的，谨慎操作。

商品状态变更消息通知

商家/服务商可以监听 alipay.open.app.item.status.notify（商品状态变更消息同步接口），感知商品状态信息的变更。商品审核通过或驳回，以及后续商品售罄或冻结（违规/质量异常）均会通过本消息进行通知。

注意

商品状态变更通知会在商品状态变更时发出，包括审核、售罄、冻结等操作生效之后发出。

变更推广计划通知仅包含简单的推广计划变更通知信息，更多商品信息需通过 alipay.open.app.item.query（小程序商品详情查询接口）获取。

消息示例

ISV_GATEWAY_URL?charset=GBK&biz_content=
{
"platform_item_id":"400000001","item_id":"88888","audit_status":"REJECT","reasons":[{"riskName":"商品名称","remark":"您提报的商品名称与页面内容无关","problemPic":"http://www.xxx.com/aaa"}],"timestamp":1516797622752
}
&msg_method=alipay.open.app.item.status.notify&utc_timestamp=1516797622752&version=1.1&sign_type=RSA2&notify_id=d275fec564e62af6bedbcee73f3f05fi5x&app_id=2013121700999429&sign=I+Y/lvqYUEEc10EPdpntRhFIQ==

文件上传接口

商家可以调用 alipay.open.file.upload（支付宝文件上传接口）将自己的图片信息转存到支付宝侧进行使用，例如商品的主子图等。

普通商品快速接入

接入步骤#

类目查询接口#

获取普通商品模板信息接口#

创建商品接口#

查询商品接口#

批量查询商品接口#

更新商品接口#

免审更新商品接口#

删除商品接口#

商品状态变更消息通知#

文件上传接口#