准入条件:
1.经营范围:证照内的经营范围需与商户实际经营内容、口碑平台展示的门店类目/经营内容相符。
2.证照主体:开店提供的证照主体需与支付宝签约当面付的认证主体保持一致;
3.执照提交要求:证照需彩色版;真实、完整、清晰无水印、无PS(扫描或拍照均可);复印件需加盖红色公章。
4.门店名称:口碑平台开放的门店名称需与商户门头照片展示的店名一致;
5.门店地址:需与营业执照地址保持一致 6.类目:需与商户实际经营内容、证照内经营范围相符
7.门头+内景:
a、照片需真实拍摄;清晰、无水印、无反向、无PS
b、门头照片需含有门店名称
c、内景照片内容需要与店铺经营内容一致;
对接须知:
1、正式环境需
创建应用配置密钥 提交审核,签约生效后方可正常使用;签约请联系 商户客服 进行咨询 沙箱环境测试注意点:
a、在沙箱调通接口后,必须在线上进行测试与验收,所有返回码及业务逻辑以线上为准;
b、业务流水批量查询接口(alipay.offline.market.applyorder.batchquery),请求时带上apply_ids参数;
c、可使用沙箱环境-沙箱工具-口碑门店账号&二维码转换工具,通过沙箱钱包的扫一扫功能,进入商家详情页,查看门店效果;
d、沙箱测试创建门店,推荐使用北京、上海、杭州三个城市在
国家统计局中有的区域进行测试,如遇到区域不存在的情况,请更换区域调试;
2、
下载服务端SDK接口示例
1、
alipay.offline.material.image.upload (上传门店照片和视频接口)package com.alipay.demo;
import com.alipay.api.AlipayApiException;
import com.alipay.api.AlipayClient;
import com.alipay.api.DefaultAlipayClient;
import com.alipay.api.FileItem;
import com.alipay.api.request.AlipayOfflineMaterialImageUploadRequest;
import com.alipay.api.response.AlipayOfflineMaterialImageUploadResponse;
import com.alipay.config.AlipayConfig;
/**
* alipay.offline.material.image.upload (上传门店照片和视频接口)
* @author wb-wly251833
* 接口开发文档:https://doc.open.alipay.com/doc2/apiDetail.htm?docType=4&apiId=859
*/
public class AlipayOfflineMaterialImageUpload {
public static void main(String[] args) throws AlipayApiException {
AlipayClient alipayClient = new DefaultAlipayClient(AlipayConfig.gatewayUrl, AlipayConfig.app_id, AlipayConfig.merchant_private_key, AlipayConfig.format, AlipayConfig.charset, AlipayConfig.alipay_public_key, AlipayConfig.sign_type);
AlipayOfflineMaterialImageUploadRequest request = new AlipayOfflineMaterialImageUploadRequest();
//图片/视频格式 jpg或mp4
request.setImageType("jpg");
//图片/视频名称
request.setImageName("湘菜馆");
//图片/视频二进制内容,图片/视频大小不能超过5M
FileItem ImageContent = new FileItem("D:/img/002.jpg");
request.setImageContent(ImageContent);
//用于显示指定图片/视频所属的partnerId(支付宝内部使用,外部商户无需填写此字段)
request.setImagePid("2088102180198585");
AlipayOfflineMaterialImageUploadResponse response = alipayClient.execute(request);
if(response.isSuccess()){
System.out.println("调用成功");
System.out.println(response.getBody());
} else {
System.out.println("调用失败");
}
}
}
返回信息:
{"alipay_offline_material_image_upload_response":{"code":"10000","msg":"Success","image_id":"hgMyYu6MQ76moXqouw6NzAAAACMAAQED","image_url":"https:\\/\\/oalipay-dl-django.alicdn.com\\/rest\\/1.0\\/image?fileIds=hgMyYu6MQ76moXqouw6NzAAAACMAAQED&zoom=original"},"sign":"UIWKC/MS5F/DUxmihDJvgY5fW3FNT2raYt6vRDb7fgUwmTOAhhbVcBAJW4NrqmBS2EzXBzu2BkCO7AqeOTkdbimBmB9u4+qSTFxKmXz7JGXfYNEfUsGT6a5j527fKREnKaQ+qBsI8eNtYjwpZ49EocFVLd2ERpbIPFFmSdbKpODjVaPZKcf3Z0iR6stRMjRH1yUAyXE4nQCTel9mP4tWjQVue/V6f/JyBhfXnRnmVvR0A7KYb1jq2a3YModfFfi5QXeIsXceMczMagWbE13v8Zbp6Y58GhoLr7dR+Qem+X0maiSyaDEMNSChZx10KCyguMKsTq02R5FtUOcOXjgAsQ=="}
alipay.offline.market.shop.create(创建门店信息) package com.alipay.demo;
import com.alipay.api.AlipayApiException;
import com.alipay.api.AlipayClient;
import com.alipay.api.DefaultAlipayClient;
import com.alipay.api.domain.AlipayOfflineMarketShopCreateModel;
import com.alipay.api.request.AlipayOfflineMarketShopCreateRequest;
import com.alipay.api.response.AlipayOfflineMarketShopCreateResponse;
import com.alipay.config.AlipayConfig;
/**
* alipay.offline.market.shop.create(创建门店信息)
* @author wb-wly251833
* 参考文档:https://docs.open.alipay.com/api_3/alipay.offline.market.shop.create
*/
public class alipayOfflineMarketShopCreate {
public static void main(String[] args) throws AlipayApiException {
AlipayClient alipayClient = new DefaultAlipayClient(AlipayConfig.gatewayUrl, AlipayConfig.app_id, AlipayConfig.merchant_private_key, AlipayConfig.format, AlipayConfig.charset, AlipayConfig.alipay_public_key, AlipayConfig.sign_type);
AlipayOfflineMarketShopCreateRequest request = new AlipayOfflineMarketShopCreateRequest();
AlipayOfflineMarketShopCreateModel model = new AlipayOfflineMarketShopCreateModel();
//外部门店编号;最长32位字符,该编号将作为收单接口的入参, 请开发者自行确保其唯一性。
model.setStoreId("2017090511533129318");
//类目id,请参考商户入驻要求。
model.setCategoryId("2015050700000011");
//主门店名
model.setMainShopName("湘菜院");
//品牌LOGO; 图片ID,不填写则默认为门店首图main_image。
model.setBrandLogo("1T8Pp00AT7eo9NoAJkMR3AAAACMAAQEC");
//主门店名
model.setBranchShopName("西溪路湘菜店");
//省份编码
model.setProvinceCode("330000");
//城市编码
model.setCityCode("330100");
//区县编码
model.setDistrictCode("330106");
//门店详细地址,地址字符长度在4-50个字符,注:不含省市区。门店详细地址按规范格式填写地址,
model.setAddress("西溪路553号");//120.099842,30.257693
//纬度;最长15位字符(包括小数点), 注:高德坐标系。经纬度是门店搜索和活动推荐的重要参数,录入时请确保经纬度参数准确。高德经纬度查询:http://lbs.amap.com/console/show/picker
Long longitude = new Long((long) 120.099842);
model.setLongitude(longitude);
//纬度;最长15位字符(包括小数点),
model.setLatitude("30.257693");
//门店电话号码;支持座机和手机,只支持数字和+-号,在客户端对用户展现, 支持多个电话, 以英文逗号分隔。
model.setContactNumber("13612344321,021-12336754");
model.setNotifyMobile("13867498729");
//门店首图,非常重要,推荐尺寸2000*1500。
model.setMainImage("hgMyYu6MQ76moXqouw6NzAAAACMAAQED");
//门店审核时需要的图片;至少包含一张门头照片,两张内景照片,必须反映真实的门店情况,审核才能够通过;多个图片之间以英文逗号分隔。
model.setAuditImages("1T8Pp00AT7eo9NoAJkMR3AAAACMAAQEC,4Q8Pp00AT7eo9NoAJkMR3AAAACMAAUYT");
//营业时间
model.setBusinessTime("周一-周五 09:00-20:00,周六-周日 10:00-22:00");
//ISV返佣id,门店创建、或者门店交易的返佣将通过此账号反给ISV,如果有口碑签订了返佣协议,则该字段作为返佣数据提取的依据。此字段必须是个合法uid,2088开头的16位支付宝会员账号,如果传入错误将无法创建门店。
model.setIsvUid("2088001969784501");
//门店营业执照图片
model.setLicence("1T8Pp00AT7eo9NoAJkMR3AAAACMAAQEC");
//门店营业执照编号,只支持输入中文,英文和数字,营业执照信息与is_operating_online至少填一项。
model.setLicenceCode("H001232");
//门店营业执照名称。
model.setLicenceName("来伊份上海分公司");
//许可证,各行业所需的证照资质参见商户入驻要求;该字段只能上传一张许可证,
model.setBusinessCertificate("1T8Pp00AT7eo9NoAJkMR3AAAACMAAQEC");