简介

完成接入准备后，服务商可根据本文指引快速代商家报名活动，将间连 M3 商家升级为 M4 商家进行代报名。

说明：间连商家 需完成 补全商家信息 及 绑定商家支付宝账号。

接口调用流程图

上传资质图片

服务商可调用 alipay.open.sp.image.upload（图片上传接口）上传商家资质图片内容，获取对应 image_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.AlipayOpenSpImageApi;
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 AlipayOpenSpImageApiUpload {

    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);
        AlipayOpenSpImageApi api = new AlipayOpenSpImageApi();
        File imageContent = new File("文件路径");
        try {
            AlipayOpenSpImageUploadResponseModel response = api.upload(imageContent);
        } catch (ApiException e) {
            AlipayOpenSpImageUploadDefaultResponse errorObject = (AlipayOpenSpImageUploadDefaultResponse) e.getErrorObject();
            System.out.println("调用失败:" + errorObject);
        }
    }
}

重要入参说明

image_content：图片二进制字节流，最大为 10M。可根据示例代码使用支付宝提供的工具类传入图片本地路径进行转换。

报名活动

服务商可调用 alipay.open.sp.blueseaactivity.create（新蓝海活动报名申请接口）代商家报名活动。

示例代码

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.AlipayOpenSpBlueseaactivityApi;
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 AlipayOpenSpBlueseaactivityApiCreate {

    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);
        AlipayOpenSpBlueseaactivityApi api = new AlipayOpenSpBlueseaactivityApi();
        AlipayOpenSpBlueseaactivityCreateModel data = new AlipayOpenSpBlueseaactivityCreateModel();
        data.setIndoorPic("A*7j1pTrCpV8EAAAAAAAAAAAAAAQAAAA");
        data.setFoodHealthLic("A*7j1pTrCpV8EAAAAAAAAAAAAAAQAAAA");
        data.setShopEntrancePic("A*7j1pTrCpV8EAAAAAAAAAAAAAAQAAAA");
        data.setFoodBusinessLic("A*7j1pTrCpV8EAAAAAAAAAAAAAAQAAAA");
        data.setAddress("万塘路18号黄龙时代广场B座");
        data.setBusinessLic("A*7j1pTrCpV8EAAAAAAAAAAAAAAQAAAA");
        data.setFoodCirculateLic("A*7j1pTrCpV8EAAAAAAAAAAAAAAQAAAA");
        data.setProvinceCode("310000");
        data.setTobaccoLic("A*7j1pTrCpV8EAAAAAAAAAAAAAAQAAAA");
        data.setDistrictCode("310006");
        data.setMerchantLogon("13200132000");
        data.setCityCode("310001");
        data.setBizScene("BLUE_SEA_FOOD_APPLY");
        data.setFoodServiceLic("A*7j1pTrCpV8EAAAAAAAAAAAAAAQAAAA");
        data.setFoodProductionLic("A*7j1pTrCpV8EAAAAAAAAAAAAAAQAAAA");
        data.setSubMerchantId("2088100010001000");
        try {
            AlipayOpenSpBlueseaactivityCreateResponseModel response = api.create(data);
        } catch (ApiException e) {
            AlipayOpenSpBlueseaactivityCreateDefaultResponse errorObject = (AlipayOpenSpBlueseaactivityCreateDefaultResponse) e.getErrorObject();
            System.out.println("调用失败:" + errorObject);
        }
    }
}

重要参数说明

biz_scene：必填，String，蓝海活动的场景。包括如下场景：

BLUE_SEA_FOOD_APPLY：直连餐饮。

BLUE_SEA_FMCG_APPLY：直连快消。

BLUE_SEA_FOOD_INDIRECT_APPLY：间连餐饮。

BLUE_SEA_FMCG_INDIRECT_APPLY：间连快消。

merchant_logon：参与蓝海活动的商户支付宝账号，仅当 biz_scene 为直连蓝海活动场景（BLUE_SEA_FOOD_APPLY/BLUE_SEA_FMCG_APPLY）时必填，间连场景可空。

sub_merchant_id：参与蓝海活动的间连商户账号，仅当 biz_scene 为间连蓝海活动场景（BLUE_SEA_FOOD_INDIRECT_APPLY/BLUE_SEA_FMCG_INDIRECT_APPLY）时必填，直连场景可空。

如下资质图片内容请传入上文 上传资质图片 获取的 image_id，要求证件文本信息清晰可见。具体所需资质内容参见返佣政策代报名资质要求。

business_lic：营业执照。

food_service_lic：餐饮服务许可证。

food_health_lic：食品卫生许可证。

food_business_lic：食品经营许可证。

food_circulate_lic：食品流通许可证。

food_production_lic：食品生产许可证。

tobacco_lic：烟草专卖零售许可证。

shop_entrance_pic：门头照，店铺外观照片。

indoor_pic：门头照，内景照片。

如下省份、城市编码参见地区码。

province_code：省份编码。

city_code：城市编码。

district_code：区县编码。

address：详细地址。

更多参数及响应详情参见 alipay.open.sp.blueseaactivity.create（新蓝海活动报名申请接口）。

申请单结果通知

