修改门店信息

开发环境

http://dev-cn.your-api-server.com

POST

/v3/alipay/offline/market/shop/modify

alipay.offline.market.shop

系统商需要通过该接口在口碑平台帮助商户修改门店信息，所有的选项都为非必填项，需要修改什么信息就传入什么参数，不传入的参数，则保持不变。修改门店名、品牌名、品牌logo、首图、门店图片、营业执照、营业执照编号、营业执照名称、经营许可证、经营许可证有效期、门店授权函、是否在其它平台开店、在其它平台开店照片，会重新触发风控审核，修改其他字段不会触发风控审核。

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'http://dev-cn.your-api-server.com/v3/alipay/offline/market/shop/modify' \
--header 'Content-Type: application/json' \
--data-raw '{
    "address": "万塘路18号黄龙时代广场",
    "audit_images": "02hkCZKaRgmLyirx4If6nAAAACMAAQED",
    "auth_letter": "AM-uJRh2SRKz9N0r9zW4wQAAACMAAQEC",
    "avg_price": "56.73",
    "biz_version": "2.0",
    "box": "T",
    "branch_shop_name": "万塘路店",
    "brand_logo": "4G8gtQGKT7Ga1lS2_CkMBAAAACMAAQED",
    "brand_name": "海底捞",
    "business_certificate": "AM-uJRh2SRKz9N0r9zW4wQAAACMAAQEC",
    "business_time": "周一-周五 09:00-20:00,周六-周日 10:00-22:00",
    "category_id": "2015063000020189",
    "city_code": "522400",
    "contact_number": "13534567652,021-76391728",
    "district_code": "522401",
    "implement_id": "UO001,TY002",
    "is_operating_online": "F",
    "is_show": "F",
    "latitude": "27.296891",
    "licence": "En00j29-TGyXNVEPXIssFQAAACMAAQED",
    "licence_code": "HZ001",
    "licence_name": "杭州市西湖区万塘路支小宝美甲店",
    "longitude": "105.291027",
    "main_image": "4G8gtQGKT7Ga1lS2_CkMBAAAACMAAQED",
    "main_shop_name": "肯德基",
    "no_smoking": "T",
    "notify_mobile": "13827197382",
    "notify_url": "string",
    "online_image": "AM-uJRh2SRKz9N0r9zW4wQAAACMAAQEC",
    "online_url": "http://www.******.com/shop/21831830",
    "op_id": "2088001969784501",
    "op_role": "ISV、PROVIDER",
    "operate_notify_url": "http://example.com/gateway.do",
    "other_authorization": "1T8Pp00AT7eo9NoAJkMR3AAAACMAAQEC,1T8Pp00AT7eo9NoAJkMR3AAAACMAAQEC",
    "parking": "F",
    "partner_id": "2088001969784001",
    "pay_type": "code_scanned_pay",
    "province_code": "520000",
    "request_id": "20151234321423",
    "shop_id": "2015052100077000000000120773",
    "store_id": "hz001",
    "value_added": "免费茶水",
    "version": "2.0",
    "wifi": "F",
    "business_certificate_expires": {},
    "licence_expires": {}
}'

响应示例

200 - 示例 1

{
  "apply_id": "2015111410223410000001",
  "audit_desc": "门店首图不符合规范",
  "audit_status": "AUDITING",
  "is_online": "T",
  "is_show": "T"
}

请求参数

Body 参数application/json

address

string

可选

门店详细地址，地址字符长度在4-50个字符。门店详细地址，格式（不含省市区）：例1：道路+门牌号，“人民东路18号”；例2：道路+门牌号+标志性建筑+楼层；注：门店详细地址按规范格式填写地址，以免影响门店搜索及活动报名

示例值:

万塘路18号黄龙时代广场

audit_images

string

可选

门店审核时需要的图片; 至少包含一张门头照片，两张内景照片，必须反映真实的门店情况，审核才能够通过，多个以英文逗号分隔。

示例值:

02hkCZKaRgmLyirx4If6nAAAACMAAQED

