完成接入准备后，商家/服务商可根据本文指引快速接入 商品卖货 产品。

说明：

商品卖货仅支持自研商家/服务商通过自研应用或第三方应用代调用方式，调用 API 接入。

商品卖货 暂不支持沙箱调试。

接口调用时序图

**说明：**其中商家与服务商的交互流程仅为示意，具体交互方式以服务商实际使用场景为准。

推广计划状态流转图

注意：

创建推广之后进入审核中状态，审核结果通过异步消息通知到服务商。

已过期的推广计划会被定期清理进入已失效状态。

商品卖货前置准备

准备事项	如何完成	特殊说明
慧推宝签约“慧推宝”是支付宝向商家提供的，并根据商家意愿在支付宝客户端特定场景对其商品及交易进行（1）管理和营销推广；（2）接入功能组件服务（如接入交易组件完成交易数据同步和交易订单管理）；（3）资金分账、结算配置服务；及（4）其它营销分析、体验保障等相关服务的一站式技术解决方案	普通商家：目前慧推宝签约无开放入口，当商家进入商品卖货&未签约时，才能进入慧推宝签约流程	慧推宝费率，需进入签约流程查看。若在其它场景，如商品直播运营时已完成慧推宝签约，在商品卖货的推广链路中，无需再次签约慧推宝。但需关注各频道的费率详情。注意：直付通商家，请联系支付宝业务人员进行代签约。
JSAPI签约JSAPI支付是指商家小程序在支付宝APP中，通过调用支付宝提供的JSAPI接口，调起支付宝收银台完成收款的一款支付产品。	方式一：商家点击 JSAPI支付，前往签约。方式二：有支付宝业务人员对接的商户，可优先通过支付宝业务人员发起JSAPI支付产品签约。方式三：服务商代运营的商家，请联系服务商发起JSAPI支付产品签约。	-
缴纳保证金为促进支付宝商家更好地服务用户、保障用户交易权益，小程序商品在支付宝包括但不限于会员频道、直播、消费圈、行业频道等特定场景进行推广推荐时，需缴存保证金。	当商家进入商品卖货&未足额缴纳保证金时，平台会自动提醒缴纳保证金；缴纳后，商家可在商家平台 > 对账中心 > 保证金管理页面进行查看。	-
交易组件接入并完成校验	交易组件接入可查看接入文档。注意：交易组件接入后需要通过验收流程。	商户需要保证交易组件中的商品参数信息准确，订单金额与支付金额一致。
接入支付宝小程序商品	小程序商品产品介绍小程序商品开放类目本地生活商品平台券码版

创建推广计划

商家/服务商调用 alipay.marketing.activity.delivery.create（创建推广计划），将商家/服务商系统中创建好的商品推广至指定频道。

注意：

一个支付宝侧商品 id在同一时间仅能存在一个状态为审核中或推广中的推广计划。

支付宝侧商品 id 为商品创建时返回的 itemId。

目前支持的商品类型为实物商品、团购套餐、代金券。

推广审核通过后需等待约半小时才会生效。

本接口仅提交推广计划创建申请，计划创建结果，以 alipay.marketing.activity.delivery.changed（推广计划状态变更消息）为准，可查看变更推广状态通知；还可通过 alipay.marketing.activity.delivery.query（查询推广计划），传入delivery_id（推广计划 id）查询确认。

请求示例

package com.java.sdk.demo;

import com.alipay.v3.ApiException;
import com.alipay.v3.ApiClient;
import com.alipay.v3.util.model.AlipayConfig;
import com.alipay.v3.Configuration;
import com.alipay.v3.api.AlipayMarketingActivityDeliveryApi;
import com.alipay.v3.model.*;
import java.io.File;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

public class AlipayMarketingActivityDeliveryApiCreate {

