1.上传图片
2.发送短信验证码
3.注册商户账号
4.查询注册商户审核状态
5.重新提交商户资料
1.上传图片
完整的请求url:(注: 该接口较为特殊,请求方式具体按照如下)
- /openapi/file/v5/fileUpload
请求方式
- post请求
- Content-Type: multipart/form-data
接口协议以及签名计算
测试联调
注: 该接口参与的签名字段是clientId,timestamp, 而file不参与签名
入参说明
| 参数 | 示例 | 说明 |
|---|---|---|
| clientId | ss1OF5yx8qBgtoB7I | App-key |
| timestamp | 1631862240982 | 毫秒级时间戳 |
| sign | 6FA5CCAEA3F4ACC0158F7B3CC9FAB110 | 签名 |
| file | 上传的文件 | 选择上传的图片文件 |
- 入参示例
clientId:ss1OF5yx8qBgtoB7I
sign:6FA5CCAEA3F4ACC0158F7B3CC9FAB110
timestamp:1631862240982- 出参示例
{
"status":200,
"msg":null,
"data":{
"url":"https://file-cstable.bingex.com/cstableTest/merchant_storage/2021/09/17/109b25e2-5f6c-45aa-a187-8488ab33f87e.png"
}
} 2.发送短信验证码
请求url:
- /openapi/merchantRegister/v5/sendSmsCode
请求方式
- post请求
- Content-Type:application/x-www-form-urlencoded
接口协议以及签名计算
测试联调
- 入参说明
| 参数 | 示例 | 说明 |
|---|---|---|
| clientId | ss1OF5yx8qBgtoB7I | App-key |
| timestamp | 1631862240982 | 毫秒级时间戳 |
| data | {"mobile":"16700000000"} |
业务入参 |
| sign | 6B8714D7A7B0CD4D130B4D24EEFC5F5A | 签名 |
- data参数说明
| 参数 | 字段描述 | 类型/是否必传 | 说明 |
|---|---|---|---|
| mobile | 接收短信手机号 | String(11)/YES |
- 入参示例
clientId:ss1OF5yx8qBgtoB7I
timestamp:1631862240982
data:{"mobile":"16700000000"}
sign:6B8714D7A7B0CD4D130B4D24EEFC5F5A- 出参示例
{
"status":200,
"msg":"发送短信成功",
"data":true
} 3.注册商户账号
请求url:
- /openapi/merchantRegister/v5/registerBecomeMerchant
请求方式
- post请求
- Content-Type:application/x-www-form-urlencoded
接口协议以及签名计算
测试联调
入参说明
| 参数 | 示例 | 说明 |
|---|---|---|
| clientId | ss1OF5yx8qBgtoB7I | App-key |
| timestamp | 1631862240982 | 毫秒级时间戳 |
| data | 见下方单独json串 | 业务入参 |
| sign | 93103B663CBC57CB814257EC6B170831 | 签名 |
- data参数说明
| 参数 | 字段描述 | 类型/是否必传 | 说明 |
|---|---|---|---|
| registerMobile | 注册手机号 | String(11)/YES | |
| smsCode | 短信验证码 | String(4)/YES | 发送短信验证码获取 |
| storeName | 店铺名称 | String(80)/YES | |
| cityName | 城市名称 | String(20)/YES | 查询开通城市接口获取 |
| goodType | 店铺业务类型 | String(8)/YES | 详见下放店铺类型枚举 |
| address | 店铺地址 | String(80)/YES | |
| addressDetail | 店铺详细地址 | String(80)/NO | |
| latitude | 店铺纬度 | Double(20)/YES | 只支持百度坐标 |
| longitude | 店铺经度 | Double(20)/YES | 只支持百度坐标系 |
| contactPhone | 联系人电话 | String(30)/YES | 支持手机号或座机. 座机格式:区号-座机号-分机号 如:010-1234567-321, 分机号可以省略 |
| frontIdcard | 身份证正面 | String(100)/YES | 该值获取参考上传图片, 只传图片地址 |
| reverseIdcard | 身份证反面 | String(100)/YES | 该值获取参考上传图片, 只传图片地址 |
| businessLicense | 营业执照 | String(100)/YES | 该值获取参考上传图片, 只传图片地址 |
| facade | 门店照 | String(100)/YES | 该值获取参考上传图片, 只传图片地址 |
- 出参说明
| 参数 | 类型/是否必传 | 说明 | 示例 |
|---|---|---|---|
| defaultStoreId | Long(20)/YES | 默认店铺ID | 393593 |
| shopId | Long(20)/YES | 商户ID | 20000000000001788 |
- 店铺类型标签枚举
| 店铺类型标签 | 店铺类型标签名称 |
|---|---|
| 1 | 文件 |
| 3 | 数码 |
| 5 | 蛋糕 |
| 6 | 餐饮 |
| 7 | 鲜花 |
| 9 | 汽配 |
| 10 | 其他 |
| 12 | 母婴 |
| 13 | 医药健康 |
| 15 | 商超 |
| 16 | 水果 |
- 入参示例
clientId:ss1OF5yx8qBgtoB7I timestamp:1631862240982 data:{"registerMobile":"16700000000","smsCode":"3732","storeName":"开发者注册商户店铺名称","cityName":"北京市","goodType":1,"address":"北京海淀区东升科技国际园","addressDetail":"2层","latitude":40.047858,"longitude":116.378424,"contactPhone":"16711291001","frontIdcard":"https://file-cstable.bingex.com/cstableTest/merchant_storage/2021/09/17/109b25e2-5f6c-45aa-a187-8488ab33f87e.png","reverseIdcard":"https://file-cstable.bingex.com/cstableTest/merchant_storage/2021/09/17/109b25e2-5f6c-45aa-a187-8488ab33f87e.png","businessLicense":"https://file-cstable.bingex.com/cstableTest/merchant_storage/2021/09/17/109b25e2-5f6c-45aa-a187-8488ab33f87e.png","facade":"https://file-cstable.bingex.com/cstableTest/merchant_storage/2021/09/17/109b25e2-5f6c-45aa-a187-8488ab33f87e.png"} sign:FEBDD1C8602ED07742125BFA6FE2832F
- 出参示例{
"status": 200,
"msg": null,
"data": {
"defaultStoreId": 393593,
"shopId": 20000000000001788
}
}
### <a name="4">4.查询注册商户审核状态</a>
- 请求url:
- /openapi/merchantRegister/v5/getMerchantAuditStatus
- 请求方式
* post请求
* Content-Type:application/x-www-form-urlencoded
- 接口协议以及签名计算
- [请参考开发指南](https://open.ishansong.com/documentCenter/326)
- 测试联调
- [测试联调说明](https://open.ishansong.com/documentCenter/325)
- 入参说明
|参数|示例|说明|
| ------------- |:-------------:|-----:|
| clientId | ss1OF5yx8qBgtoB7I|App-key|
| timestamp | 1631862240982 |毫秒级时间戳|
| data |```{"defaultStoreId":393593}```|业务参数|
| sign | CEB864860CBFB4EF314838E4CBF7C6A4 |签名|
- data参数说明
|参数|字段描述|类型/是否必传|说明|
| ------------- |:-------------:| -----:|-----:|
| defaultStoreId |店铺ID|Long(20)/YES|默认店铺ID|
- 出参说明
|参数|字段描述|类型/是否必传|说明|
| ------------- |:-------------:| -----:|-----:|
| auditStatus |店铺状态|Integer(8)/YES|1.审核中 2.审核成功 3.审核驳回|
| failedReason |审核驳回原因|String(100)/NO|审核驳回原因,当auditStatus为3时,该值不为空|
| auditStoreInfo |店铺信息|Object/YES||
- auditStoreInfo参数说明
|参数|字段描述|类型/是否必传|说明|
| ------------- |:-------------:| -----:|-----:|
| storeName |店铺名称|String(80)/YES||
| cityName |城市名称|String(20)/YES||
| goodType |店铺业务类型|String(8)/YES|详见下放店铺类型枚举|
| address |店铺地址 |String(80)/YES||
| addressDetail |店铺详细地址|String(80)/NO||
| latitude |店铺纬度| Double(20)/YES|只支持百度坐标|
| longitude |店铺经度| Double(20)/YES|只支持百度坐标系|
| contactPhone |联系人电话|String(30)/NO|支持手机号或座机. 座机格式:区号-座机号-分机号 如:010-1234567-321, 分机号可以省略|
| frontIdcard |身份证正面|String(100)/NO|该值获取参考[上传图片](https://open.ishansong.com/documentCenter/317), 只传图片地址|
| reverseIdcard |身份证反面|String(100)/NO|该值获取参考[上传图片](https://open.ishansong.com/documentCenter/317), 只传图片地址|
| businessLicense |营业执照|String(100)/NO|该值获取参考[上传图片](https://open.ishansong.com/documentCenter/317), 只传图片地址|
| facade |门店照|String(100)/NO|该值获取参考[上传图片](https://open.ishansong.com/documentCenter/317), 只传图片地址|
- 店铺类型标签枚举
|店铺类型标签|店铺类型标签名称|
| ------------- |:-------------:|
|1 | 文件 |
|3 | 数码 |
|5 |蛋糕 |
|6 | 餐饮 |
|7 | 鲜花 |
|9 | 汽配|
|10 | 其他 |
|12 | 母婴 |
|13 | 医药健康 |
|15 | 商超 |
|16 | 水果 |
- 入参示例clientId:ss1OF5yx8qBgtoB7I
timestamp:1631862240982
data:{"defaultStoreId":393593}
sign:CEB864860CBFB4EF314838E4CBF7C6A4
- 出参示例
{
"status":200,
"msg":null,
"data":{
"auditStatus":1,
"failedReason":null,
"auditStoreInfo":{
"storeName":"开发者注册商户店铺名称",
"cityName":"北京市",
"goodType":1,
"address":"北京海淀区东升科技国际园",
"addressDetail":"2层",
"latitude":40.047858,
"longitude":116.378424,
"contactPhone":"",
"frontIdcard":"",
"reverseIdcard":"",
"businessLicense":"",
"facade":""
}
}
}
### <a name="5">5.重新提交商户资料</a>
- 请求url:
- /openapi/merchantRegister/v5/reSubmitAuditMerchantInfo
- 请求方式
* post请求
* Content-Type:application/x-www-form-urlencoded
- 接口协议以及签名计算
- [请参考开发指南](https://open.ishansong.com/documentCenter/326)
- 测试联调
- [测试联调说明](https://open.ishansong.com/documentCenter/325)
- 入参说明
|参数|示例|说明|
| ------------- |:-------------:| -----:|-----:|
| clientId | ss1OF5yx8qBgtoB7I |App-key|
| timestamp | 1631862240982|毫秒级时间戳|
| data |见下方单独json串|业务参数|
| sign | 19E0F0DE27644F5DAE091BA973896F55 |签名|
- data参数说明
|参数|字段描述|类型/是否必传|说明|
| ------------- |:-------------:| -----:|-----:|
| defaultStoreId |店铺ID|Long(20)/YES||
| storeName |店铺名称|String(80)/YES||
| cityName |城市名称|String(20)/YES|[查询开通城市接口获取](https://open.ishansong.com/documentCenter/301)|
| goodType |店铺业务类型|String(8)/YES|详见下放店铺类型枚举|
| address |店铺地址 |String(80)/YES||
| addressDetail |店铺详细地址|String(80)/NO||
| latitude |店铺纬度| Double(20)/YES|只支持百度坐标|
| longitude |店铺经度| Double(20)/YES|只支持百度坐标系|
| contactPhone |联系人电话|String(30)/YES|支持手机号或座机. 座机格式:区号-座机号-分机号 如:010-1234567-321, 分机号可以省略|
| frontIdcard |身份证正面|String(100)/YES|该值获取参考[上传图片](https://open.ishansong.com/documentCenter/317), 只传图片地址|
| reverseIdcard |身份证反面|String(100)/YES|该值获取参考[上传图片](https://open.ishansong.com/documentCenter/317), 只传图片地址|
| businessLicense |营业执照|String(100)/YES|该值获取参考[上传图片](https://open.ishansong.com/documentCenter/317), 只传图片地址|
| facade |门店照|String(100)/YES|该值获取参考[上传图片](https://open.ishansong.com/documentCenter/317), 只传图片地址|
- 店铺类型标签枚举
|店铺类型标签|店铺类型标签名称|
| ------------- |:-------------:|
|1 | 文件 |
|3 | 数码 |
|5 | 蛋糕 |
|6 | 餐饮 |
|7 | 鲜花 |
|9 | 汽配|
|10 | 其他 |
|12 | 母婴 |
|13 | 医药健康 |
|15 | 商超 |
|16 | 水果 |
- 入参示例clientId:ss1OF5yx8qBgtoB7I
timestamp:1631862240982
data:{"defaultStoreId":392274,"storeName":"开发者注册商户店铺名称","cityName":"北京市","goodType":1,"address":"北京海淀区东升科技国际园","addressDetail":"2层","latitude":40.047858,"longitude":116.378424,"contactPhone":"16700000000","frontIdcard":"https://file-cstable.bingex.com/cstableTest/merchant_storage/2021/09/17/109b25e2-5f6c-45aa-a187-8488ab33f87e.png","reverseIdcard":"https://file-cstable.bingex.com/cstableTest/merchant_storage/2021/09/17/109b25e2-5f6c-45aa-a187-8488ab33f87e.png","businessLicense":"https://file-cstable.bingex.com/cstableTest/merchant_storage/2021/09/17/109b25e2-5f6c-45aa-a187-8488ab33f87e.png","facade":"https://file-cstable.bingex.com/cstableTest/merchant_storage/2021/09/17/109b25e2-5f6c-45aa-a187-8488ab33f87e.png"}
sign:19E0F0DE27644F5DAE091BA973896F55
- 出参示例{
"status": 200,
"msg": null,
"data": true
}

