已授权门店信息查询接口
查询已完成门店认证授权用户的门店信息。
请求接口
/openapi/pay/wxapp/b2b/queryRetailInfo
公共参数
请求参数
mobile_phone和open_id二选一必填
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| app_id | 是 | String(64) | 录入门店信息的对应app_id |
| mobile_phone | 否 | String(11) | 手机号,与微信openid二选一必填(都填写时优先使用openid) |
| open_id | 否 | String(256) | 微信openid,与手机号二选一必填(都填写时优先使用openid) |
content请求示例
{
"app_id": "xxxxxx",
"mobile_phone": "13912345678",
"open_id": "xxxxxx"
}
响应参数
| 名称 | 必填 | 类型 | 说明 |
|---|---|---|---|
| info_list | 否 | Array | 门店信息info对象列表,info对象如下: |
- info对象字段说明:
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| mobile_phone | 是 | String(11) | 手机号。 示例值:13912345678 |
| open_id | 是 | String(256) | 门店负责人openid |
| retail_name | 是 | String(256) | 门店名称。示例值:“XXX超市” |
| retail_type | 是 | String(32) | 一级门店类型。可选项如下: GROCERY_STORE:杂货店 CONVENIENCE_STORE:便利店 SUPERMARKET:超市 RESTAURANT:餐饮店 BABY_STORE:母婴店 LIQUOR_STORE:烟酒店 OTHER:其他。示例值:GROCERY_STORE |
| sub_retail_type | 否 | String(32) | 二级门店类型。 示例值:"美容美发" |
| legal_person_name | 否 | String(10) | 法人名称。示例值:"张三" |
| enterprise_name | 否 | String(128) | 企业名称。示例值:“xxx有限责任公司” |
| registration_number | 是 | String(32) | 营业执照注册号。示例值:"xxxxxxxxxxxxxxxxxx" |
| retail_address | 是 | String(512) | 门店地址。 |
| status | 是 | String(32) | 认证状态。 可选项如下: AUTHED:已完成认证 |
| grant_time | 否 | String(11) | 授权时间,授权给小程序那一刻的时间戳。示例值:"1746681863461" |
| auth_time | 否 | String(11) | 认证时间,认证完成那一刻的时间戳。示例值:"1746681863461" |
| longitude | 否 | String(32) | 经度(门店定位信息。若门店未提交定位信息,则返回值里无该字段)。示例值:"116.463832" |
| latitude | 否 | String(32) | 纬度(门店定位信息。若门店未提交定位信息,则返回值里无该字段)。示例值:"39.925459" |
| business_type_list | 是 | Array | 一级主营商品。可选项如下: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会返回出错信息。 :::