    public static void main(String[] args) throws ApiException {
        ApiClient defaultClient = Configuration.getDefaultApiClient();
        // 初始化alipay参数（全局设置一次）
        AlipayConfig alipayConfig = new AlipayConfig();
        alipayConfig.setServerUrl("https://openapi.alipay.com");
        alipayConfig.setAppId("<-- 请填写您的AppId，例如：2019091767145019 -->");
        alipayConfig.setPrivateKey("<-- 请填写您的应用私钥，例如：MIIEvQIBADANB ... ... -->");
        alipayConfig.setAlipayPublicKey("<-- 请填写您的支付宝公钥，例如：MIIBIjANBg... -->");
        defaultClient.setAlipayConfig(alipayConfig);
        AlipayMarketingActivityDeliveryApi api = new AlipayMarketingActivityDeliveryApi();
        AlipayMarketingActivityDeliveryCreateModel data = new AlipayMarketingActivityDeliveryCreateModel();
        data.setDeliveryBoothCode("PREFER_CHANNEL");
        data.setOutBizNo("20170101000001654bb46ba");
        DeliveryPlayConfig deliveryPlayConfig = new DeliveryPlayConfig();
        DeliverySingleSendConfig deliverySingleSendConfig = new DeliverySingleSendConfig();
        DeliveryContentInfo deliveryContentInfo = new DeliveryContentInfo();
        deliveryContentInfo.setDeliveryContentType("APP_ITEM");
        DeliveryItemContentInfo deliveryItemContent = new DeliveryItemContentInfo();
        deliveryItemContent.setItemId("2023062022000400598672");
        deliveryItemContent.setItemType("PHYSICAL");
        deliveryContentInfo.setDeliveryItemContent(deliveryItemContent);
        deliverySingleSendConfig.setDeliveryContentInfo(deliveryContentInfo);
        deliveryPlayConfig.setDeliverySingleSendConfig(deliverySingleSendConfig);
        data.setDeliveryPlayConfig(deliveryPlayConfig);
        DeliveryBaseInfo deliveryBaseInfo = new DeliveryBaseInfo();
        deliveryBaseInfo.setDeliveryName("商品名称0706推广");
        deliveryBaseInfo.setDeliveryBeginTime("2017-01-01 00:00:01");
        deliveryBaseInfo.setDeliveryEndTime("2017-01-10 00:00:01");
        data.setDeliveryBaseInfo(deliveryBaseInfo);
        data.setMerchantAccessMode("SELF_MODE");
        try {
            AlipayMarketingActivityDeliveryCreateResponseModel response = api.create(data);
        } catch (ApiException e) {
            AlipayMarketingActivityDeliveryCreateDefaultResponse errorObject = (AlipayMarketingActivityDeliveryCreateDefaultResponse) e.getErrorObject();
            System.out.println("调用失败:" + errorObject);
        }
    }
}

查询推广计划

商家/服务商可以调用 alipay.marketing.activity.delivery.query（查询推广计划），查询推广计划的详情信息。

请求示例

package com.java.sdk.demo;

import com.alipay.v3.ApiException;
import com.alipay.v3.ApiClient;
import com.alipay.v3.util.model.AlipayConfig;
import com.alipay.v3.Configuration;
import com.alipay.v3.api.AlipayMarketingActivityDeliveryApi;
import com.alipay.v3.model.*;
import java.io.File;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

public class AlipayMarketingActivityDeliveryApiQuery {

    public static void main(String[] args) throws ApiException {
        ApiClient defaultClient = Configuration.getDefaultApiClient();
        // 初始化alipay参数（全局设置一次）
        AlipayConfig alipayConfig = new AlipayConfig();
        alipayConfig.setServerUrl("https://openapi.alipay.com");
        alipayConfig.setAppId("<-- 请填写您的AppId，例如：2019091767145019 -->");
        alipayConfig.setPrivateKey("<-- 请填写您的应用私钥，例如：MIIEvQIBADANB ... ... -->");
        alipayConfig.setAlipayPublicKey("<-- 请填写您的支付宝公钥，例如：MIIBIjANBg... -->");
        defaultClient.setAlipayConfig(alipayConfig);
        AlipayMarketingActivityDeliveryApi api = new AlipayMarketingActivityDeliveryApi();
        String deliveryId = "20121231231242353";
        AlipayMarketingActivityDeliveryQueryModel data = new AlipayMarketingActivityDeliveryQueryModel();
        data.setMerchantAccessMode("SELF_MODE");
        try {
            AlipayMarketingActivityDeliveryQueryResponseModel response = api.query(deliveryId, data);
        } catch (ApiException e) {
            AlipayMarketingActivityDeliveryQueryDefaultResponse errorObject = (AlipayMarketingActivityDeliveryQueryDefaultResponse) e.getErrorObject();
            System.out.println("调用失败:" + errorObject);
        }
    }
}

停止推广计划

商家/服务商可调用 alipay.marketing.activity.delivery.stop（停止推广计划），终止已经推广到指定渠道的推广计划，且不可恢复。

注意：

调用接口停止推广后，存在 5 ~ 10 分钟延迟才会生效。

请求示例

package com.java.sdk.demo;

import com.alipay.v3.ApiException;
import com.alipay.v3.ApiClient;
import com.alipay.v3.util.model.AlipayConfig;
import com.alipay.v3.Configuration;
import com.alipay.v3.api.AlipayMarketingActivityDeliveryApi;
import com.alipay.v3.model.*;
import java.io.File;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

public class AlipayMarketingActivityDeliveryApiStop {

