测试地址:http://116.228.64.55:28082/yst-service-api/tx/handle
生产地址:https://ibsapi.allinpay.com/yst-service-api/tx/handle
接口代码(transCode):4010
功能说明:
1、通过本API可提前预录入门店信息
2、对于已提前预录入门店信息的用户,在登录小程序进行门店认证授权流程时,会默认拉起展示预录入的门店信息,用户一键确认即可完成认证授权,减少用户操作成本,提示认证授权成功率
业务请求参数
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
reqTraceNum |
String |
50 |
是 |
请求流水号 |
|
retailInfoList |
List |
|
是 |
门店信息列表 |
每次最多导入100个,多则报错 |
retailInfoList的明细字段:
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
mobilePhone
|
String |
50 |
是 |
手机号 |
限制11位手机号 |
retailName |
String |
60 |
是 |
门店名称 |
长度为1-30个字符,一个中文字等于2个字符 |
retailType |
String |
60 |
否 |
一级门店类型 |
类型:杂货店、便利店、超市、餐饮店、母婴店、烟酒店、其他 |
subRetailType |
String |
60 |
否 |
二级门店类型 |
一级门店类型=“其他”时必填 |
addressProvince |
String |
60 |
是 |
门店所在省 |
|
addressCity |
String |
60 |
是 |
门店所在市 |
|
addressRegion |
String |
60 |
是 |
门店所在区县 |
|
addressStreet |
String |
60 |
是 |
门店所在街道详细地址 |
|
registrationNumber |
String |
60 |
否 |
营业执照注册号 |
|
bizName |
String |
60 |
否 |
企业名称 |
|
corporationName |
String |
60 |
否 |
法人姓名 |
|
latitude |
String |
60 |
否 |
纬度 |
|
longitude |
String |
60 |
否 |
经度 |
|
业务响应参数
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
numSuccess
|
String |
60 |
是 |
录入成功数量
|
|
numFailure
|
String |
60 |
是 |
录入失败数量
|
|
failureInfo
|
JsonString |
60 |
否 |
具体失败信息
|
failureInfo的明细字段:
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
mobilePhone
|
String |
50 |
是 |
手机号 |
|
registrationNumber
|
String |
60 |
否 |
营业执照注册号 |
|
failureCode
|
String |
60 |
是 |
错误码 |
failureCode-错误码字典
响应码 |
说明 |
2
|
无效手机号
|
3
|
无效门店类型
|
4 |
地址解析失败
|
5 |
手机号已被录入门店信息
|
6 |
无效的门店名称(长度限制为1-30个字符,一个中文字等于2个字符) |