准入条件:
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=="}
2、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");