新增商户(平安付更新)
<p><strong>简要描述:</strong> </p>
<ul>
<li>新增商户接口</li>
</ul>
<p>作者 :夏杨</p>
<p><strong>请求URL:</strong> </p>
<ul>
<li><code>/api-merchant/merchant/addMerchant</code></li>
</ul>
<p><strong>请求方式:</strong></p>
<ul>
<li>POST </li>
</ul>
<p><strong>Content-type:</strong></p>
<ul>
<li>Application/json</li>
</ul>
<p><strong>参数:</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">merchantName</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>商户名称</td>
</tr>
<tr>
<td style="text-align: left;">merchantShortName</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>商户简称</td>
</tr>
<tr>
<td style="text-align: left;">merchantType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>商户类型</td>
</tr>
<tr>
<td style="text-align: left;">businessLicenseNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>营业执照编号</td>
</tr>
<tr>
<td style="text-align: left;">customerServicePhone</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>客服电话</td>
</tr>
<tr>
<td style="text-align: left;">orgCodeCertificate</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>组织机构代码证</td>
</tr>
<tr>
<td style="text-align: left;">taxRegistrationCertificate</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>税务登记证</td>
</tr>
<tr>
<td style="text-align: left;">legalPersonName</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>法人姓名</td>
</tr>
<tr>
<td style="text-align: left;">documentType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>证件类型</td>
</tr>
<tr>
<td style="text-align: left;">documentNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>证件号码</td>
</tr>
<tr>
<td style="text-align: left;">contactName</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>联系人姓名</td>
</tr>
<tr>
<td style="text-align: left;">contactMobile</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>联系人手机</td>
</tr>
<tr>
<td style="text-align: left;">province</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>注册地址(省)</td>
</tr>
<tr>
<td style="text-align: left;">city</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>注册地址(市)</td>
</tr>
<tr>
<td style="text-align: left;">address</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>注册地址(详细地址)</td>
</tr>
<tr>
<td style="text-align: left;">merchantManageType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>商户经营分类(一级分类)</td>
</tr>
<tr>
<td style="text-align: left;">merchantManageSubType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>商户经营分类(二级分类)</td>
</tr>
<tr>
<td style="text-align: left;">merchantManageThirdType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>商户经营分类(三级分类)</td>
</tr>
<tr>
<td style="text-align: left;">accountType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>账户类型</td>
</tr>
<tr>
<td style="text-align: left;">accountName</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>账户名称</td>
</tr>
<tr>
<td style="text-align: left;">accountNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>帐号</td>
</tr>
<tr>
<td style="text-align: left;">bankDeposit</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>开户行</td>
</tr>
<tr>
<td style="text-align: left;">bankDepositBranch</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>开户支行</td>
</tr>
<tr>
<td style="text-align: left;">businessLicenseUrl</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>营业执照Url</td>
</tr>
<tr>
<td style="text-align: left;">orgCodeCertificateUrl</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>组织机构代码证Url</td>
</tr>
<tr>
<td style="text-align: left;">taxRegistrationCertificateUrl</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>税务登记证</td>
</tr>
<tr>
<td style="text-align: left;">bankAccountPermitUrl</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>银行开户许可证</td>
</tr>
<tr>
<td style="text-align: left;">legalPersonCardFrontUrl</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>法人身份证正面</td>
</tr>
<tr>
<td style="text-align: left;">legalPersonCardReverseUrl</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>法人身份证反面</td>
</tr>
<tr>
<td style="text-align: left;">legalPersonCardHandUrl</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>法人手持身份证照片</td>
</tr>
<tr>
<td style="text-align: left;">merchantBusinessUrl</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>商户经营场所照</td>
</tr>
<tr>
<td style="text-align: left;">merchantDoorPhotoUrl</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>商户门头照</td>
</tr>
<tr>
<td style="text-align: left;">merchantCashierDeskPhotoUrl</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>商户收银台照</td>
</tr>
<tr>
<td style="text-align: left;">merchantManagerName</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>商户经理姓名</td>
</tr>
<tr>
<td style="text-align: left;">merchantManagerMobile</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>商户经理联系方式</td>
</tr>
<tr>
<td style="text-align: left;">businessLicenseValidTime</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">date</td>
<td>营业执照有效时间</td>
</tr>
<tr>
<td style="text-align: left;">contactType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>联系人类型</td>
</tr>
<tr>
<td style="text-align: left;">contactCertType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>联系人证件类型</td>
</tr>
<tr>
<td style="text-align: left;">contactCertNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>联系人证件号码</td>
</tr>
<tr>
<td style="text-align: left;">contactMail</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>联系人邮箱</td>
</tr>
<tr>
<td style="text-align: left;">area</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>注册地址(地区)</td>
</tr>
<tr>
<td style="text-align: left;">bankCode</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>开户行编号</td>
</tr>
<tr>
<td style="text-align: left;">merchantLineStatus</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>线上线下</td>
</tr>
<tr>
<td style="text-align: left;">settleType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>结算类型</td>
</tr>
<tr>
<td style="text-align: left;">settleCycle</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>结算周期`</td>
</tr>
<tr>
<td style="text-align: left;">issuer</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>联行号</td>
</tr>
<tr>
<td style="text-align: left;">merchantCashierDesks</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">List<MerchantCashierDesk></td>
<td>收银台信息</td>
</tr>
<tr>
<td style="text-align: left;">cashierDeskType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>收银台类型</td>
</tr>
<tr>
<td style="text-align: left;">appId</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>APPID</td>
</tr>
<tr>
<td style="text-align: left;">alipayId</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>支付宝PID</td>
</tr>
<tr>
<td style="text-align: left;">noticeAddress</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>通知地址</td>
</tr>
<tr>
<td style="text-align: left;">protocolPhotoUrls</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">List<String></td>
<td>协议照片信息</td>
</tr>
<tr>
<td style="text-align: left;">applyUrls</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">List<String></td>
<td>申请表照片信息</td>
</tr>
<tr>
<td style="text-align: left;">otherUrls</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">List<String></td>
<td>其他照片信息</td>
</tr>
<tr>
<td style="text-align: left;">merchantPayProducts</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">List<MerchantPayProduct></td>
<td>支付产品信息</td>
</tr>
<tr>
<td style="text-align: left;">productId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>产品ID</td>
</tr>
<tr>
<td style="text-align: left;">productNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>产品编号</td>
</tr>
<tr>
<td style="text-align: left;">cashierDeskType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>收银台类型</td>
</tr>
<tr>
<td style="text-align: left;">openStatus</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>是否开通</td>
</tr>
<tr>
<td style="text-align: left;">payProductRate</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>费率</td>
</tr>
<tr>
<td style="text-align: left;">businessLicenseEffDate</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">date</td>
<td><code>营业执照生效时间</code></td>
</tr>
<tr>
<td style="text-align: left;">establishDate</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">date</td>
<td><code>成立时间</code></td>
</tr>
<tr>
<td style="text-align: left;">identityEffDate</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">date</td>
<td><code>法人身份证有效期开始时间</code></td>
</tr>
<tr>
<td style="text-align: left;">identityValDate</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">date</td>
<td><code>法人身份证有效期到期时间</code></td>
</tr>
<tr>
<td style="text-align: left;">subIndustryId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td><code>二级行业编号</code></td>
</tr>
<tr>
<td style="text-align: left;">bankPhone</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td><code>银行卡预留手机号</code></td>
</tr>
<tr>
<td style="text-align: left;">electronicSignPath</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td><code>电子签名照片</code></td>
</tr>
</tbody>
</table>
<p><strong>返回示例</strong></p>
<pre><code> {
"code": 200,
"msg":"新增商户信息成功!",
"data":null
}</code></pre>
<p><strong>返回参数说明</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">code</td>
<td style="text-align: left;">int</td>
<td>返回码</td>
</tr>
<tr>
<td style="text-align: left;">msg</td>
<td style="text-align: left;">String</td>
<td>消息</td>
</tr>
<tr>
<td style="text-align: left;">data</td>
<td style="text-align: left;">Object</td>
<td>返回数据</td>
</tr>
</tbody>
</table>
<p><strong>返回码说明</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">返回码</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">200</td>
<td>成功</td>
</tr>
<tr>
<td style="text-align: left;">500</td>
<td>失败</td>
</tr>
<tr>
<td style="text-align: left;">400</td>
<td>系统异常</td>
</tr>
<tr>
<td style="text-align: left;">300</td>
<td>统一的参数异常(具体内容以返回结果为准)</td>
</tr>
<tr>
<td style="text-align: left;">50001</td>
<td>联系人手机号码已存在</td>
</tr>
<tr>
<td style="text-align: left;">50002</td>
<td>用户名已存在</td>
</tr>
</tbody>
</table>
<p><strong>参数示例</strong> </p>
<pre><code>{
"merchantName":"测试商户011",
"merchantShortName":"Test Merchant 011",
"merchantType":1,
"businessLicenseNo":"ddddd1ds",
"customerServicePhone":"15973143444",
"orgCodeCertificate":"dddddd",
"taxRegistrationCertificate":"dddddd",
"legalPersonName":"dddddd",
"documentType":1,
"documentNo":"430623199011162408",
"contactName":"dddddd",
"contactMobile":"15973141520",
"province":1,
"city":1,
"address":"dddddd",
"merchantManageType":1,
"merchantManageSubType":11,
"merchantManageThirdType":545,
"accountType":1,
"accountName":"dddddd",
"accountNo":"dddddd",
"bankDeposit":1,
"bankDepositBranch":1,
"businessLicenseUrl":"dddddd",
"orgCodeCertificateUrl":"dddddd",
"taxRegistrationCertificateUrl":"dddddd",
"bankAccountPermitUrl":"dddddd",
"legalPersonCardFrontUrl":"dddddd",
"legalPersonCardReverseUrl":"dddddd",
"legalPersonCardHandUrl":"dddddd",
"merchantBusinessUrl":"dddddd",
"merchantDoorPhotoUrl":"dddddd",
"merchantCashierDeskPhotoUrl":"dddddd",
"merchantManagerName":"dddddd",
"merchantManagerMobile":"15973143444",
"merchantCashierDesks":[
{
"cashierDeskType":1,
"appId":"dddddd",
"alipayId":"dddddd",
"noticeAddress":"dddddd"
},
{
"cashierDeskType":2
}
],
"merchantPayProducts":[
{
"productId":1,
"productNo":"WECHAT_SCAN",
"cashierDeskType":1,
"openStatus":1,
"payProductRate":"0.11"
},
{
"productId":2,
"productNo":"WECHAT_GZH",
"cashierDeskType":1,
"openStatus":1,
"payProductRate":"0.11"
},
{
"productId":3,
"productNo":"ALIPAY_SCAN",
"cashierDeskType":1,
"openStatus":1,
"payProductRate":"0.11"
}
],
"protocolPhotoUrls":["dddddd-1","dddddd-2","dddddd-3"],
"applyUrls":["dddddd-1","dddddd-2","dddddd-3"],
"otherUrls":["dddddd-1","dddddd-2","dddddd-3"],
"businessLicenseValidTime":"2040-09-30",
"contactType":1,
"contactCertType":1,
"contactCertNo":"430623199011162418",
"contactMail":"381168586@qq.com",
"area":430100,
"bankCode":"ICBC",
"merchantLineStatus":2,
"settleType":1,
"settleCycle":1,
"issuer":"x381168586"
}</code></pre>
<p><strong>备注</strong> </p>
<ul>
<li>具体的的返回码、消息、返回数据,以具体的返回结果为准</li>
</ul>