图片上传API
<h5>接口使用描述</h5>
<pre><code> 商户可通过该接口上传进件资料中所需要的图片；
该接口以POST方式提交表单，格式为multipart/form-data，非报文形式提交；
提交成功后，联富通将返回图片的识别码。商户须在“普通商户开户及进件申请”接口中填写对应的图片识别码；
图片大小限制在2M以内；
图片内容将以二进制数据的形式发送，可参考提供的传输样例；
限定请求频率，防止恶意调用。</code></pre>
<h5>接口调用方法</h5>
<pre><code> 服务器请求地址：http://newfront.liantuobank.com/NewFront/base/gateway.in
接口service：common.upload </code></pre>
<h4>请求head参数<img src='https://www.showdoc.cc/server/api/common/visitfile/sign/bfc24f8d7eb93fae8e66d4ab2b4bc461?showdoc=.jpg' align='right' style=' width:300px;height:100 px'/></h4>
<table>
<thead>
<tr>
<th><strong>NO</strong></th>
<th><strong>字段</strong></th>
<th><strong>名称</strong></th>
<th><strong>长度</strong></th>
<th><strong>必填</strong></th>
<th><strong>示例</strong></th>
<th><strong>说明</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>1</td>
<td>service</td>
<td>接口名称</td>
<td>string(32)</td>
<td>Y</td>
<td>common.upload</td>
<td>请求服务器时必填，通过此字段区分调用的是不同的方法 此接口为common.upload</td>
</tr>
<tr>
<td>2</td>
<td>version</td>
<td>版本号</td>
<td>string</td>
<td>Y</td>
<td>1.0</td>
<td>默认填写1.0，有新版本更新时会在API版本里面更新通知</td>
</tr>
<tr>
<td>3</td>
<td>channel_partner_id</td>
<td>联富通渠道合作编号(开通代理商账号时，联富通商务提供)</td>
<td>string(32)</td>
<td>Y</td>
<td>17052418193857300</td>
<td>渠道合作编号。用于标识调用方身份 该编号将由联富通创建并告知代理商。</td>
</tr>
<tr>
<td>4</td>
<td>platform_merchant_no</td>
<td>联富通平台商户编号(开通代理商账号时，联富通商务提供)</td>
<td>string(32)</td>
<td>Y</td>
<td>EW_N2320993253</td>
<td>联富通平台商户编号 该编号将由联富通创建并告知商户</td>
</tr>
<tr>
<td>5</td>
<td>sign</td>
<td>签名“<a href="https://www.showdoc.cc/liantuofu?page_id=920283467127694">签名规则</a>”</td>
<td>string</td>
<td>Y</td>
<td>1b70687c8a4c72f50c749baf95a482c0</td>
<td>MD5加密验签值。具体参见“<a href="https://www.showdoc.cc/liantuofu?page_id=920283467127694">签名规则</a>”</td>
</tr>
<tr>
<td>6</td>
<td>sign_type</td>
<td>签名方式</td>
<td>string</td>
<td>Y</td>
<td>MD5</td>
<td>签名方式，目前只支持MD5</td>
</tr>
<tr>
<td>7</td>
<td>input_charset</td>
<td>参数编码字符集</td>
<td>string</td>
<td>Y</td>
<td>UTF-8</td>
<td>目前只支持UTF-8</td>
</tr>
</tbody>
</table>
<h4>请求body参数</h4>
<table>
<thead>
<tr>
<th><strong>NO</strong></th>
<th><strong>字段</strong></th>
<th><strong>名称</strong></th>
<th><strong>长度</strong></th>
<th><strong>必填</strong></th>
<th><strong>示例</strong></th>
<th><strong>说明</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>8</td>
<td>out_request_no</td>
<td>商户请求图片编号</td>
<td>string(64)</td>
<td>Y</td>
<td>SC_I8843222458_2018060100000001</td>
<td>由商户生成的该笔交易的全局唯一ID，商户需确保其唯一性， 建议值：公司简称+门店编号+时间戳+序列</td>
</tr>
<tr>
<td>9</td>
<td>picture_type</td>
<td>图片类型</td>
<td>string</td>
<td>Y</td>
<td>01</td>
<td>图片类型，具体值：01-营业执照照片 02-开户许可证照片 03-身份证正面照片 04-身份证反面照片 05-门头照 06-授权书照 07-商户协议照 08-其他照片 09-店内环境照</td>
</tr>
<tr>
<td>10</td>
<td>picture</td>
<td>图片 ( 注意：此字段不参与签名,一次仅允许上传一张图片,图片内容将以二进制数据的形式发送)</td>
<td>string</td>
<td>Y</td>
<td>图片内容将以二进制数据的形式发送</td>
<td>图片数据 注意：此字段不参与签名 可参考附件上传代码样例 一次仅允许上传一张图片</td>
</tr>
</tbody>
</table>
<hr />
<h4>响应head参数</h4>
<table>
<thead>
<tr>
<th><strong>NO</strong></th>
<th><strong>字段</strong></th>
<th><strong>名称</strong></th>
<th><strong>长度</strong></th>
<th><strong>必填</strong></th>
<th><strong>示例</strong></th>
<th><strong>说明</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>1</td>
<td>service</td>
<td>接口名称</td>
<td>string(32)</td>
<td>Y</td>
<td>common.upload</td>
<td>与请求中的该字段对应</td>
</tr>
<tr>
<td>2</td>
<td>version</td>
<td>版本号</td>
<td>string</td>
<td>Y</td>
<td>1.0</td>
<td>默认填写1.0，有新版本更新时会在API版本里面更新通知，和请求参数对应</td>
</tr>
<tr>
<td>3</td>
<td>channel_partner_id</td>
<td>联富通渠道合作编号(开通代理商账号时，联富通商务提供)</td>
<td>string(32)</td>
<td>Y</td>
<td>17052418193857300</td>
<td>渠道合作编号。用于标识调用方身份 该编号将由联富通创建并告知代理商。</td>
</tr>
<tr>
<td>4</td>
<td>platform_merchant_no</td>
<td>联富通平台商户编号(开通代理商账号时，联富通商务提供)</td>
<td>string(32)</td>
<td>Y</td>
<td>EW_N2320993253</td>
<td>联富通平台商户编号 该编号将由联富通创建并告知商户</td>
</tr>
<tr>
<td>5</td>
<td>sign</td>
<td>签名“<a href="https://www.showdoc.cc/liantuofu?page_id=920283467127694">签名规则</a>”</td>
<td>string</td>
<td>Y</td>
<td>1b70687c8a4c72f50c749baf95a482c0</td>
<td>MD5加密验签值。商户需先根据“<a href="https://www.showdoc.cc/liantuofu?page_id=920283467127694">签名规则</a>”进行验证，验证通过后再进行后续操作。</td>
</tr>
<tr>
<td>6</td>
<td>sign_type</td>
<td>签名方式</td>
<td>string</td>
<td>Y</td>
<td>MD5</td>
<td>签名方式，目前只支持MD5</td>
</tr>
<tr>
<td>7</td>
<td>input_charset</td>
<td>参数编码字符集</td>
<td>string</td>
<td>Y</td>
<td>UTF-8</td>
<td>目前只支持UTF-8</td>
</tr>
</tbody>
</table>
<h4>响应body参数</h4>
<table>
<thead>
<tr>
<th><strong>NO</strong></th>
<th><strong>字段</strong></th>
<th><strong>名称</strong></th>
<th><strong>长度</strong></th>
<th><strong>必填</strong></th>
<th><strong>示例</strong></th>
<th><strong>说明</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>8</td>
<td>is_success</td>
<td>结果</td>
<td>string</td>
<td>Y</td>
<td>S</td>
<td>支付订单创建处理结果，非交易结果 S：表示处理成功F：表示处理失败</td>
</tr>
<tr>
<td>9</td>
<td>error</td>
<td>错误码</td>
<td>string</td>
<td>N</td>
<td>QZ000600100</td>
<td>当is_success=F时，可参见对应具体[错误码]进行处理。</td>
</tr>
<tr>
<td>10</td>
<td>message</td>
<td>错误描述</td>
<td>string</td>
<td>N</td>
<td>协议参数校验未通过</td>
<td>对应错误码的描述信息</td>
</tr>
<tr>
<td>11</td>
<td>out_request_no</td>
<td>商户请求编号</td>
<td>string(64)</td>
<td>Y</td>
<td>SC_I8843222458_2018060100000001</td>
<td>与请求对应</td>
</tr>
<tr>
<td></td>
<td>当is_success=S时，返回以下参数</td>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
</tr>
<tr>
<td>12</td>
<td>picture</td>
<td>上传后的图片识别码，调用进件接口时携带</td>
<td>string</td>
<td>Y</td>
<td>图片内容将以二进制数据的形式发送</td>
<td>上传后的图片识别码，调用进件接口时携带</td>
</tr>
</tbody>
</table>
<h5>请求示例:</h5>
<pre><code class="language-json">{requestJson=
{
"body":{
"out_request_no":"linzz1536112878974",
"picture_type":"01"
},
"head":{"channel_partner_id":"18083009392565451",
"input_charset":"UTF-8",
"platform_merchant_no":"EW_N7619723563",
"service":"common.upload",
"sign":"c8fdf98fd0f2b2276dd45462396e147a",
"sign_type":"MD5",
"version":"1.0"
}
}
}</code></pre>
<h5>响应示例（成功）：</h5>
<pre><code class="language-json">{
"head": {
"service": "common.upload",
"version": "1.0",
"sign": "002f926daa9ec952f6a4385ae1c4ef31",
"sign_type": "MD5",
"input_charset": "UTF-8",
"operation_code": "c1a9a59f-22e0-4116-88e4-701c8ac68484",
"channel_partner_id": "18083009392565451",
"platform_merchant_no": "EW_N7619723563"
},
"body": {
"is_success": "S",
"error": null,
"message": null,
"out_request_no": "linzz1536112878974",
"picture": "01_153611287861816545995187202876.jpg"
}
}
</code></pre>
<h5>响应示例（失败）：</h5>
<pre><code class="language-json">{
"head": {
"service": "common.upload",
"version": "1.0",
"sign": "002f926daa9ec952f6a4385ae1c4ef31",
"sign_type": "MD5",
"input_charset": "UTF-8",
"operation_code": "c1a9a59f-22e0-4116-88e4-701c8ac68484",
"channel_partner_id": "18083009392565451",
"platform_merchant_no": "EW_N7619723563"
},
"body": {
"is_success": "F",
"error": "QZ000000601",
"message": "验签失败"
}
}
</code></pre>
<h5>错误码</h5>
<table>
<thead>
<tr>
<th>错误码</th>
<th>错误描述</th>
<th>建议处理</th>
</tr>
</thead>
<tbody>
<tr>
<td>QZ000000100</td>
<td>{}格式校验未通过</td>
<td>检查请求参数，重新发起请求</td>
</tr>
<tr>
<td>QZ000000200</td>
<td>商户编码对应的商户不存在或状态为停用</td>
<td>联系联富通平台确认商户状态</td>
</tr>
</tbody>
</table>