店铺查询接口
开发环境
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
返回响应
修改于 2023-11-27 05:57:43