乐收赢API

银飞乐收赢接口文档


更新商户信息

<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">{ &amp;quot;inst_no&amp;quot;:&amp;quot;900084&amp;quot;, &amp;quot;sign&amp;quot;:&amp;quot;6FE747B7E0056895EA34F415B7381B77&amp;quot;, &amp;quot;trace_no&amp;quot;:&amp;quot;123456&amp;quot;, &amp;quot;merchant_no&amp;quot;:&amp;quot;851901160006&amp;quot;, &amp;quot;merchant_name&amp;quot;:&amp;quot;商户修改&amp;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">{ &amp;quot;inst_no&amp;quot;:&amp;quot;900084&amp;quot;, &amp;quot;result_code&amp;quot;:&amp;quot;SUCCESS&amp;quot;, &amp;quot;result_msg&amp;quot;:&amp;quot;操作成功&amp;quot;, &amp;quot;shoubei_merchant_no&amp;quot;:&amp;quot;851901070001&amp;quot;, &amp;quot;sign&amp;quot;:&amp;quot;sign&amp;quot; }</code></pre>

页面列表

ITEM_HTML