跳到主要内容

已授权门店信息查询接口

查询已完成门店认证授权用户的门店信息。

请求接口

/openapi/pay/wxapp/b2b/queryRetailInfo

公共参数

接口协议 - 公共参数

请求参数

mobile_phone和open_id二选一必填

参数必填类型说明
app_idString(64)录入门店信息的对应app_id
mobile_phoneString(11)手机号,与微信openid二选一必填(都填写时优先使用openid)
open_idString(256)微信openid,与手机号二选一必填(都填写时优先使用openid)
content请求示例
{
"app_id": "xxxxxx",
"mobile_phone": "13912345678",
"open_id": "xxxxxx"
}

响应参数

名称必填类型说明
info_listArray门店信息info对象列表,info对象如下:
  • info对象字段说明:
参数必填类型说明
mobile_phoneString(11)手机号。 示例值:13912345678
open_idString(256)门店负责人openid
retail_nameString(256)门店名称。示例值:“XXX超市”
retail_typeString(32)一级门店类型。可选项如下: GROCERY_STORE:杂货店 CONVENIENCE_STORE:便利店 SUPERMARKET:超市 RESTAURANT:餐饮店 BABY_STORE:母婴店 LIQUOR_STORE:烟酒店 OTHER:其他。示例值:GROCERY_STORE
sub_retail_typeString(32)二级门店类型。 示例值:"美容美发"
legal_person_nameString(10)法人名称。示例值:"张三"
enterprise_nameString(128)企业名称。示例值:“xxx有限责任公司”
registration_numberString(32)营业执照注册号。示例值:"xxxxxxxxxxxxxxxxxx"
retail_addressString(512)门店地址。
statusString(32)认证状态。 可选项如下: AUTHED:已完成认证
grant_timeString(11)授权时间,授权给小程序那一刻的时间戳。示例值:"1746681863461"
auth_timeString(11)认证时间,认证完成那一刻的时间戳。示例值:"1746681863461"
longitudeString(32)经度(门店定位信息。若门店未提交定位信息,则返回值里无该字段)。示例值:"116.463832"
latitudeString(32)纬度(门店定位信息。若门店未提交定位信息,则返回值里无该字段)。示例值:"39.925459"
business_type_listArray一级主营商品。可选项如下:FOOD_AND_BEVERAGE:食品饮料 CATERING:餐饮 FRESH_FRUITS_AND_VEGETABLES:生鲜果蔬(含鲜花)TOBACCO_AND_ALCOHOL:烟酒 FOOTWEAR_CLOTHING_UNDERWEAR:鞋服内衣 PERSONAL_CARE_AND_COSMETICS:个护美妆 ELECTRONICS:3C数码 HOME_APPLIANCES:家用电器 AUTOMOTIVE_REPAIR_PARTS:汽修/汽配 MEDICAL_EQUIPMENT:医药/医疗器械 HOME_IMPROVEMENT_HARDWARE_B UILDING_MATERIALS:家装/五金/建材 HOME_TEXTILES:家居家纺 STATIONERY_TOYS:文具玩具 MATERNITY_BABY:母婴 PET_PRODUCTS:宠物 OTHER:其他
other_business_type条件必填String(32)二级主营商品。

返回示例

{
"info_list": [
{
"mobile_phone": "13912345678",
"open_id": "xxxx",
"retail_name": "门店超市",
"retail_type": "GROCERY_STORE",
"sub_retail_type": "超市",
"legal_person_name": "张三",
"enterprise_name": "天天新鲜有限责任公司",
"registration_number": "914xx2xxA4xxxL6xx5",
"retail_address": "xxxxx",
"status": "AUTHED",
"business_type_list": [
"FOOD_AND_BEVERAGE"
]
}
]
}

::: tip 提示

  • 公共返回值code=0时,表示请求提交成功;
  • 出错时,公共返回值msg会返回出错信息。 :::