auth_letter

string

门店授权函。

可选

示例值:

AM-uJRh2SRKz9N0r9zW4wQAAACMAAQEC

avg_price

string

可选

人均消费价格，最少1元，最大不超过99999元，请按实际情况填写，单位元。

示例值:

56.73

biz_version

string

可选

店铺接口业务版本号，新接入的ISV，请统一传入2.0。

示例值:

2.0

box

string

可选

包厢支持，T表示有包厢，F表示无包厢；不传值默认F。

示例值:

branch_shop_name

string

可选

分店名称，比如：万塘路店，与主门店名合并在客户端显示为：肯德基(万塘路店)。分店名长度需在2~20个字符之间。

示例值:

万塘路店

brand_logo

string

可选

品牌LOGO; 图片ID，不填写则默认为门店首图main_image。

示例值:

4G8gtQGKT7Ga1lS2_CkMBAAAACMAAQED

brand_name

string

可选

品牌名称；不填写则默认为“其它品牌”。

示例值:

海底捞

business_certificate

string

可选

许可证，各行业所需的证照资质参见商户入驻要求；该字段只能上传一张许可证，一张以外的许可证、除营业执照和许可证之外其他证照请放在其他资质字段上传。

示例值:

AM-uJRh2SRKz9N0r9zW4wQAAACMAAQEC

business_time

string

可选

请严格按"周一-周五 09:00-20:00,周六-周日 10:00-22:00"的格式进行填写，时间段不能重复，最多支持两个时间段，24小时营业请填写"00:00-23:59"

示例值:

周一-周五 09:00-20:00,周六-周日 10:00-22:00

category_id

string

可选

废弃字段，不支持修改类目。类目id，请参考商户入驻要求。

示例值:

2015063000020189

city_code

string

可选

城市编码，国标码，详见国家统计局数据点此下载。

示例值:

522400

contact_number

string

可选

门店电话号码；支持座机和手机，在客户端对用户展现，支持多个电话，以英文逗号分隔。

示例值:

13534567652,021-76391728

district_code

string

可选

区县编码，国标码，详见国家统计局数据点此下载。

示例值:

522401

implement_id

string

可选

店铺使用的机具编号，多个以英文逗号分隔。

示例值:

UO001,TY002

is_operating_online

string

可选

是否在其他平台开店，T表示有开店，F表示未开店。

示例值:

is_show

string

可选

废弃字段，T表示显示，F表示隐藏，默认为T。

示例值:

latitude

string

可选

纬度，注：高德坐标系。经纬度是门店搜索和活动推荐的重要参数，录入时请确保经纬度参数准确。高德经纬度查询：http://lbs.amap.com/console/show/picker

示例值:

27.296891

licence

string

可选

门店营业执照图片，各行业所需的证照资质参见：https://doc.open.alipay.com/doc2/detail.htm?spm=a219a.7629140.0.0.NBvQVP&treeId=78&articleId=104497&docType=1。

示例值:

En00j29-TGyXNVEPXIssFQAAACMAAQED

licence_code

string

可选

门店营业执照编号。只支持输入中文，英文和数字。

示例值:

HZ001

licence_name

string

门店营业执照名称。

可选

示例值:

杭州市西湖区万塘路支小宝美甲店

longitude

string

可选

经度，注：高德坐标系。经纬度是门店搜索和活动推荐的重要参数，录入时请确保经纬度参数准确。高德经纬度查询：http://lbs.amap.com/console/show/picker

示例值:

105.291027

main_image

string

可选

门店首图；非常重要，推荐尺寸2000*1500。

示例值:

4G8gtQGKT7Ga1lS2_CkMBAAAACMAAQED

main_shop_name

string

可选

主门店名比如：肯德基；主店名里不要包含分店名，如“万塘路店”。主店名长度不能超过20个字符。【xxx店】、(xxx店)、（xxx店）、[xxx店]、<xxx店>、xxx店，等类似的主店名都是不合法的，如果需要录入分店，请填写到branch_shop_name字段中。

