店铺查询接口
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
GET
/v3/ant/merchant/shop
公共错误码
业务错误码
| 状态码 | 错误码 | 错误描述 | 解决方案 |
|---|---|---|---|
| 400 | SYSTEM_ERROR | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| 400 | ADDRESS_VERSION_CODE_ILLEGAL | 地址版本非法 | 地址版本非法,需传入指定的版本号 |
| 400 | MERCHANT_NOT_EXIST | 商户不存在 | 商户不存在，请更换入参参数 |
| 400 | MER_ARGUMENT_NULL | 入参对象为空 | 入参对象为空，请按照接口描述填入正确参数 |
| 400 | NOT_ALLOWED_SETTLE | 不允许的进件（查询） | 未经商户ip_role_id 授权，不允许进件（查询） |
| 400 | RELATION_NOT_EXIST | isvPid与店铺无关系 | isvPid与店铺无关系，不能进行本操作 |
| 400 | SHOP_NOT_EXIST | 店铺不存在 | 店铺不存在，请更换入参参数 |
| 400 | THIRD_SYSTEM_ERROR | 第三方系统错误 | 请尝试重试，重试后仍然失败请联系蚂蚁客服咨询 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'http://dev-cn.your-api-server.com/v3/ant/merchant/shop?store_id=202309221743579863&ip_role_id=2088002274190328&shop_id&address_version=2022Q2&need_recommend' \
--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 '{}'响应示例响应示例
{
"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": "1001",
"store_id": "NO0001",
"shop_type": "01",
"ip_role_id": "2088301155943087",
"shop_name": "肯德基中关村店",
"contact_phone": "010-62286228",
"contact_mobile": "13901390139",
"cert_no": "9133010608210550XR",
"out_door_images": [
"https://mif-pub.alipayobjects.com/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": "xxxx小卖铺",
"cert_image": "https://mif-pub.alipayobjects.com/c6c0c7a1-b9d5-4e5d-b9d4-9eed39f00e65.jpg",
"legal_name": "马云",
"legal_cert_no": "100100198811110001",
"license_auth_letter_image": "https://mif-pub.alipayobjects.com/c6c0c7a1-b9d5-4e5d-b9d4-9eed39f00e65.jpg",
"settle_alipay_logon_id": "demo@163.com",
"ext_infos": [
{
"key_name": "SHOP_SLOGAN",
"value": "我是标语"
}
],
"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",
"new_shop_category": "B0001",
"shop_info_status": "01",
"shop_recommend_info": {
"unconfidence_reason": "店名不准确",
"recommend": "请修改店名为真实经营的门店名称，如有分店，请修改成品牌（分店名），如大润发（杭州西溪店）",
"recommend_name": "大润发（杭州西溪店）",
"recommend_longtitude": "120.3333",
"recommend_latitude": "30.111",
"recommend_address": "杭州市西湖区**路**号"
}
}请求参数
Query 参数
store_id
string
可选
【示例值】NO0001
示例值:
202309221743579863
ip_role_id
string
可选
示例值:
2088002274190328
shop_id
string
可选
【示例值】2018011900502000000005124744
address_version
string
可选
示例值:
2022Q2
need_recommend
string
可选
【枚举值】
需要: 0
不需要: 1
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