更新商户信息
<p><strong>接口描述:</strong> </p>
<ul>
<li>服务商可调用此接口修改商户资料。</li>
<li>存在少数字段商户创建后即固定,无法修改,如:<code>merchant_name_business</code>,<code>merchant_type</code>等。</li>
<li>少部分通道不支持接口创建和修改,配置了这部分通道的商户,更新的数据无法同步到通道,如需修改请联系运营走人工流程。</li>
</ul>
<p><strong>接口URL:</strong> </p>
<ul>
<li>生产 <code>https://open.gdyfsk.com/yfpay/api/merchant/update</code></li>
<li>测试 <code>https://test.gdyfsk.com/yfpay/api/merchant/update</code></li>
</ul>
<p><strong>请求方式:</strong></p>
<ul>
<li>POST</li>
</ul>
<p><strong>请求头部:</strong></p>
<table>
<thead>
<tr>
<th>标签</th>
<th>必填</th>
<th>内容</th>
</tr>
</thead>
<tbody>
<tr>
<td>Content-Type</td>
<td>是</td>
<td>application/json</td>
</tr>
</tbody>
</table>
<p><strong>请求参数:</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: center;">类型</th>
<th style="text-align: center;">必填</th>
<th style="text-align: left;">说明</th>
<th>参数示例</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">inst_no</td>
<td style="text-align: center;">String(32)</td>
<td style="text-align: center;">是</td>
<td style="text-align: left;">合作机构号</td>
<td>60000001</td>
</tr>
<tr>
<td style="text-align: left;">trace_no</td>
<td style="text-align: center;">String(32)</td>
<td style="text-align: center;">是</td>
<td style="text-align: left;">请求流水号</td>
<td>20200501120000</td>
</tr>
<tr>
<td style="text-align: left;">merchant_no</td>
<td style="text-align: center;">String(32)</td>
<td style="text-align: center;">是</td>
<td style="text-align: left;">商户号</td>
<td>851901070001</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: center;">String(32)</td>
<td style="text-align: center;">是</td>
<td style="text-align: left;">签名字符串</td>
<td>8a9bd64e67f3d2380167f3ef7f990001</td>
</tr>
<tr>
<td style="text-align: left;">- 商户基础信息</td>
</tr>
<tr>
<td style="text-align: left;">merchant_name</td>
<td style="text-align: center;">String(80)</td>
<td style="text-align: center;">商户名称</td>
<td style="text-align: left;">super超市六号</td>
</tr>
<tr>
<td style="text-align: left;">merchant_name_short</td>
<td style="text-align: center;">String(40)</td>
<td style="text-align: center;">商户简称</td>
<td style="text-align: left;">super超市</td>
</tr>
<tr>
<td style="text-align: left;">merchant_mcc_code</td>
<td style="text-align: center;">String(4)</td>
<td style="text-align: center;">商户行业类目code</td>
<td style="text-align: left;">204</td>
</tr>
<tr>
<td style="text-align: left;">contact_name</td>
<td style="text-align: center;">String(20)</td>
<td style="text-align: center;">商户签约负责人</td>
<td style="text-align: left;">张三</td>
</tr>
<tr>
<td style="text-align: left;">contact_phone</td>
<td style="text-align: center;">String(30)</td>
<td style="text-align: center;">商户签约负责人电话</td>
<td style="text-align: left;">13566668888</td>
</tr>
<tr>
<td style="text-align: left;">contact_email</td>
<td style="text-align: center;">String(50)</td>
<td style="text-align: center;">商户签约负责人邮箱</td>
<td style="text-align: left;">abc@163.com</td>
</tr>
<tr>
<td style="text-align: left;">contact_service</td>
<td style="text-align: center;">String(30)</td>
<td style="text-align: center;">商户客服电话</td>
<td style="text-align: left;">13566668888</td>
</tr>
<tr>
<td style="text-align: left;">address_province</td>
<td style="text-align: center;">String(3)</td>
<td style="text-align: center;">商户地址省code</td>
<td style="text-align: left;">420</td>
</tr>
<tr>
<td style="text-align: left;">address_city</td>
<td style="text-align: center;">String(4)</td>
<td style="text-align: center;">商户地址市code</td>
<td style="text-align: left;">5210</td>
</tr>
<tr>
<td style="text-align: left;">address_county</td>
<td style="text-align: center;">String(4)</td>
<td style="text-align: center;">商户地址区县code</td>
<td style="text-align: left;">5217</td>
</tr>
<tr>
<td style="text-align: left;">address_street</td>
<td style="text-align: center;">String(200)</td>
<td style="text-align: center;">商户地址具体街道门牌号</td>
<td style="text-align: left;">软件园</td>
</tr>
<tr>
<td style="text-align: left;">license_type</td>
<td style="text-align: center;">String(2)</td>
<td style="text-align: center;">营业执照类型</td>
<td style="text-align: left;">1三证合一</td>
</tr>
<tr>
<td style="text-align: left;">license_no</td>
<td style="text-align: center;">String(18)</td>
<td style="text-align: center;">营业执照编号</td>
<td style="text-align: left;">450423199009296666</td>
</tr>
<tr>
<td style="text-align: left;">license_expire</td>
<td style="text-align: center;">String(8)</td>
<td style="text-align: center;">营业执照有效期(格式YYYYMMDD)</td>
<td style="text-align: left;">20190101</td>
</tr>
<tr>
<td style="text-align: left;">- 结算信息</td>
</tr>
<tr>
<td style="text-align: left;">account_type</td>
<td style="text-align: center;">String(4)</td>
<td style="text-align: center;">是</td>
<td style="text-align: left;">账户类型</td>
<td>1对公结算 2法人对私结算 3非法人对私结算</td>
</tr>
<tr>
<td style="text-align: left;">legal_name</td>
<td style="text-align: center;">String(10)</td>
<td style="text-align: center;">法人名称</td>
<td style="text-align: left;">张三</td>
</tr>
<tr>
<td style="text-align: left;">legal_cert_no</td>
<td style="text-align: center;">String(30)</td>
<td style="text-align: center;">法人证件号</td>
<td style="text-align: left;">420123199504211354</td>
</tr>
<tr>
<td style="text-align: left;">legal_cert_expire</td>
<td style="text-align: center;">String(8)</td>
<td style="text-align: center;">法人证件有效期(格式YYYYMMDD)</td>
<td style="text-align: left;">20190101</td>
</tr>
<tr>
<td style="text-align: left;">account_idcard_num</td>
<td style="text-align: center;">String(30)</td>
<td style="text-align: center;">持卡人身份证号</td>
<td style="text-align: left;">420123199504211354</td>
</tr>
<tr>
<td style="text-align: left;">account_idcard_expire</td>
<td style="text-align: center;">String(8)</td>
<td style="text-align: center;">持卡人身份证有效期(格式YYYYMMDD)</td>
<td style="text-align: left;">20190101</td>
</tr>
<tr>
<td style="text-align: left;">account_card_name</td>
<td style="text-align: center;">String(100)</td>
<td style="text-align: center;">结算卡账户名</td>
<td style="text-align: left;">张三</td>
</tr>
<tr>
<td style="text-align: left;">account_card_num</td>
<td style="text-align: center;">String(30)</td>
<td style="text-align: center;">结算卡卡号</td>
<td style="text-align: left;">6217231302004313888</td>
</tr>
<tr>
<td style="text-align: left;">account_card_phone</td>
<td style="text-align: center;">String(30)</td>
<td style="text-align: center;">结算卡预留手机号</td>
<td style="text-align: left;">13566668888</td>
</tr>
<tr>
<td style="text-align: left;">account_bank_code</td>
<td style="text-align: center;">String(25)</td>
<td style="text-align: center;">结算银行支行联行号</td>
<td style="text-align: left;">103651081044</td>
</tr>
<tr>
<td style="text-align: left;">rate_code</td>
<td style="text-align: center;">String(5)</td>
<td style="text-align: center;">费率模板</td>
<td style="text-align: left;">RT0045</td>
</tr>
<tr>
<td style="text-align: left;">- 资质图片</td>
</tr>
<tr>
<td style="text-align: left;">picture_license</td>
<td style="text-align: center;">String(255)</td>
<td style="text-align: center;">营业执照(或持件人照片)</td>
<td style="text-align: left;"><a href="http://www.abc.com/picture/xxx.jpg">http://www.abc.com/picture/xxx.jpg</a></td>
</tr>
<tr>
<td style="text-align: left;">picture_idcard_a</td>
<td style="text-align: center;">String(255)</td>
<td style="text-align: center;">负责人身份证正面</td>
<td style="text-align: left;"><a href="http://www.abc.com/picture/xxx.jpg">http://www.abc.com/picture/xxx.jpg</a></td>
</tr>
<tr>
<td style="text-align: left;">picture_idcard_b</td>
<td style="text-align: center;">String(255)</td>
<td style="text-align: center;">负责人身份证反面</td>
<td style="text-align: left;"><a href="http://www.abc.com/picture/xxx.jpg">http://www.abc.com/picture/xxx.jpg</a></td>
</tr>
<tr>
<td style="text-align: left;">picture_bankcard_a</td>
<td style="text-align: center;">String(255)</td>
<td style="text-align: center;">银行卡正面</td>
<td style="text-align: left;"><a href="http://www.abc.com/picture/xxx.jpg">http://www.abc.com/picture/xxx.jpg</a></td>
</tr>
<tr>
<td style="text-align: left;">picture_bankcard_b</td>
<td style="text-align: center;">String(255)</td>
<td style="text-align: center;">银行卡反面</td>
<td style="text-align: left;"><a href="http://www.abc.com/picture/xxx.jpg">http://www.abc.com/picture/xxx.jpg</a></td>
</tr>
<tr>
<td style="text-align: left;">picture_outside</td>
<td style="text-align: center;">String(255)</td>
<td style="text-align: center;">门头照片</td>
<td style="text-align: left;"><a href="http://www.abc.com/picture/xxx.jpg">http://www.abc.com/picture/xxx.jpg</a></td>
</tr>
<tr>
<td style="text-align: left;">picture_inside</td>
<td style="text-align: center;">String(255)</td>
<td style="text-align: center;">内部前台照片</td>
<td style="text-align: left;"><a href="http://www.abc.com/picture/xxx.jpg">http://www.abc.com/picture/xxx.jpg</a></td>
</tr>
<tr>
<td style="text-align: left;">picture_tripartite</td>
<td style="text-align: center;">String(255)</td>
<td style="text-align: center;">三联单合同照片</td>
<td style="text-align: left;"><a href="http://www.abc.com/picture/xxx.jpg">http://www.abc.com/picture/xxx.jpg</a></td>
</tr>
<tr>
<td style="text-align: left;">picture_idcard_hander</td>
<td style="text-align: center;">String(255)</td>
<td style="text-align: center;">手持身份证</td>
<td style="text-align: left;"><a href="http://www.abc.com/picture/xxx.jpg">http://www.abc.com/picture/xxx.jpg</a></td>
</tr>
<tr>
<td style="text-align: left;">picture_open_account</td>
<td style="text-align: center;">String(255)</td>
<td style="text-align: center;">开户许可证照片</td>
<td style="text-align: left;"><a href="http://www.abc.com/picture/xxx.jpg">http://www.abc.com/picture/xxx.jpg</a></td>
</tr>
<tr>
<td style="text-align: left;">picture_organization</td>
<td style="text-align: center;">String(255)</td>
<td style="text-align: center;">组织机构代码证照片</td>
<td style="text-align: left;"><a href="http://www.abc.com/picture/xxx.jpg">http://www.abc.com/picture/xxx.jpg</a></td>
</tr>
<tr>
<td style="text-align: left;">picture_tax_registration</td>
<td style="text-align: center;">String(255)</td>
<td style="text-align: center;">税务登记证照片</td>
<td style="text-align: left;"><a href="http://www.abc.com/picture/xxx.jpg">http://www.abc.com/picture/xxx.jpg</a></td>
</tr>
<tr>
<td style="text-align: left;">picture_unincorporated</td>
<td style="text-align: center;">String(255)</td>
<td style="text-align: center;">入账非法人证明照片</td>
<td style="text-align: left;"><a href="http://www.abc.com/picture/xxx.jpg">http://www.abc.com/picture/xxx.jpg</a></td>
</tr>
<tr>
<td style="text-align: left;">picture_bank_idcard_a</td>
<td style="text-align: center;">String(255)</td>
<td style="text-align: center;">对私账户身份证正面照片</td>
<td style="text-align: left;"><a href="http://www.abc.com/picture/xxx.jpg">http://www.abc.com/picture/xxx.jpg</a></td>
</tr>
<tr>
<td style="text-align: left;">picture_bank_idcard_b</td>
<td style="text-align: center;">String(255)</td>
<td style="text-align: center;">对私账户身份证反面照片</td>
<td style="text-align: left;"><a href="http://www.abc.com/picture/xxx.jpg">http://www.abc.com/picture/xxx.jpg</a></td>
</tr>
<tr>
<td style="text-align: left;">picture_other</td>
<td style="text-align: center;">String(255)</td>
<td style="text-align: center;">其他证明材料(选填)</td>
<td style="text-align: left;"><a href="http://www.abc.com/picture/xxx.jpg">http://www.abc.com/picture/xxx.jpg</a></td>
</tr>
</tbody>
</table>
<ul>
<li>注:此接口更新模式为增量更新,请求参数有值则更新,请求参数无值则保持原数据</li>
</ul>
<p><strong>请求示例:</strong></p>
<pre><code class="language-json">{
&quot;inst_no&quot;:&quot;900084&quot;,
&quot;sign&quot;:&quot;6FE747B7E0056895EA34F415B7381B77&quot;,
&quot;trace_no&quot;:&quot;123456&quot;,
&quot;merchant_no&quot;:&quot;851901160006&quot;,
&quot;merchant_name&quot;:&quot;商户修改&quot;
}</code></pre>
<p><strong>返回参数:</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: center;">类型</th>
<th style="text-align: center;">必填</th>
<th style="text-align: left;">说明</th>
<th>参数示例</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">inst_no</td>
<td style="text-align: center;">String(32)</td>
<td style="text-align: center;">是</td>
<td style="text-align: left;">合作机构号</td>
<td>60000001</td>
</tr>
<tr>
<td style="text-align: left;">result_code</td>
<td style="text-align: center;">String(20)</td>
<td style="text-align: center;">是</td>
<td style="text-align: left;">操作结果</td>
<td>SUCCESS</td>
</tr>
<tr>
<td style="text-align: left;">result_msg</td>
<td style="text-align: center;">String(100)</td>
<td style="text-align: center;">是</td>
<td style="text-align: left;">操作结果说明</td>
<td>操作成功</td>
</tr>
<tr>
<td style="text-align: left;">shoubei_merchant_no</td>
<td style="text-align: center;">String(32)</td>
<td style="text-align: center;">平台商户号(操作成功时返回)</td>
<td style="text-align: left;">851901070001</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: center;">String(32)</td>
<td style="text-align: center;">签名字符串(操作成功时返回)</td>
<td style="text-align: left;">8a9bd64e67f3d2380167f3ef7f990001</td>
</tr>
</tbody>
</table>
<p><strong>返回示例:</strong></p>
<pre><code class="language-json">{
&quot;inst_no&quot;:&quot;900084&quot;,
&quot;result_code&quot;:&quot;SUCCESS&quot;,
&quot;result_msg&quot;:&quot;操作成功&quot;,
&quot;shoubei_merchant_no&quot;:&quot;851901070001&quot;,
&quot;sign&quot;:&quot;sign&quot;
}</code></pre>