示例值:

肯德基

no_smoking

string

可选

无烟区支持，T表示禁烟，F表示不禁烟；不传值默认F。

示例值:

notify_mobile

string

可选

门店店长电话号码；用于接收门店状态变更通知，收款成功通知等通知消息，不在客户端展示；多个以引文逗号分隔。

示例值:

13827197382

notify_url

string

通知地址

可选

online_image

string

可选

废弃字段，请使用online_url字段替代。

示例值:

AM-uJRh2SRKz9N0r9zW4wQAAACMAAQEC

online_url

string

可选

其他平台开店的店铺链接url,多个url使用英文逗号隔开，isv迁移到新接口使用此字段，与is_operating_online=T配套使用。

示例值:

http://www.******.com/shop/21831830

op_id

string

可选

（支付宝内部参数）操作员的支付账号ID(服务商ID、城市经理ID)。

示例值:

2088001969784501

op_role

string

可选

表示以系统集成商的身份开店，开放平台现在统一传入ISV。

示例值:

ISV、PROVIDER

operate_notify_url

string

可选

通知发送url;当商户的门店审核状态发生变化时，会向该地址推送消息。

示例值:

http://example.com/gateway.do

other_authorization

string

可选

其他资质。用于上传营业证照、许可证照外的其他资质，除已上传许可证外的其他许可证也可以在该字段上传。

示例值:

1T8Pp00AT7eo9NoAJkMR3AAAACMAAQEC,1T8Pp00AT7eo9NoAJkMR3AAAACMAAQEC

parking

string

可选

门店是否支持停车，T表示支持，F表示不支持，不传在客户端不作展示。

示例值:

partner_id

string

可选

（支付宝内部参数）服务商要操作的商户PID。

示例值:

2088001969784001

pay_type

string

可选

（支付宝内部参数）付款方式：code_scanned_pay：付款码 online_pay：在线买单。ISV不可以指定此字段，ISV泛行业开店默认为在线买单，云纵开店可以指定支付方式。

示例值:

code_scanned_pay

province_code

string

可选

省份编码，国标码，详见国家统计局数据点此下载”。

示例值:

520000

request_id

string

可选

外部请求ID; 标识ISV本次修改的请求，由开发者自定义，不同的请求使用不同的ID，在门店notify消息中也会带有该参数，以此标明本次notify消息是对哪个请求的回应

示例值:

20151234321423

shop_id

string

支付宝门店ID。

可选

示例值:

2015052100077000000000120773

store_id

string

可选

外部门店编号；最长32位字符，该编号将作为收单接口的入参，请开发者自行确保其唯一性。

示例值:

hz001

value_added

string

可选

门店其他的服务，门店与用户线下兑现。

示例值:

免费茶水

version

string

可选

废弃字段，使用biz_version字段替代。

示例值:

2.0

wifi

string

可选

门店是否支持WIFI，T表示支持，F表示不支持，不传在客户端不作展示。

示例值:

business_certificate_expires

string

可选

许可证有效期，格式：2020-03-20或长期。严格按照格式填写。

示例值:

{}

licence_expires

string

可选

营业执照过期时间。格式：2020-10-20或长期。严格按照格式填写。

示例值:

{}

示例

返回响应

🟢200common response

application/json

Body

apply_id

string

可选

修改门店请求受理成功后返回的支付宝流水ID，根据此ID调用接口 alipay.offline.market.applyorder.batchquery，能够获取当前修改店铺请求审核状态、驳回原因等信息。

示例值:

2015111410223410000001

audit_desc

string

废弃字段。

可选

示例值:

门店首图不符合规范

audit_status

string

可选

同步请求如果支付宝受理成功，将返回AUDITING状态。

示例值:

AUDITING

is_online

string

可选

废弃字段，T表示上架,F表示未上架。

示例值:

is_show

string

可选

废弃字段，T表示显示，F表示隐藏。

示例值:

🔴500请求失败

门店类目配置查询接口

查询单个门店信息接口