接入指南
第一步:上传图片资料
第二步:创建门店
接口调用流程

创 建门店
示例代码
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.AntMerchantExpandShopApi;
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 AntMerchantExpandShopApiCreate {
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);
AntMerchantExpandShopApi api = new AntMerchantExpandShopApi();
AntMerchantExpandShopCreateModel data = new AntMerchantExpandShopCreateModel();
List<SettleCardInfo> bizCards = new ArrayList<SettleCardInfo>();
SettleCardInfo bizCards0 = new SettleCardInfo();
bizCards0.setAccountBranchName("招商银行杭州高新支行");
bizCards0.setAccountHolderName("张三");
bizCards0.setAccountInstId("CMB");
bizCards0.setAccountType("DC");
bizCards0.setAccountInstProvince("浙江省");
bizCards0.setUsageType("01");
bizCards0.setAccountNo("6214855710610408");
bizCards0.setBankCode("103290003044");
bizCards0.setAccountInstName("招商银行");
bizCards0.setAccountInstCity("杭州市");
bizCards.add(bizCards0);
data.setBizCards(bizCards);
data.setCertName("支付宝东门小卖铺");
data.setSettleAlipayLogonId("demo@163.com");
data.setShopName("支付宝(西溪路店)");
data.setShopType("01");
data.setLegalName("支小宝");
data.setLicenseAuthLetterImage("营业执照授权函图片id");
data.setScene("PARK");
List<ShopBusinessTime> businessTime = new ArrayList<ShopBusinessTime>();
ShopBusinessTime businessTime0 = new ShopBusinessTime();
businessTime0.setWeekDay(1);
businessTime0.setOpenTime("09:30");
businessTime0.setCloseTime("22:00");
businessTime.add(businessTime0);
data.setBusinessTime(businessTime);
List<ContactInfo> contactInfos = new ArrayList<ContactInfo>();
ContactInfo contactInfos0 = new ContactInfo();
List<String> tag = new ArrayList<String>();
tag.add("06");
contactInfos0.setTag(tag);
contactInfos0.setType("LEGAL_PERSON");
contactInfos0.setPhone("0571-85022088");
contactInfos0.setMobile("13888888888");
contactInfos0.setEmail("user@domain.com");
contactInfos0.setIdCardNo("110000199001011234");
contactInfos0.setName("张三");
contactInfos.add(contactInfos0);
data.setContactInfos(contactInfos);
data.setBrandId("20181026000001");
data.setContactPhone("010-62286228");
data.setStoreId("NO0001");
data.setMemo("备注");
AddressInfo businessAddress = new AddressInfo();
businessAddress.setDistrictCode("371002");
businessAddress.setType("BUSINESS_ADDRESS");
businessAddress.setCityCode("371000");
businessAddress.setAddress("万塘路18号黄龙时代广场B座");
businessAddress.setLatitude("60.270001");
businessAddress.setProvinceCode("370000");
businessAddress.setLongitude("120.760001");
businessAddress.setPoiid("B0FFIVU189");
data.setBusinessAddress(businessAddress);
List<ShopExtInfo> extInfos = new ArrayList<ShopExtInfo>();
ShopExtInfo extInfos0 = new ShopExtInfo();
extInfos0.setKeyName("SHOP_SLOGAN");
extInfos0.setValue("我是标语");
extInfos.add(extInfos0);
data.setExtInfos(extInfos);
List<String> outDoorImages = new ArrayList<String>();
outDoorImages.add("c6c0c7a1-b9d5-4e5d-b9d4-9eed39f00e65.jpg");
data.setOutDoorImages(outDoorImages);
data.setShopCategory("B0001");
data.setCertType("201");
data.setContactMobile("13901390139");
data.setLegalCertNo("100100198811110001");
data.setCertNo("9133010608210550XR");
List<IndustryQualificationInfo> qualifications = new ArrayList<IndustryQualificationInfo>();
IndustryQualificationInfo qualifications0 = new IndustryQualificationInfo();
qualifications0.setIndustryQualificationImage("c6c0c7a1-b9d5-4e5d-b9d4-9eed39f00e65.jpg");
qualifications0.setIndustryQualificationType("301");
qualifications.add(qualifications0);
data.setQualifications(qualifications);
data.setCertImage("营业执照图片id");
data.setIpRoleId("2088301155943087");
try {
AntMerchantExpandShopCreateResponseModel response = api.create(data);
} catch (ApiException e) {
AntMerchantExpandShopCreateDefaultResponse errorObject = (AntMerchantExpandShopCreateDefaultResponse) e.getErrorObject();
System.out.println("调用失败:" + errorObject);
}
}
}
重要入参说明
https://ditu.amap.com/search?id=B0FFIU3QL4&city=510107&geoobj=104.055382%7C30.538725%7C104.070832%7C30.546159&query_type=IDQ&query=%E8%9A%82%E8%9A%81C%E7%A9%BA%E9%97%B4&zoom=17
,其中 id 属性值 B0FFIU3QL4
即为 poiid 值;申请单查询(可选)
示例代码
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.AntMerchantExpandOrderApi;
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 AntMerchantExpandOrderApiQuery {
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);
AntMerchantExpandOrderApi api = new AntMerchantExpandOrderApi();
String orderId = "2017112200502000000004754299";
try {
AntMerchantExpandOrderQueryResponseModel response = api.query(orderId);
} catch (ApiException e) {
AntMerchantExpandOrderQueryDefaultResponse errorObject = (AntMerchantExpandOrderQueryDefaultResponse) e.getErrorObject();
System.out.println("调用失败:" + errorObject);
}
}
}
第三步:门店管理

