13:注册闪送商户

2021年11月05日

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
}



关键词: