门店管理

专题头条

  • 今日:1
  • 主题:0
  • 总帖:510
版主: 我是个导演
简介:自用型、第三方等应用的创建使用说明。
创建门店信息(alipay.offline.mark...
准入条件: 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"); //支持英文字母和数字,由开发者自行定义(不允许重复),在门店notify消息中也会带有该参数,以此标明本次notify消息是对哪个请求的回应。 model.setRequestId("201708283235324534"); //表示以系统集成商的身份开店,开放平台现在统一传入ISV。 model.setOpRole("ISV"); //店铺接口业务版本号,新接入的ISV,请统一传入2.0。 model.setBizVersion("2.0"); request.setBizModel(model); AlipayOfflineMarketShopCreateResponse response = alipayClient.execute(request); System.out.println(response.getBody()); if(response.isSuccess()){ System.out.println("调用成功"); } else { System.out.println("调用失败"); } } } 参数说明: 1).category_id:类目id,到商家准入条件中的【口碑类目】和【非口碑类目】中查看,或者到商户入驻要求下载 .xlsx格式全行业类目表及准入要求,也可以通过门店类目配置查询接口获取(鉴于此id会跟随业务变动,推荐使用接口方法动态获取)。 打开类目表,选择自己所需类目id填写 2).经纬度获取:点击【高德地图】,将你填写的Address(门店详细地址)放入地图中进行搜索获取 3).省市区编码获取,打开请求参数列表,找到省市区的参数,如图所示,点击下载 4).operate_notify_url:当商户的门店审核状态发生变化时,会向该地址推送消息。 5).当支付宝或商家修改了开发者创建的门店,修改信息会通过应用网关通知给开发者; 返回信息: {"alipay_offline_market_shop_create_response":{"code":"10000","msg":"Success","audit_status":"AUDITING","apply_id":"2017090600107000000074838641"},"sign":"Aom3hw38qHTKfQUcnhkzN0TL7vYvQCVFk7gVfYz4VTabQoNtYU4hJZ9AUvSlYo1te4lNedkholMDk1uRgx/FEcLn6UlIceHyIroeh2T2jjFozTf/TxyJF10mpFiNyTqNKu+qUr/mhZrlWPDd9d+sYWsknTFVLVTSSRRds6y8eD1U+6t5eR3OwU0Q0sGtesQz+jyzL9M2ipE2WbgCcrEP3syeRIgVL2vV1IxTfu6GGGchZKwR/EeA75JryOknUsT2ZUICv6Emt6S4vf8xpQiYzZSAoWFsPhoceaP0uPiLwIdPIAdt3SzoKWWfu3P+ARpK6ZOtcjp//OI9bCh1SBs5IQ=="} 注: 商家可在未签约/已签约当面付产品的情况给开发者授权,由开发者帮助商家创建门店。 开发者只是发起方,开发者代商家做任何操作都需要传入商家授权的token。 如门店需要做支付,收款方也须为商家,不允许开发者收款再分给商家的形式。
颠覆白的黑
阅读 287
说明: 该接口用于会员卡更新信息,官方接口文档【会员卡更新】 开卡接口参考该贴:https://openclub.alipay.com/read.php?tid=1628&fid=71 ...
颠覆白的黑
阅读 1298
调用这个接口前需要先创建卡券模板,参考该贴:https://openclub.alipay.com/read.php?tid=2135&fid=8 官方接口文档:https://docs.open.a...
颠覆白的黑
阅读 1410
官方接口文档:https://docs.open.alipay.com/199/105250/ 发放卡券接口参考该贴:https://openclub.alipay.com/read.php?tid=2193...
煜雨飞飞
阅读 185
测试环境要求: 是否支持沙箱:支持 文档地址:点击查看 一、功能场景说明:       商户可以根据自己的营销需求创建现金红包活动,设计大转盘游戏、刮刮卡、成为会员即送现金等丰富多彩的玩法。商户不但可以控制活动预...
我就是个演员
阅读 1048
alipay_store_id,也就是支付宝门店shop_id,必传。store_id根据商户实际需求情况选择是否传
颠覆白的黑
阅读 653
说明: 该接口主要用于创建之后的会员卡的模板修改,官方接口文档请点击【会员卡模板修改】 创建模板接口请参考我的这个帖子:https://openclub.alipay.com/read.php?ti...
颠覆白的黑
阅读 1020
说明及作用: 官网接口文档看一下:https://docs.open.alipay.com/213/105272/ 在口碑店铺页中,增加商家自定义区域。可由商家通过接口自定义上传带...
煜雨飞飞
阅读 363
说明: 本帖是测试营销活动的创建营销活动之创建集点卡活动,首先要创建口碑门店 测试环境:JAVA1.5+,eclipse 是否支持沙箱环境:支持 接口文档:查看 sdk下载:下载 沙箱J...
颠覆白的黑
阅读 350
说明: 该接口是通过API接口进行删除会员卡的操作流程,官方接口文档【会员卡删卡】 开卡接口请参考该贴:https://openclub.alipay.com/read.ph...
我是个导演
阅读 841
错误说明   这个错误出现在我们调用alipay.marketing.card.activateurl.apply(获取会员卡领卡投放链接)接口   访问投放链接进行领卡出现的错误(如下图)...
颠覆白的黑
阅读 495
说明: 该接口一般结合口碑开店接口使用,官方文档:https://docs.open.alipay.com/common/105258 以及结合会员卡中的上传背景图片等联合使用 调...
我是个导演
阅读 4466
为提升ISV创建测试门店的效率,口碑开放平台于2017年12月15日上线快速创建口碑测试门店产品,欢迎口碑ISV使用,并请特别注意以下几点: 1.口碑测试门店仅用于ISV测试,默认对普通消费者隐藏,如...
颠覆白的黑
阅读 356
说明: 该接口是开发者帮助线下商家修改广告内容,如修改的是线上的广告内容,需要先将线上广告内容下架,再修改,修改后操作上架,才能在支付宝钱包APP看到修改后的广告内容。运营位类型可以选择图片或H5...
别、
阅读 132
说明 该接口适用于已经开通口碑门店,用于在口碑门店详情页内展示广告页 一.创建广告 1.调用alipay.marketing.cdp.advertise.create接口创建广告 示例代码 Alipa...
煜雨飞飞
阅读 169
说明: 本帖是介绍如何领取营销活动创建的口令送活动的优惠券,本帖是正式环境测试,仅供参考!!  1.创建营销活动口令送活动:如何创建营销活动口令送活动 2.在口碑商家中心(https://e...
战狼
阅读 349
官方文档 说明: 本帖是利用支付宝正式环境测试账号测试口碑店铺数据接口,请求中根据文档传入了必传参数,大家可以配置自己的环境,根据自己的需求严格按照文档要求添加相关的可选参数,此demo仅供参考 ...
煜雨飞飞
阅读 249
说明: 本帖是测试活动详情查询,只能查询到通过接口创建的营销活动的信息,首先要创建口碑门店 测试环境:JAVA1.5+,eclipse 是否支持沙箱环境:支持 接口文档:查看 sdk下载:下载 ...
煜雨飞飞
阅读 228
说明: 本帖是测试口碑营销活动列表查询,只能查询到通过接口创建的营销活动,首先要创建口碑门店 测试环境:JAVA1.5+,eclipse 是否支持沙箱环境:支持 接口文档:查看 sdk下载...
煜雨飞飞
阅读 338
说明: 本帖是测试营销活动创建口令送活动,首先要创建口碑门店,本帖是沙箱环境测试,仅供参考!! 是否支持沙箱环境:支持 接口文档:查看 sdk下载:下载 沙箱Java版营销活动demo:下...
alipay
阅读 257
商业综合体解决方案 商圈综合体行业接入指南(开发者必读):https://doc.open.alipay.com/docs/doc.htm?docType=1&articleId=106950#s4 ...
热门帖子
最新提问

返回顶部