店铺修改
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.AntMerchantExpandShopApi;
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 AntMerchantExpandShopApiModify {
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);
AntMerchantExpandShopApi api = new AntMerchantExpandShopApi();
AntMerchantExpandShopModifyModel data = new AntMerchantExpandShopModifyModel();
List<SettleCardInfo> bizCards = new ArrayList<SettleCardInfo>();
SettleCardInfo bizCards0 = new SettleCardInfo();
bizCards0.setAccountBranchName("招商银行杭州高新支行");
bizCards0.setAccountHolderName("张三");
bizCards0.setAccountInstId("CMB");
bizCards0.setAccountType("DC");
bizCards0.setAccountInstProvince("浙江省");
bizCards0.setUsageType("01");
bizCards0.setAccountNo("6214855710610408");
bizCards0.setBankCode("103290003044");
bizCards0.setAccountInstName("招商银行");
bizCards0.setAccountInstCity("杭州市");
bizCards.add(bizCards0);
data.setBizCards(bizCards);
data.setCertName("支付宝东门小卖铺");
data.setSettleAlipayLogonId("demo@163.com");
data.setShopName("支付宝东门小卖铺");
data.setLegalName("支小宝");
data.setLicenseAuthLetterImage("c6c0c7a1-b9d5-4e5d-b9d4-9eed39f00e65.jpg");
List<ShopBusinessTime> businessTime = new ArrayList<ShopBusinessTime>();
ShopBusinessTime businessTime0 = new ShopBusinessTime();
businessTime0.setWeekDay(1);
businessTime0.setOpenTime("09:30");
businessTime0.setCloseTime("22:00");
businessTime.add(businessTime0);
data.setBusinessTime(businessTime);
data.setScene("PARK");
ContactInfo contactInfos = new ContactInfo();
List<String> tag = new ArrayList<String>();
tag.add("06");
contactInfos.setTag(tag);
contactInfos.setType("LEGAL_PERSON");
contactInfos.setPhone("0571-85022088");
contactInfos.setMobile("13888888888");
contactInfos.setEmail("user@domain.com");
contactInfos.setIdCardNo("110000199001011234");
contactInfos.setName("张三");
data.setContactInfos(contactInfos);
data.setBrandId("20181026000001");
data.setContactPhone("010-62286228");
data.setStoreId("NO0001");
data.setMemo("备注");
AddressInfo businessAddress = new AddressInfo();
businessAddress.setDistrictCode("371002");
businessAddress.setType("BUSINESS_ADDRESS");
businessAddress.setCityCode("371000");
businessAddress.setAddress("万塘路18号黄龙时代广场B座");
businessAddress.setLatitude("60.270001");
businessAddress.setProvinceCode("370000");
businessAddress.setLongitude("120.760001");
businessAddress.setPoiid("B0FFIVU189");
data.setBusinessAddress(businessAddress);
List<ShopExtInfo> extInfos = new ArrayList<ShopExtInfo>();
ShopExtInfo extInfos0 = new ShopExtInfo();
extInfos0.setKeyName("SHOP_SLOGAN");
extInfos0.setValue("我是标语");
extInfos.add(extInfos0);
data.setExtInfos(extInfos);
List<String> outDoorImages = new ArrayList<String>();
outDoorImages.add("c6c0c7a1-b9d5-4e5d-b9d4-9eed39f00e65.jpg");
data.setOutDoorImages(outDoorImages);
data.setShopCategory("B0001");
data.setCertType("201");
data.setContactMobile("13901390139");
data.setShopId("2018011900502000000005124744");
data.setLegalCertNo("100100198811110001");
data.setCertNo("9133010608210550XR");
List<IndustryQualificationInfo> qualifications = new ArrayList<IndustryQualificationInfo>();
IndustryQualificationInfo qualifications0 = new IndustryQualificationInfo();
qualifications0.setIndustryQualificationImage("c6c0c7a1-b9d5-4e5d-b9d4-9eed39f00e65.jpg");
qualifications0.setIndustryQualificationType("B0099");
qualifications.add(qualifications0);
data.setQualifications(qualifications);
data.setCertImage("c6c0c7a1-b9d5-4e5d-b9d4-9eed39f00e65.jpg");
data.setIpRoleId("2088301155943087");
try {
AntMerchantExpandShopModifyResponseModel response = api.modify(data);
} catch (ApiException e) {
AntMerchantExpandShopModifyDefaultResponse errorObject = (AntMerchantExpandShopModifyDefaultResponse) e.getErrorObject();
System.out.println("调用失败:" + errorObject);
}
}
}
查询门店详情
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.AntMerchantExpandShopApi;
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 AntMerchantExpandShopApiQuery {
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);
AntMerchantExpandShopApi api = new AntMerchantExpandShopApi();
String shopId = "2018011900502000000005124744";
String storeId = "NO0001";
String ipRoleId = "2088301155943087";
String addressVersion = "2022Q2";
String needRecommend = "0";
try {
AntMerchantExpandShopQueryResponseModel response = api.query(shopId, storeId, ipRoleId, addressVersion, needRecommend);
} catch (ApiException e) {
AntMerchantExpandShopQueryDefaultResponse errorObject = (AntMerchantExpandShopQueryDefaultResponse) e.getErrorObject();
System.out.println("调用失败:" + errorObject);
}
}
}
查询门店列表
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.AntMerchantExpandShopPageApi;
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 AntMerchantExpandShopPageApiQuery {
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);
AntMerchantExpandShopPageApi api = new AntMerchantExpandShopPageApi();
String ipRoleId = "2088301155943087";
Integer pageNum = 1;
Integer pageSize = 10;
String addressVersion = "2022Q2";
try {
AntMerchantExpandShopPageQueryResponseModel response = api.query(ipRoleId, pageNum, pageSize, addressVersion);
} catch (ApiException e) {
AntMerchantExpandShopPageQueryDefaultResponse errorObject = (AntMerchantExpandShopPageQueryDefaultResponse) e.getErrorObject();
System.out.println("调用失败:" + errorObject);
}
}
}
关闭店铺
示例代码
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.AntMerchantExpandShopApi;
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 AntMerchantExpandShopApiClose {
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);
AntMerchantExpandShopApi api = new AntMerchantExpandShopApi();
AntMerchantExpandShopCloseModel data = new AntMerchantExpandShopCloseModel();
data.setShopId("2018011900502000000005124744");
data.setStoreId("NO0001");
data.setIpRoleId("2088301155943087");
try {
Object response = api.close(data);
} catch (ApiException e) {
AntMerchantExpandShopCloseDefaultResponse errorObject = (AntMerchantExpandShopCloseDefaultResponse) e.getErrorObject();
System.out.println("调用失败:" + errorObject);
}
}
}
审核消息通知
审核通过消息示例
ISV_GATEWAY_URL?charset=GBK&biz_content=
{
"shop_id":"店铺id","shop_name":"庆丰包子铺中关村店","order_id":"2018011900502000000005124744","store_id":"NO0001"
}
&msg_method=ant.merchant.expand.shop.save.passed&utc_timestamp=1516797622752&version=1.1&sign_type=RSA2¬ify_id=d275fec564e62af6bedbcee73f3f05fi5x&app_id=2013121700999429&sign=I+Y/lvqYUEEc10EPdpntRhFIQ==
审核失败消息示例
ISV_GATEWAY_URL?charset=GBK&biz_content=
{
"order_id":"2018011900502000000005124744","reason":"拒绝原因","shop_name":"庆丰包子铺中关村店"
}
&msg_method=ant.merchant.expand.shop.save.rejected&utc_timestamp=1516797622752&version=1.1&sign_type=RSA2¬ify_id=d275fec564e62af6bedbcee73f3f05fi5x&app_id=2013121700999429&sign=I+Y/lvqYUEEc10EPdpntRhFIQ==