创建门店信息(alipay.offline.market.shop.create)java版

准入条件: 

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");
        
上一篇:Go实战之常用命令行工具(下)


下一篇:『干货』阿里研究员徐盈辉:在线AI技术在搜索与推荐场景的应用