修改蚂蚁店铺

修改蚂蚁店铺，按信息项修改。若无特殊说明，如果某项存在但是没填写，则不会覆盖掉原来的值

curl --location --request PATCH 'http://dev-cn.your-api-server.com/v3/ant/merchant/shop' \ --header 'Content-Type: application/json' \ --data-raw '{ "business_address": { "address": "string", "city_code": "string", "district_code": "string", "latitude": "string", "longitude": "string", "poiid": "string", "province_code": "string", "type": "string" }, "contact_infos": { "email": "string", "id_card_no": "string", "mobile": "string", "name": "string", "phone": "string", "type": "string", "tag": [ "string" ] }, "biz_cards": [ { "account_branch_name": "string", "account_holder_name": "string", "account_inst_city": "string", "account_inst_id": "string", "account_inst_name": "string", "account_inst_province": "string", "account_no": "string", "account_type": "string", "bank_code": "string", "usage_type": "string" } ], "brand_id": "20181026000001", "business_time": [ { "close_time": "string", "open_time": "string", "week_day": 0 } ], "cert_image": "c6c0c7a1-b9d5-4e5d-b9d4-9eed39f00e65.jpg", "cert_name": "支付宝东门小卖铺", "cert_no": "9133010608210550XR", "cert_type": "201", "contact_mobile": "13901390139", "contact_phone": "010-62286228", "ext_infos": [ { "key_name": "string", "value": "string" } ], "ip_role_id": "2088301155943087", "legal_cert_no": "100100198811110001", "legal_name": "支小宝", "license_auth_letter_image": "c6c0c7a1-b9d5-4e5d-b9d4-9eed39f00e65.jpg", "memo": "备注", "qualifications": [ { "industry_qualification_image": "string", "industry_qualification_type": "string" } ], "scene": "PARK", "settle_alipay_logon_id": "demo@163.com", "shop_category": "B0001", "shop_id": "2018011900502000000005124744", "shop_name": "支付宝东门小卖铺", "store_id": "NO0001", "out_door_images": "c6c0c7a1-b9d5-4e5d-b9d4-9eed39f00e65.jpg" }'

请求参数

Body 参数application/json

business_address

object (AddressInfo)

可选

address

string

可选

地址。商户详细经营地址或人员所在地点

city_code

string

可选

城市编码。蚂蚁店铺请按照蚂蚁店铺地区码表格中填写。直付通商户请按照直付通商户地区码表格中内容填写。

district_code

string

可选

区县编码。蚂蚁店铺请按照蚂蚁店铺地区码表格中填写。直付通商户请按照直付通商户地区码表格中内容填写。

latitude

string

可选

纬度，浮点型,小数点后最多保留6位如需要录入经纬度，请以高德坐标系为准，录入时请确保经纬度参数准确。高德经纬度查询：http://lbs.amap.com/console/show/picker

longitude

string

可选

经度，浮点型, 小数点后最多保留6位。如需要录入经纬度，请以高德坐标系为准，录入时请确保经纬度参数准确。高德经纬度查询：http://lbs.amap.com/console/show/picker

poiid

string

高德poiid

可选

province_code

string

可选

省份编码。蚂蚁店铺请按照蚂蚁店铺地区码表格中填写。直付通商户请按照直付通商户地区码表格中内容填写。

type

string

可选

地址类型。取值范围：BUSINESS_ADDRESS：经营地址（默认）

contact_infos

object (ContactInfo)

可选

string

电子邮箱

可选

id_card_no

string

身份证号

可选

mobile

string

可选

手机号。必填与否参见外层对象描述，无特别说明认为是非必填

name

string

联系人名字

可选

phone

string

电话

可选

type

string

可选

联系人类型，取值范围：LEGAL_PERSON：法人；CONTROLLER：实际控制人；AGENT：代理人；OTHER：其他

tag

array[string]

可选

商户联系人业务标识枚举，表示商户联系人的职责。异议处理接口人:02;商户关键联系人:06;数据反馈接口人:11;服务联动接口人:08

biz_cards

array[object (SettleCardInfo) {10}]

可选

"门店结算卡信息。本业务当前只允许传入一张结算卡。说明：本参数仅直付通业务使用，其余业务无需关注。"

account_branch_name

string

开户支行名

可选

account_holder_name

string

卡户名

可选

account_inst_city

string

开户行所在地-市

可选

account_inst_id

string

开户行简称缩写

可选

account_inst_name

string

银行名称

可选

account_inst_province

string

开户行所在地-省

可选

account_no

string

银行卡号

可选

account_type

string

可选

卡类型借记卡-DC 信用卡-CC