服务商代商家提交活动报名申请后需监听 alipay.open.sp.blueseaactivity.changed（新蓝海活动申请单结果通知接口），支付宝将调用该消息接口向服务商 应用网关 地址。更多此类通知详情参见 From 蚂蚁消息服务。

**注意：**本消息通知需在应用详情页 消息服务 中手动订阅 alipay.open.sp.blueseaactivity.changed 接口，订阅流程参见订阅消息接口。

消息示例

ISV_GATEWAY_URL?charset=GBK&biz_content=
{
"order_id":"5881","status":"FAIL","memo":"资质不全，请重新提交"
}
&msg_method=alipay.open.sp.blueseaactivity.changed&utc_timestamp=1516797622752&version=1.1&sign_type=RSA2&notify_id=d275fec564e62af6bedbcee73f3f05fi5x&app_id=2013121700999429&sign=I+Y/lvqYUEEc10EPdpntRhFIQ==

消息参数说明

order_id：必填，String，申请单 id 。

status：必填，Stirng，申请单状态。具体状态如下：

FAIL：报名失败。

PASS：报名成功。

memo：可选，String，审核备注。仅当申请单状态 status 为 FAIL 时返回该值。

更多参数详情参见 alipay.open.sp.blueseaactivity.changed（新蓝海活动申请单结果通知接口）。

返回结果

由于消息存在重试机制，同一笔消息（相同 notify_id）可能多次发送（网络原因、商户服务器原因、或者商户接受处理成功但并未按要求打印 success 字符串等）。

服务商收到消息通知后需立即返回 success 七个字符。

修改报名申请单

当活动报名申请单返回报名失败后，服务商可调用 alipay.open.sp.blueseaactivity.modify（新蓝海活动报名申请单修改接口）根据上文 申请单结果通知 返回原因修改申请单信息，重新报名活动。

示例代码

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.AlipayOpenSpBlueseaactivityApi;
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 AlipayOpenSpBlueseaactivityApiModify {

    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);
        AlipayOpenSpBlueseaactivityApi api = new AlipayOpenSpBlueseaactivityApi();
        AlipayOpenSpBlueseaactivityModifyModel data = new AlipayOpenSpBlueseaactivityModifyModel();
        data.setIndoorPic("A*7j1pTrCpV8EAAAAAAAAAAAAAAQAAAA");
        data.setFoodHealthLic("A*7j1pTrCpV8EAAAAAAAAAAAAAAQAAAA");
        data.setShopEntrancePic("A*7j1pTrCpV8EAAAAAAAAAAAAAAQAAAA");
        data.setFoodBusinessLic("A*7j1pTrCpV8EAAAAAAAAAAAAAAQAAAA");
        data.setAddress("万塘路18号黄龙时代广场B座");
        data.setBusinessLic("A*7j1pTrCpV8EAAAAAAAAAAAAAAQAAAA");
        data.setFoodCirculateLic("A*7j1pTrCpV8EAAAAAAAAAAAAAAQAAAA");
        data.setProvinceCode("310000");
        data.setTobaccoLic("A*7j1pTrCpV8EAAAAAAAAAAAAAAQAAAA");
        data.setDistrictCode("310006");
        data.setOrderId("0581");
        data.setCityCode("310001");
        data.setFoodServiceLic("A*7j1pTrCpV8EAAAAAAAAAAAAAAQAAAA");
        data.setFoodProductionLic("A*7j1pTrCpV8EAAAAAAAAAAAAAAQAAAA");
        try {
            Object response = api.modify(data);
        } catch (ApiException e) {
            AlipayOpenSpBlueseaactivityModifyDefaultResponse errorObject = (AlipayOpenSpBlueseaactivityModifyDefaultResponse) e.getErrorObject();
            System.out.println("调用失败:" + errorObject);
        }
    }
}

入参说明参见上文 报名活动，修改申请单信息后需监听申请单状态，详见上文 申请单结果通知。

查询申请单详情

服务商可调用 alipay.open.sp.blueseaactivity.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.AlipayOpenSpBlueseaactivityApi;
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 AlipayOpenSpBlueseaactivityApiQuery {

    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);
        AlipayOpenSpBlueseaactivityApi api = new AlipayOpenSpBlueseaactivityApi();
        String orderId = "5881";
        try {
            AlipayOpenSpBlueseaactivityQueryResponseModel response = api.query(orderId);
        } catch (ApiException e) {
            AlipayOpenSpBlueseaactivityQueryDefaultResponse errorObject = (AlipayOpenSpBlueseaactivityQueryDefaultResponse) e.getErrorObject();
            System.out.println("调用失败:" + errorObject);
        }
    }
}

更多参数详情参见 alipay.open.sp.blueseaactivity.query（新蓝海活动申请单详情查询接口）。

代商家报名返佣政策

简介#

接口调用流程图#

上传资质图片#

示例代码#

重要入参说明#

报名活动#

示例代码#

重要参数说明#

申请单结果通知#

消息示例#

消息参数说明#

返回结果#

修改报名申请单#

示例代码#

查询申请单详情#

示例代码#

简介

接口调用流程图

上传资质图片

示例代码

重要入参说明

报名活动

示例代码

重要参数说明

申请单结果通知

消息示例

消息参数说明

返回结果

修改报名申请单

示例代码

查询申请单详情

示例代码