接口功能：通过本API可提前预录入门店信息。
场景说明：对于已提前预录入门店信息的用户，在登录小程序进行门店认证授权流程时，会默认拉起展示预录入的门店信息，用户一键确认即可完成认证授权，减少用户操作成本，提示认证授权成功率。

接口说明

测试请求URL：https://test-api.huishouqian.com/merchant/register

生产请求URL：https://api.huishouqian.com/merchant/register

请求方式：POST

公共请求参数

变量 参数名 类型[长度限制] 必 填 描述
method 方法名 string[1,32] 是 B2B_STORE_APPLY
version 版本 string[1,16] 是 接口版本：1.0
format 请求格式 string[1,16] 是 业务请求参数格式，支持：JSON
agentMerchantNo 商户号 string[1,16] 是 商户在慧收钱的商户号，由慧收钱生成并下发
signType 加密类型 string[1,16] 是 RSA2:签名机制查看说明
signContent 业务数据 string 是 业务请求参数
sign 签名数据 string[1,128] 否 签名数据

业务请求参数

量变 参数名 类型[长度限制] 必填 描述
storeApplyList 门店信息列表 是 每次调用最多可导入100个门店，多于则返回错误 JSON字符串
transNo 请求流水号 是

storeApplyList

量变 参数名 类型[长度限制] 必填 描述
mobile_phone 手机号 是 手机号码
retail_name 门店名称 是 门店的全称
retail_type 一级门店类型 是 选择符合门店类型（杂货店、便利店、超市、餐饮店、母婴店、烟酒店、其他）
sub_retail_type 二级门店类型 否 一级门店类型为“其他”时必填
address_province 门店地址，省 是 根据门店所在地填入
address_city 市 是 根据门店所在地填入
address_region 区县 是 根据门店所在地填入
address_street 街道详细地址 是 根据门店所在地填入街道具体地址
registration_number 营业执照注册号 否 门店的工商信息
biz_name 企业名称 否 门店归属的企业名称
corporation_name 法人姓名 否 门店的法人姓名与工商信息一致
latitude 纬度 否 门店定位信息
longitude 经度 否 门店定位信息 
{
{agentMerchantNo=841508774642, method=B2B_STORE_APPLY, format=json, sign=274b87de63f9bcb12570bdbe5dc312d8431180bab88dc30bdc28fb5b3c0ff42d28995ea2c516344cd85135a9e9e2b845cb53cc41e9f96ea4a934bb1247d61a5360fe9882973791f3df488d8d338740c73b0a87656af8957ef79cc59afdbac60fca71d7caa267142178218e96c0846da78dc21df7af045b5431f9ea86dd8a65d6d519e183459697da1f6fbe1fb4e958b17b61d266e326a750da3f4acb1785b7c70e83995806a8513f1ae3b6aaa5d8f05fca9c5c5190d17f32abc3590868208de99a1cadc517fadc3adb9bc38e9e8bb9aa334997944259219f19a5136fa0887e8dfec79970b8accbdf16a64b04e44a31204bb35a40a03d69b4323a4e098aca96b9, signType=RSA2, signContent={"storeApplyList":"[{\"sub_retail_type\":\"\",\"retail_type\":\"杂货店\",\"registration_number\":\"\",\"latitude\":\"223.1\",\"biz_name\":\"\",\"retail_name\":\"测试门店真实名称\",\"corporation_name\":\"\",\"address_city\":\"淮南市\",\"address_province\":\"安徽省\",\"address_region\":\"寿县\",\"mobile_phone\":\"18978786263\",\"address_street\":\"南门大转盘街道\",\"longitude\":\"122.1\"}]","transNo":"20241115006"}, version=1.0.0}
}

公共响应参数

变量 参数名 类型[长度限制] 必填 描述
success 响应状态 string[1,32] 是 服务端响应状态，如果为true，则可以调用result；如果为false，则调用errorCode来获取出错信息
errorCode 响应码 string[1,32] 否 响应码
errorMsg 响应描述 string[1,128] 否 响应描述
result 响应内容 string 否 业务响应参数
sign 签名数据 string[1,128] 否 响应验签数据

业务响应参数

变量 参数名 类型[长度限制] 必填 描述
errcode 响应码 是 响应结果码
errmsg 响应信息 是 响应描述
num_success 录入成功门店数 是 成功数量
num_failure 录入失败门店数 是 失败数量
failure_record_list 具体失败信息 否 录入失败的具体信息，JSON字符串

failure_record_list

变量 参数名 类型[长度限制] 必填 描述
mobile_phone 手机号 是 录入门店填写的手机号
registration_number 营业执照注册号 否 营业执照信息
failure_code 错误原因 是 录入失败的错误码 
{
{"success":true,"result":"{\"errcode\":40001,\"errmsg\":\"invalid credential, access_token is invalid or not latest, could get access_token by getStableAccessToken, more details at https://mmbizurl.cn/s/JtxxFh33r rid: 67381213-71064f6c-733bcf60\"}","errorCode":null,"errorMsg":null,"sign":"0f14fa65cf145e40965cd62a84f0d3c001c80ca824889f1393475c469c168194cf2616104d050f2acaaaf67389d9b63d5fa2e243a6ff54c2eedc831bbff2865c7bf031b2b0ed3a7dd426d2456be9e5f6c04e5f3aa5a8bc204b6ba5b3c4c318abfb071a45b8df40acd31079a9242c7077d6b4e7243891cfa29d9b169cefa79cbd9c686edf677a94cf403167cf35b3994de9752584371650c3f736fa58f1d42c78ef7fa3738b0fee70d2a2debda0749e1ce2d4463f392b15583f2f15ccdf1b6712b36dcf0e4c9e3af87eb4669671dec6f29b1f549fb10b9817987ae05ab9dcf2647f14793fc7aff9a8028289312b1bf3b89ae664380d81a0ea77832b5a0518f7b4"}
}

errcode响应码

响应码 描述
-1 系统繁忙，请稍后重试
0 成功
40001 token 无效
48001 小程序无该api权限，反馈给对接人开通
9404000 上传数量过多
9404001 门店信息参数缺失

failure_code响应码

响应码 描述
2 无效的手机号
3 无效的门店类型
4 地址解析失败
5 手机号已被录入门店信息
6 无效的门店名称（长度限制为1-30个字符，一个中文字等于2个字符）