5.2 商户基础信息变更

<p>[TOC]</p> <h5>简要描述</h5> <ul> <li>该接口只支持修改成功报备以后的商户的基本信息，结算卡修改不支持，修改信息将会直接同步支付宝、银联、微信三个平台信息；</li> <li> <p>接口支持请求多次，在收到错误返回或者无响应后，可以重复提交，以最后一次为基准；</p> </li> <li>针对需要人工审核的字段，接口非实时返回状态，对应的结果需要调用查询接口查询；</li> </ul> <h5>请求URL</h5> <ul> <li><code>http://pay.test.891tech.com/website/agent/isv/reportItfUpdate.action</code></li> </ul> <h5>请求方式</h5> <ul> <li>POST 【application/json】</li> </ul> <h5>请求参数</h5> <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;">bizType</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>接口类型，固定值：reportItfUpdate</td> </tr> <tr> <td style="text-align: left;">agentNo</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>代理商编号</td> </tr> <tr> <td style="text-align: left;">merchantNo</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>子商户编号</td> </tr> <tr> <td style="text-align: left;">orderNo</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>本次业务请求订单号，请保持唯一</td> </tr> <tr> <td style="text-align: left;">legalPersonId</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>法人证件号(需人工审核)</td> </tr> <tr> <td style="text-align: left;">legalPerson</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>法人名称(需人工审核)</td> </tr> <tr> <td style="text-align: left;">businessLicense</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>营业执照(需人工审核)</td> </tr> <tr> <td style="text-align: left;">signName</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>签约名(需人工审核)</td> </tr> <tr> <td style="text-align: left;">showName</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>展示名</td> </tr> <tr> <td style="text-align: left;">idCardStartDate</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>法人身份证开始日期</td> </tr> <tr> <td style="text-align: left;">idCardEndDate</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>法人身份证结束日期</td> </tr> <tr> <td style="text-align: left;">businessDateStart</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>经营起始日期</td> </tr> <tr> <td style="text-align: left;">businessDateLimit</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>经营结束日期</td> </tr> <tr> <td style="text-align: left;">regionCode</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>区代码</td> </tr> <tr> <td style="text-align: left;">mcc</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>银联mcc码</td> </tr> <tr> <td style="text-align: left;">servicePhone</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>客服联系电话</td> </tr> <tr> <td style="text-align: left;">linkman</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>联系人</td> </tr> <tr> <td style="text-align: left;">linkPhone</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>联系电话</td> </tr> <tr> <td style="text-align: left;">merchantCategory</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>经营类别</td> </tr> <tr> <td style="text-align: left;">industryTypeCode</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>行业类型编码</td> </tr> <tr> <td style="text-align: left;">microBizType</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>证书类型</td> </tr> <tr> <td style="text-align: left;">linkManId</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>联系人身份证号</td> </tr> <tr> <td style="text-align: left;">specialSignName</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>是否需要特殊处理商户名称，上游渠道会自动加入前缀，比如【个体户_AAA】 【商户_AAA】</td> </tr> <tr> <td style="text-align: left;">idType</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>法人证件类型</td> </tr> <tr> <td style="text-align: left;">serviceCodes</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>支付宝商户服务类型</td> </tr> </tbody> </table> <h5>返回示例</h5> <pre><code>{ "bizType": "reportItfUpdate", "orderNo": "20220929194700826", "agentNo": "AG00000000000012", "data": "W6/ZREwh3DMltK6P4H26UlUKIS1dmf2LLpFRcG5Gn40tJCeecp9r6An6I+BxN+lIm9ydICGgHsDUmyNgz7gf7ha+swoCZ/uV0Zb8hiL+SJo5OfRYM9xxJeWVuOHgxaISr/7TLaSBeh/R/gDQnx47EcgLPG3bGDaX7/ThzS4p4g3ShylmQGndHrecBdyV5Elj+GhkSCz8gWg1RvGri127NA==", "signature": "QfUlfBrKlR1uSDlnBeaMkYNTmVXMHcjvqog2b7flRk/dEGIdCy9zPvCI6BGJUpKl4My4j7Zyp8QYoMAhSt966Rir73HPcwU3sRMyMEkxMMAiwMNEUNXz+rhtB7ydL5Fb9iBulC4Fv9R3+lPhK3ZZrodJ1pi+DUpb9wLfzulvpiK6O7P+9m6ggYKEskL4sRnYytRJLUkArGE5oogiDjF8V8B4FXmzfIzCILcRfUSfuB5oVpgQ/JQ0j8J3YqnDBP8l+cr7ePRfnzWZ3k21wlSgKDMn/zTeWFZUpvfeCmJONoZofVeOrc4rjSTPXRV+3CKlxvSd2xido93T7b7JBlCAFA==", "retCode": "C0000", "retMsg": "成功" }</code></pre> <h5>返回参数说明</h5> <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;">merchantNo</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>子商户编号</td> </tr> <tr> <td style="text-align: left;">merchantEntryStatus</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>审核状态</td> </tr> <tr> <td style="text-align: left;">auditDate</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>审核时间</td> </tr> <tr> <td style="text-align: left;">auditMsg</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>审核信息</td> </tr> </tbody> </table> <h5>备注</h5> <ul> <li>merchantEntryStatus表示审核状态： OVERRULE：审核拒绝 AUDITED：审核通过 DOING：审核中</li> </ul>