先锋-商户报备
<p><strong>简要描述:</strong> </p>
<ul>
<li>先锋商户报备</li>
</ul>
<p><strong>请求URL:</strong> </p>
<ul>
<li><code>http://192.168.0.188:9200/router-center/xf/merchant/merReport</code></li>
</ul>
<p><strong>请求方式:</strong></p>
<ul>
<li>POST </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>
<th>缺失情况</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">reportFlowId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>报备流水号</td>
<td>需要生成规则</td>
</tr>
<tr>
<td style="text-align: left;">subMerId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>平台子商户ID</td>
<td>需要生成规则</td>
</tr>
<tr>
<td style="text-align: left;">orgNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>机构编号</td>
<td>对应子商户号</td>
</tr>
<tr>
<td style="text-align: left;">fullName</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>企业名称</td>
</tr>
<tr>
<td style="text-align: left;">subMerType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Integer</td>
<td>报备类型(0是个体1是个人2是企业</td>
</tr>
<tr>
<td style="text-align: left;">shortName</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>企业简称</td>
</tr>
<tr>
<td style="text-align: left;">certType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>证件类型(BLC营业执照USCC,统一信用代码证,IDC身份证号)</td>
</tr>
<tr>
<td style="text-align: left;">certNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>证件号</td>
</tr>
<tr>
<td style="text-align: left;">customerHotline</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;">String</td>
<td>省</td>
</tr>
<tr>
<td style="text-align: left;">city</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;">String</td>
<td>区</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;">contactType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>联系人类型(LEGAL_PERSON:法人;CONTROLLER: 实际控制人;AGENT:代理人;OTHER:其他)</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;">contactCertType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>联系人证件类型(IDC身份证号BLC营业执照USCC统一信用代码证)</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>
<td>缺失</td>
</tr>
<tr>
<td style="text-align: left;">contactPhone</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>联系人电话</td>
</tr>
<tr>
<td style="text-align: left;">contactEmail</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>联系人邮箱</td>
<td>缺失</td>
</tr>
<tr>
<td style="text-align: left;">bankName</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</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>
<td>缺失</td>
</tr>
<tr>
<td style="text-align: left;">bankCardType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Integer</td>
<td>账户类型(1是对私2是对公)</td>
</tr>
<tr>
<td style="text-align: left;">bankCardName</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>银行账户名称</td>
</tr>
<tr>
<td style="text-align: left;">bankCardno</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>银行账号</td>
</tr>
<tr>
<td style="text-align: left;">onOroff</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>线上线下(ON,OFF)</td>
<td>缺失</td>
</tr>
<tr>
<td style="text-align: left;">business</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>行业</td>
<td>缺失</td>
</tr>
<tr>
<td style="text-align: left;">settleType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>结算类型(D 自然日,T工作日,W周,M月)</td>
<td>缺失</td>
</tr>
<tr>
<td style="text-align: left;">settleCycle</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Integer</td>
<td>结算周期</td>
<td>缺失</td>
</tr>
<tr>
<td style="text-align: left;">callbackUrl</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>回调通知地址</td>
<td>缺失</td>
</tr>
<tr>
<td style="text-align: left;">mchtLicnExpDate</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>执照有效期</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>
<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>公众号id(报备产品类型是微信正反扫必传)</td>
<td>缺失</td>
</tr>
<tr>
<td style="text-align: left;">authInfo</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>授权目录(报备产品类型是微信公众号必传)</td>
<td>缺失</td>
</tr>
<tr>
<td style="text-align: left;">reportBusiFee</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>报备产品信息(json格式的list集合)</td>
<td>待确定</td>
</tr>
</tbody>
</table>
<p><strong>reportBusiFee信息如下</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>
<th>缺失情况</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">reportProduct</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>报备产品类型</td>
<td>现有六种类型</td>
</tr>
<tr>
<td style="text-align: left;">elecProtocolNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>电子协议签约号</td>
<td>规则生成</td>
</tr>
<tr>
<td style="text-align: left;">channelIdPid</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>微信、QQ的渠道号或支付宝的PID</td>
<td>固定</td>
</tr>
<tr>
<td style="text-align: left;">channelMchId</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>渠道方子商户号(当报备产品类型为trade.wxpay.onlineapppay时,必输)</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>公众号ID(报备产品类型微信正反扫时必传)</td>
<td>固定</td>
</tr>
<tr>
<td style="text-align: left;">authInfo</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>授权目录(报备产品类型是微信公众号时必传,多个以分号分隔)</td>
<td>待定</td>
</tr>
<tr>
<td style="text-align: left;">feeCharges</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">json字符串</td>
<td>计费规则(计费的费率,必须高于或等于 服务商的费率)</td>
<td>待确定</td>
</tr>
</tbody>
</table>
<p><strong>feeCharges信息如下</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>
<th>缺失情况</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">calculateType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>只支持百分比比:percent</td>
</tr>
<tr>
<td style="text-align: left;">calculateRate</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>交易金额比率(单位 % ,double类型)</td>
<td>费率</td>
</tr>
<tr>
<td style="text-align: left;">calculateMinAmount</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>计费金额最小值(整型)</td>
</tr>
<tr>
<td style="text-align: left;">calculateMaxAmount</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>计费金额最大值(整型)</td>
</tr>
</tbody>
</table>
<p><strong>返回示例</strong></p>
<pre><code> {
"msg": "成功",
"data": {
"respMsg": "处理中",
"respCode": "00"
},
"code": "200"
}</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;">respMsg</td>
<td style="text-align: left;">string</td>
<td>处理结果</td>
</tr>
<tr>
<td style="text-align: left;">respCode</td>
<td style="text-align: left;">string</td>
<td>先锋返回的请求成功的响应码</td>
</tr>
</tbody>
</table>
<p><strong>备注</strong> </p>
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>