修改蚂蚁店铺
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
PATCH
/v3/ant/merchant/shop
错误码
公共错误码
业务错误码
| 状态码 | 错误码 | 错误描述 | 解决方案 |
|---|---|---|---|
| 400 | SYSTEM_ERROR | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| 400 | ADDRESS_CITY_CODE_ILLEGAL | 市码非法 | 地址中市码非法 |
| 400 | ADDRESS_DISTRICT_CODE_ILLEGAL | 区码非法 | 地址中区码非法 |
| 400 | ADDRESS_PROVINCE_CODE_ILLEGAL | 省码非法 | 地址中省码非法 |
| 400 | ATTACHMENT_CHECK_FAIL | 附件非法 | out_door_images、qualifications等字段传入的image_id非法，需传入ant.merchant.expand.indirect.image.upload 接口上传图片后得到的 image_id |
| 400 | ATTACHMENT_URL_NULL | 附件地址为空 | 当传了industry_qualification_type时，请检查industry_qualification_image是否正确设置参数 |
| 400 | BANK_ACCOUNTINSTID_ILLEGAL | 开户行简称校验不合法 | 开户行简称校验不合法 |
| 400 | BANK_ACCOUNTINSTNAME_ILLEGAL | 银行名称校验不合法 | 银行名称校验不合法 |
| 400 | BANK_BRANCH_NAME_ILLEGAL | 银行卡分支机构名称非法 | 银行卡分支机构名称非法 |
| 400 | BRAND_ILLEGAL | 品牌非法 | 品牌非法，品牌id不存在，或店铺类目不在品牌范围内 |
| 400 | BUSINESS_TIME_ILLEGAL | 营业时间非法 | 请检查business_time字段格式是否正确。尤其请注意时间需要传HH:mm，例如需要传08:00而不是8:00 |
| 400 | CONTACT_PERSON_NAME_NULL | 联系人名称为空 | 联系人名称为空 |
| 400 | CONTACT_WAY_VALUE_NULL | 联系方式值为空 | 联系方式值为空，可能是店铺的固话或手机二选一必填，也可能是联系人的固话手机email三选一必填 |
| 400 | FIELD_LENGTH_ERROR | 字段长度错误 | 请检查字段超出最大长度限制，例如account_holder_name、account_no、account_inst_province、account_inst_city、account_branch_name等字段 |
| 400 | GONGAN_CHECK_FAIL | 公安网校验失败 | 公安网校验失败，法人信息有误 |
| 400 | GONGSHANG_CHECK_FAIL | 工商网校验失败 | 工商网校验失败，营业执照号有误 |
| 400 | GONGSHANG_LICENSE_ILLEGAL | 工商网校验营业执照不合法 | 请检查该营业执照是否存在，或检查其在工商网的状态，如果是过期、无效等状态会报本错误 |
| 400 | INDUSTRY_QUALIFICATION_IS_EMPTY | 行业资质为空 | 行业资质为空 |
| 400 | IP_ROLE_ID_DO_NOT_CHANGE | ipRoleId不允许变更 | ipRoleId不允许变更 |
| 400 | ISV_NOT_EXIST | 待操作的服务商不存在 | 待操作的服务商不存在 |
| 400 | LOCATION_CHECK_FAIL | 经纬度非法 | 修改经纬度 经度范围-180-180 纬度范围-90-90 |
| 400 | MERCHANT_INPUT_ARGUMENT_ILLEGAL | 输入参数非法 | 输入参数非法，可能原因是某字段包含违禁词 |
| 400 | MERCHANT_ORDER_EXECUTE_CONFLICT | 申请单业务单元执行并发冲突 | 请不要并发进件相同门店 |
| 400 | MER_ARGUMENT_ILLEGAL | 入参非法 | 请检查请求参数是否正确 |
| 400 | MER_ARGUMENT_NULL | 入参对象为空 | 入参对象为空，请按照接口描述填入正确的必填或条件必填参数 |
| 400 | NOT_ALLOWED_SETTLE | 不允许的进件 | 不允许的进件 |
| 400 | PROFILE_KEY_ILLEGAL | extInfo中的key不合法 | extInfo中的key不合法，请联系对应BD确认 |
| 400 | RELATION_NOT_EXIST | isvPid与店铺无关系 | isvPid与店铺无关系，不能进行修改操作 |
| 400 | SETTLED_ACCOUNTBRANCHNAME_EMPTY | 支行信息为空 | 支行信息为空 |
| 400 | SETTLED_ACCOUNTHOLDERNAME_EMPTY | 卡户名为空 | 卡户名为空 |
| 400 | SETTLED_ACCOUNTINSTNAME_EMPTY | 银行名称为空 | 银行名称为空 |
| 400 | SETTLED_ALIPAYACCOUNT_NOT_EXIST | 支付宝账号不存在 | 支付宝账号不存在，请检查入参中的settle_alipay_logon_id字段 |
| 400 | SETTLED_BANKCARD_NO_IS_EMPTY | 结算银行卡号为空 | 结算银行卡号为空 |
| 400 | SETTLED_BIZ_ADDRESS_ILLEGAL | 经营地址不合法 | 经营地址不合法，可能是对象为空，或其中省、市、区、详细地址为空 |
| 400 | SETTLED_CARD_ACCOUNTINSTID_EMPTY | 开户行简称为空 | 开户行简称为空 |
| 400 | SETTLED_CARD_ACCOUNTTYPE_EMPTY | 卡类型不能为空 | 卡类型不能为空 |
| 400 | SETTLED_CARD_ACCOUNTTYPE_ILLEGAL | 卡类型非法 | 卡类型非法 |
| 400 | SETTLED_OUTDOORIMAGE_EMPTY | 进件门头照为空 | 进件门头照为空 |
| 400 | SETTLED_USAGETYPE_ILLEGAL | 账号使用类型非法 | 账号使用类型非法 |
| 400 | SETTLED_USAGETYPE_IS_EMPTY | 账号使用类型为空 | 账号使用类型为空 |
| 400 | SHOP_ACCOUNT_NO_IS_ILLEGAL | 收款账户非法 | 收款账户非法 |
| 400 | SHOP_ALREADY_EXIST | 店铺已存在 | 店铺已存在。修改场景时如果报这个错，可能是修改后的名称+地址，或store_id有冲突 |
| 400 | SHOP_AUDIT_REJECT | 门店审核不通过 | 门店审核不通过，请填写线下真实可找到的门店名称以及地址信息 |
| 400 | SHOP_CATEGORY_IS_EMPTY | 门店类目不能为空 | 门店类目不能为空 |
| 400 | SHOP_CATEGORY_IS_ILLEGAL | 门店类目非法 | 门店类目非法 |
| 400 | SHOP_CODE_ALREADY_EXIST | 门店编码已存在 | 如果修改了store_id，请保证store_id在ip_role_id下唯一 |
| 400 | SHOP_NOT_EXIST | 店铺不存在或待操作店铺已关店 | 店铺不存在或待操作店铺已关店，请更换入参参数 |
| 400 | SHOP_TYPE_ILLEGAL | 店铺类型不合法 | 店铺类型不合法 |
| 400 | USER_ILLEGAL | 用户不合法 | 用户不合法，请确保ip_role_id存在且实名认证 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request PATCH 'http://dev-cn.your-api-server.com/v3/ant/merchant/shop' \
--header 'authorization: ALIPAY-SHA256withRSA app_id=$appid,timestamp=$now,nonce=$uuid,expired_seconds=600,sign=$sign' \
--header 'alipay-request-id: $requestid' \
--header 'Content-Type: application/json' \
--data-raw '{
"store_id":"NO0001",
"ip_role_id":"2088301155943087",
"shop_id":"2018011900502000000005124744",
"business_address":{
"city_code":"371000",
"district_code":"371002",
"address":"万塘路18号黄龙时代广场B座",
"province_code":"370000",
"poiid":"B0FFIVU189",
"longitude":"120.760001",
"latitude":"60.270001",
"type":"BUSINESS_ADDRESS"
},
"shop_category":"B0001",
"shop_name":"支付宝东门小卖铺",
"contact_phone":"010-62286228",
"contact_mobile":"13901390139",
"cert_no":"9133010608210550XR",
"out_door_images":[
"c6c0c7a1-b9d5-4e5d-b9d4-9eed39f00e65.jpg"
],
"qualifications":[
{
"industry_qualification_type":"B0099",
"industry_qualification_image":"c6c0c7a1-b9d5-4e5d-b9d4-9eed39f00e65.jpg"
}
],
"cert_type":"201",
"cert_name":"支付宝东门小卖铺",
"cert_image":"c6c0c7a1-b9d5-4e5d-b9d4-9eed39f00e65.jpg",
"legal_name":"支小宝",
"license_auth_letter_image":"c6c0c7a1-b9d5-4e5d-b9d4-9eed39f00e65.jpg",
"settle_alipay_logon_id":"demo@163.com",
"business_time":[
{
"week_day":1,
"open_time":"09:30",
"close_time":"22:00"
}
],
"contact_infos":{
"name":"张三",
"tag":[
"06"
],
"phone":"0571-85022088",
"mobile":"13888888888",
"email":"user@domain.com",
"type":"LEGAL_PERSON",
"id_card_no":"110000199001011234"
},
"memo":"备注",
"brand_id":"20181026000001",
"scene":"PARK",
"legal_cert_no":"100100198811110001",
"ext_infos":[
{
"key_name":"SHOP_SLOGAN",
"value":"我是标语"
}
],
"biz_cards":[
{
"account_holder_name":"张三",
"account_no":"6214855710610408",
"account_inst_province":"浙江省",
"account_inst_city":"杭州市",
"account_branch_name":"招商银行杭州高新支行",
"usage_type":"01",
"account_type":"DC",
"account_inst_name":"招商银行",
"account_inst_id":"CMB",
"bank_code":"103290003044"
}
]
}'响应示例响应示例
{
"order_id":"2018012000502000000005130266"
}请求参数
Header 参数
authorization
string
必需
示例值:
ALIPAY-SHA256withRSA app_id=$appid,timestamp=$now,nonce=$uuid,expired_seconds=600,sign=$sign
alipay-request-id
string
必需
示例值:
$requestid
Content-Type
string
必需
示例值:
application/json
Body 参数application/json