bank_code

string

可选

联行号，详细需调用‘联行号关联分支行查询’API查看查询结果

usage_type

string

可选

账号使用类型对公-01 对私-02

brand_id

string

可选

品牌id。若无需更新本信息项，可以不填写

示例值:

20181026000001

business_time

array[object (ShopBusinessTime) {3}]

可选

店铺经营时间。若无需更新本信息项，可以不填写

close_time

string

可选

关门时间格式：HH:mm

open_time

string

可选

开门时间格式：HH:mm

week_day

integer

可选

本对象表示周几的营业时间。1~6表示周一到周六，7表示周日

cert_image

string

营业执照图片KEY

可选

示例值:

c6c0c7a1-b9d5-4e5d-b9d4-9eed39f00e65.jpg

cert_name

string

可选

营业执照名称，填写值为营业执照或统一社会信用代码证上的名称。

示例值:

支付宝东门小卖铺

cert_no

string

可选

证件号码。请填写店铺营业执照号。

示例值:

9133010608210550XR

cert_type

string

证件类型

可选

示例值:

201

contact_mobile

string

可选

店铺联系手机，与店铺联系固话二选一必填

示例值:

13901390139

contact_phone

string

可选

店铺的联系固话，和店铺联系手机二选一必填

示例值:

010-62286228

ext_infos

array[object (ShopExtInfo) {2}]

可选

扩展信息列表。key值需要向对应行业的bd进行申请。传入本项时，按key进行更新或补充

key_name

string

可选

KV数据对的key，表示该kv对象表示什么含义。

value

string

kv对象的值

可选

ip_role_id

string

可选

商户角色id，表示将要修改的店属于哪个商户角色，和store_id一起定位待修改的门店。对于直连场景，填写商户pid；对于间连场景（线上、线下、直付通），填写商户smid。本接口中，如果没传shop_id，则本字段与store_id均必填。本信息项不可修改

示例值:

2088301155943087

legal_cert_no

string

可选

法人身份证号。如果要更新，必须和legal_name成对传入

示例值:

100100198811110001

legal_name

string

可选

法人名称。如果要更新，必须和legal_cert_no成对传入

示例值:

支小宝

license_auth_letter_image

string

可选

营业执照授权函。其值为使用ant.merchant.expand.indirect.image.upload上传图片得到的一串oss key。若无需更新本信息项，可以不填写

示例值:

c6c0c7a1-b9d5-4e5d-b9d4-9eed39f00e65.jpg

memo

string

备注

可选

示例值:

备注

qualifications

array[object (IndustryQualificationInfo) {2}]

可选

行业特殊资质。若无需更新本信息项，可以不填写。填写会按类型进行更新或补充

industry_qualification_image

string

可选

商户行业资质图片。其值为使用ant.merchant.expand.indirect.image.upload上传图片得到的一串oss key

industry_qualification_type

string

可选

商户行业资质类型，具体选值参见，进件MCC与资质要求 202212.xlsx中特殊资质栏

scene

string

可选

场景。若无需更新本信息项，可以不填写

示例值:

PARK

settle_alipay_logon_id

string

可选

结算支付宝账号的登录号。若无需更新本信息项，可以不填写

示例值:

demo@163.com

shop_category

string

可选

新版门店类目标准二级类目code。类目标准及与原shop_category映射关系参见表格 https://ur.alipay.com/2qv1f9。若无需更新本信息项，可以不填写

示例值:

B0001

shop_id

string

可选

蚂蚁店铺id，用于查出待修改的门店。填写本参数的话，store_id和ip_role_id可以不填。本信息项不可修改

示例值:

2018011900502000000005124744

shop_name

string

可选

店铺名称。直连开店要保证全局店铺名称+地址唯一，间连开店要保证服务商pid下店铺名称+地址唯一。若无需更新本信息项，可以不填写

示例值:

支付宝东门小卖铺

store_id

string

可选

门店编号，表示该门店在该商户角色id(直连pid，间连smid)下，由商户自己定义的外部门店编号。用于查出待修改的门店。本接口中，如果没传shop_id，则本字段与ip_role_id均必填；传入shop_id情况下，以shop_id为准查询门店，并修改本信息项

示例值:

NO0001

out_door_images

array[string]

可选

门头照，其值为使用ant.merchant.expand.indirect.image.upload上传图片得到的一串oss key。若无需更新本信息项，可以不填写。若填写则会整体覆盖原有的门头照列表

示例值:

c6c0c7a1-b9d5-4e5d-b9d4-9eed39f00e65.jpg

示例

修改蚂蚁店铺

请求参数

返回响应