点击拨号商户管理接口文档V3.0

1 简介

 本文档适用于代理商对商户进行操作的接口调用，主要包含了商户新增、商户部分信息修改、商户备案材料上传。    

 文档中所有未标明请求方式的接口皆为POST方式调用。 

 接口访问需要添加IP白名单，请联系我司相关支撑人员。

2 公共请求头 Authorization

Authorization为“APPID:timestamp:sign”字符串的Base64编码值，其中冒号为半角。

请求头示例如下：

POST   v1/merchant/update
Content-Type:multipart/form-data
Authorization:
MTY5NjA1NDMwOTk2OTEwNDg5ODoxNjkzMjcwMjI2NjQyOmFhNzI2MzlhODY4NDljM2MyZTJiZjljMmVjYzExOTdi

Authorization的生成构成

示例代码

sign = DigestUtil.md5Hex(APPID+":"+APPSECRET+":"+timestamp)

3 接口说明

3.0  接口域名(BaseUrl)

http://mt.v3.quanmayun.com:8090

3.1 新增商户

请求地址：
{BaseUrl}/v1/merchant/create
Authorization : Content-Type: multipart/form-data

请求参数：

返回参数

请求消息示例如下：

POST {BaseUrl}/v1/merchant/create
Content-Type: multipart/form-data
Authorization :
MTY5NjA1NDMwOTk2OTEwNDg5ODoxNjkzMjcwMjI2NjQyOmFhNzI2MzlhODY4NDljM2MyZTJiZjljMmVjYzExOTdi

{
merchant:{
"name":"山水科技",
"districtName":"江苏省",
"address":"江苏省南京市玄武区XXXXXXX",
"oldCustomer":1,
"creditCode":"7965136547",
"idcardName":"李四",
"idcardNumber":"320896569563244562",
"phone":"15263959874",
"bankName":"工商银行",
"bankAccount":"5626325741415263",
"dataSource":"公司官网",
"sceneDescription":"衣服干洗、鞋靴清洁、箱包养护等服务",
"speechcraft":"销售：xxx，您好，我是xx软件的xx，你之前有来咨询过客户开发营销管理软件，我们最近出了新功能跟数据，您看明天上午10点还是下午2点有时间？我们带电脑过去给您再做个详细了解。
客户:你们都有什么功能啊
销售：我们系统功能是比较全面的，从获客，营销到客户管理 以及后续的报价 订单 合同一系列流程都有的，包括工厂erp也是有的，您明天方便的话我去拜访您 给您当面演示一下吧"}

Img: 营业执照pdf文件

idcardPic: 法人身份证（正反面）pdf文件

officePic: 办公室及门头照片pdf文件

attachment: 其他材料附件zip/rar/7z文件

}

响应消息示例如下：

{
 "code": 200,
 "success": true,
 "data": {},
 "msg": "操作成功"
 }

{
    "code": 4104,
    "success": false,
    "data": {},
    "msg": "系统：来源IP不在应用的IP白名单里"
}

POST {BaseUrl}/v1/merchant/update
Content-Type: multipart/form-data
Authorization :
MTY5NjA1NDMwOTk2OTEwNDg5ODoxNjkzMjcwMjI2NjQyOmFhNzI2MzlhODY4NDljM2MyZTJiZjljMmVjYzExOTdi

{
merchant:{
"name":"山水科技",
"address":"江苏省南京市玄武区XXXXXXX",
"creditCode":"7965136547",
"idcardName":"李四",
"idcardNumber":"320896569563244562",
"phone":"15263959874",
"bankName":"工商银行",
"bankAccount":"5626325741415263",
"dataSource":"公司官网",
"sceneDescription":"衣服干洗、鞋靴清洁、箱包养护等服务"}

Img: 营业执照pdf文件

idcardPic: 法人身份证（正反面）pdf文件

officePic: 办公室及门头照片pdf文件

}

{
 "code": 200,
 "success": true,
 "data": {},
 "msg": "操作成功"
 }

{
    "code": 4104,
    "success": false,
    "data": {},
    "msg": "系统：来源IP不在应用的IP白名单里"
}

POST {BaseUrl}/v1/merchant/record
Content-Type: multipart/form-data
Authorization :
MTY5NjA1NDMwOTk2OTEwNDg5ODoxNjkzMjcwMjI2NjQyOmFhNzI2MzlhODY4NDljM2MyZTJiZjljMmVjYzExOTdi

{
merchant:{"name":"山水科技"}

applicationFile : 点击拨号业务申请书 pdf文件

commitmentFile: 点击拨号业务承诺书pdf文件

}

{
 "code": 200,
 "success": true,
 "data": {},
 "msg": "操作成功"
 }