準入條件:
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");