    public static void main(String[] args) throws ApiException {
        ApiClient defaultClient = Configuration.getDefaultApiClient();
        // 初始化alipay参数（全局设置一次）
        AlipayConfig alipayConfig = new AlipayConfig();
        alipayConfig.setServerUrl("https://openapi.alipay.com");
        alipayConfig.setAppId("<-- 请填写您的AppId，例如：2019091767145019 -->");
        alipayConfig.setPrivateKey("<-- 请填写您的应用私钥，例如：MIIEvQIBADANB ... ... -->");
        alipayConfig.setAlipayPublicKey("<-- 请填写您的支付宝公钥，例如：MIIBIjANBg... -->");
        defaultClient.setAlipayConfig(alipayConfig);
        AlipayMarketingActivityDeliveryApi api = new AlipayMarketingActivityDeliveryApi();
        String deliveryId = "20121231231242353";
        AlipayMarketingActivityDeliveryStopModel data = new AlipayMarketingActivityDeliveryStopModel();
        data.setOutBizNo("20170101000001654bb46ba");
        data.setMerchantAccessMode("SELF_MODE");
        try {
            AlipayMarketingActivityDeliveryStopResponseModel response = api.stop(deliveryId, data);
        } catch (ApiException e) {
            AlipayMarketingActivityDeliveryStopDefaultResponse errorObject = (AlipayMarketingActivityDeliveryStopDefaultResponse) e.getErrorObject();
            System.out.println("调用失败:" + errorObject);
        }
    }
}

消息通知

商家/服务商创建的审核中推广计划在审核后，支付宝都将通过 alipay.marketing.activity.delivery.changed（推广计划状态变更消息）向商家应用或第三方应用应用网关推送异步通知消息，同步审核结果。

说明：

更多支付宝异步消息通知详情可查看 From 蚂蚁消息服务使用。

若商家/服务商网络环境比较复杂，例如：通过统一网关间连互联网，推荐使用网络兼容性更好的标准 HTTP(S) 协议进行对接。

订阅消息

商家/服务商需根据订阅消息指引，为接入商家自运营推广的商家应用或第三方应用订阅 alipay.marketing.activity.delivery.changed（推广计划状态变更消息）。

**注意：**仅完成订阅后才会收到支付宝发送的对应异步通知消息。

验签

商家/服务商可使用支付宝 SDK可根据数据验签指引，使用应用密钥信息验证异步通知消息来源是否为支付宝。

反馈消息接收结果

收到异步通知完成验签后，商家/服务商需返回success表示消息获取成功，支付宝就会停止发送异步通知。如果返回fail或其它值，表示消息获取失败，支付宝会根据投递重试策略重新发送消息到应用网关地址。

**说明：**完成异步通知验签时，如果验签成功返回 success，验签失败返回fail，重新接收异步进行处理。

响应值	描述	是否重试
fail	消息获取失败	重试
success	消息获取成功	不重试

变更推广状态通知

商家/服务商可以监听 alipay.marketing.activity.delivery.changed（推广计划状态变更消息），感知推广计划信息的变更。创建推广的推广计划会进入生效中或者审核中状态，审核中的推广计划在审核之后会通过 alipay.marketing.activity.delivery.changed（推广计划状态变更消息）触达到服务商。

注意：

变更推广计划通知会在推广计划变更存在变更时发出，包括创建、审核、停止、信息变更等操作生效之后发出。

变更推广计划通知仅包含简单的推广计划变更通知信息，更多推广计划信息需通过 alipay.marketing.activity.delivery.query（查询推广计划）获取。

消息示例

ISV_GATEWAY_URL?charset=GBK&biz_content=
{
"out_biz_no":"abscd123341",
"event_time":"12342425435232423",
"delivery_id":"20121231231242353",
"delivery_status":"ACTIVE",
"delivery_error_msg":"商品不合格",
"delivery_booth_code":"PAYMENT_RESULT"
&msg_method=alipay.marketing.activity.delivery.changed&utc_timestamp=1516797622752&version=1.1&sign_type=RSA2&notify_id=d275fec564e62af6bedbcee73f3f05fi5x&app_id=2013121700999429&sign=I+Y/lvqYUEEc10EPdpntRhFIQ==ISV_GATEWAY_URL?charset=GBK&biz_content=
{
"out_biz_no":"abscd123341",
"event_time":"12342425435232423",
"delivery_id":"20121231231242353",
"delivery_status":"ACTIVE",
"delivery_error_msg":"商品不合格",
"delivery_booth_code":"PAYMENT_RESULT"
&msg_method=alipay.marketing.activity.delivery.changed&utc_timestamp=1516797622752&version=1.1&sign_type=RSA2&notify_id=d275fec564e62af6bedbcee73f3f05fi5x&app_id=2013121700999429&sign=I+Y/lvqYUEEc10EPdpntRhFIQ==

接入指南

接口调用时序图#

推广计划状态流转图#

商品卖货前置准备#

创建推广计划#

请求示例#

查询推广计划#

请求示例#

停止推广计划#

请求示例#

消息通知#

订阅消息#

验签#

反馈消息接收结果#

变更推广状态通知#

消息示例#

接口调用时序图

推广计划状态流转图

商品卖货前置准备

创建推广计划

请求示例

查询推广计划

请求示例

停止推广计划

请求示例

消息通知

订阅消息

验签

反馈消息接收结果

变更推广状态通知

消息示例