联拓富快速接入版移动支付接口

联拓富快速接入版移动支付接口


开户及进件申请(网商)

<h5>接口使用描述</h5> <pre><code>进件接口目前只支持 网商通道 进件。 商户可通过进件接口提交进件所需资料,申请开通支付渠道。 若在联富通平台尚未注册,那么将自动开通平台商户和门店。资料审核及进件完成后,可使用支付接口进行支付操作。 调用进件接口前,需先调用“图片上传”接口上传进件所需图片。</code></pre> <h5>接口调用方法</h5> <pre><code> 服务器请求地址:http://newfront.liantuobank.com/NewFront/base/gateway.in 接口service:merchant.register </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>merchant.register</td> <td>请求服务器时必填,通过此字段区分调用的是不同的方法 此接口为merchant.register</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>agent_no</td> <td>联富通后台代理商编号</td> <td>string(64)</td> <td>Y</td> <td>EW_N8889781999</td> <td>所属代理商编号,在联富通后台查询获取</td> </tr> <tr> <td>9</td> <td>register_type</td> <td>进件类型</td> <td>string(10)</td> <td>Y</td> <td>01</td> <td>进件类型 具体值:01 自然人 02 个体工商户 03 企业商户 不同类型需要进件的资料不同,可参考<a href="https://www.showdoc.cc/liantuofu?page_id=1528825649116622" title="“进件资料列表”">“进件资料列表”</a></td> </tr> <tr> <td>10</td> <td>merchant_full_name</td> <td>商户名称/企业名称</td> <td>string(30)</td> <td>Y</td> <td>XXXX公司</td> <td>最长30个汉字,支持汉字、字母、数字和中英文圆括号,并且不能全为数字 商户为企业时,请准确填写企业名称。</td> </tr> <tr> <td>11</td> <td>merchant_name</td> <td>商户简称</td> <td>string(15)</td> <td>Y</td> <td>XXXX</td> <td>最长15个汉字,支持汉字、字母、数字和中英文圆括号,并且不能全为数字</td> </tr> <tr> <td>12</td> <td>province_id</td> <td>商户所在省ID</td> <td>string</td> <td>Y</td> <td>11</td> <td>商户所在省参见<a href="https://pan.baidu.com/s/1zqdNnAsUYu0SMQHtqYTy9Q" title="“地区列表”">“地区列表”</a></td> </tr> <tr> <td>13</td> <td>city_id</td> <td>商户所在市ID</td> <td>string</td> <td>Y</td> <td>01</td> <td>商户所在市参见<a href="https://pan.baidu.com/s/1zqdNnAsUYu0SMQHtqYTy9Q" title="“地区列表”">“地区列表”</a></td> </tr> <tr> <td>14</td> <td>area_id</td> <td>商户所在区ID</td> <td>string</td> <td>Y</td> <td>01</td> <td>商户所在区参见<a href="https://pan.baidu.com/s/1zqdNnAsUYu0SMQHtqYTy9Q" title="“地区列表”">“地区列表”</a></td> </tr> <tr> <td>15</td> <td>address</td> <td>商户所在区地址</td> <td>string(80)</td> <td>Y</td> <td>北京市丰台区南方庄1号院</td> <td>商户详细地址信息80字以内,支持汉字、字母、数字和中英文圆括号</td> </tr> <tr> <td>16</td> <td>business_category</td> <td>经营类目/行业类别ID</td> <td>string</td> <td>Y</td> <td>297</td> <td>商户经营类目/行业类别,具体参见<a href="https://pan.baidu.com/s/1zqdNnAsUYu0SMQHtqYTy9Q" title="“经营类目/行业类别”">“经营类目/行业类别”</a></td> </tr> <tr> <td>17</td> <td>contact_name</td> <td>负责人/法人姓名</td> <td>string(10)</td> <td>Y</td> <td>张三</td> <td>负责人/法人姓名最长10个汉字,不能有空格,仅支持中文名,不支持英文名。商户为企业时,请填写法人姓名。</td> </tr> <tr> <td>18</td> <td>contact_phone</td> <td>负责人电话</td> <td>string</td> <td>Y</td> <td>13800000001</td> <td>负责人手机号码</td> </tr> <tr> <td>19</td> <td>contact_email</td> <td>负责人邮箱</td> <td>string</td> <td><a href="https://www.showdoc.cc/liantuofu?page_id=1528825649116622" title="参见列表">参见列表</a></td> <td>test@test.com</td> <td>负责人邮箱</td> </tr> <tr> <td>20</td> <td>certificate_no</td> <td>法人证件号</td> <td>string(64)</td> <td><a href="https://www.showdoc.cc/liantuofu?page_id=1528825649116622" title="参见列表">参见列表</a></td> <td>450423199009296666</td> <td>法人证件号码</td> </tr> <tr> <td>21</td> <td>business_license_type</td> <td>营业执照类型</td> <td>string</td> <td><a href="https://www.showdoc.cc/liantuofu?page_id=1528825649116622" title="参见列表">参见列表</a></td> <td>NATIONAL_LEGAL</td> <td>营业执照:NATIONAL_LEGAL营业执照(多证合一):NATIONAL_LEGAL_MERGE事业单位法人证书:INST_RGST_CTF</td> </tr> <tr> <td>22</td> <td>business_license_no</td> <td>营业执照编号</td> <td>string(18)</td> <td><a href="https://www.showdoc.cc/liantuofu?page_id=1528825649116622" title="参见列表">参见列表</a></td> <td>450423199009296666</td> <td>营业执照编号</td> </tr> <tr> <td>23</td> <td>login_name</td> <td>门店登陆账号(不可输入中文)</td> <td>string</td> <td>N</td> <td>testm001</td> <td>管理后台门店登录名如空,默认为负责人电话30位以内,不可输入中文登录密码将由联富通生成。</td> </tr> <tr> <td>费率list,<br>包含rate_type,<br>rate_value</td> <td>rate_list</td> <td>费率list</td> <td>list</td> <td>Y</td> <td>01</td> <td>包含rate_type,rate_value</td> </tr> <tr> <td>24</td> <td>rate_type</td> <td>费率类型</td> <td>string</td> <td>Y</td> <td>01</td> <td>费率类型,可选值:01:支付宝02:微信</td> </tr> <tr> <td>25</td> <td>rate_value</td> <td>费率</td> <td>string(15)</td> <td>Y</td> <td>0.0035</td> <td>费率值例如:千分之3.5为0.0035费率不能超出联富通提供的设定范围</td> </tr> <tr> <td>26</td> <td>bank</td> <td>开户银行</td> <td>string(10)</td> <td>Y</td> <td>中国工商银行</td> <td>开户银行编号,参见<a href="https://pan.baidu.com/s/1zqdNnAsUYu0SMQHtqYTy9Q" title="“银行列表”">“银行列表”</a></td> </tr> <tr> <td>27</td> <td>card_no</td> <td>银行卡号/对公账号</td> <td>string(32)</td> <td>Y</td> <td>6222888888888888888</td> <td>银行卡号/对公账号商户为企业时,为对公账号号码</td> </tr> <tr> <td>28</td> <td>account_holder</td> <td>开户人</td> <td>string</td> <td><a href="https://www.showdoc.cc/liantuofu?page_id=1528825649116622" title="参见列表">参见列表</a></td> <td>张三</td> <td>开户人商户为企业时无需填写,将用“企业名称”,请确认企业名称正确填写。</td> </tr> <tr> <td>29</td> <td>subbranch_province_id</td> <td>开户支行所属省ID</td> <td>string</td> <td><a href="https://www.showdoc.cc/liantuofu?page_id=1528825649116622" title="参见列表">参见列表</a></td> <td>10</td> <td>开户支行所属省参见“地区列表”</td> </tr> <tr> <td>30</td> <td>subbranch_city_id</td> <td>开户支行所属市ID</td> <td>string</td> <td><a href="https://www.showdoc.cc/liantuofu?page_id=1528825649116622" title="参见列表">参见列表</a></td> <td>01</td> <td>开户支行所属省参见“地区列表”</td> </tr> <tr> <td>31</td> <td>subbranch_name</td> <td>开户支行名称</td> <td>string</td> <td><a href="https://www.showdoc.cc/liantuofu?page_id=1528825649116622" title="参见列表">参见列表</a></td> <td>朝阳路支行</td> <td>开户支行名称</td> </tr> <tr> <td>32</td> <td>certificate_holder_no</td> <td>持卡人身份证号码</td> <td>string(64)</td> <td><a href="https://www.showdoc.cc/liantuofu?page_id=1528825649116622" title="参见列表">参见列表</a></td> <td>450423199009299999</td> <td>持卡人身份证号码</td> </tr> <tr> <td>33</td> <td>card_holder_address</td> <td>持卡人身份证地址</td> <td>string(80)</td> <td><a href="https://www.showdoc.cc/liantuofu?page_id=1528825649116622" title="参见列表">参见列表</a></td> <td>北京市朝阳区金台西路</td> <td>持卡人身份证地址</td> </tr> <tr> <td>34</td> <td>mobile</td> <td>银行预留手机号</td> <td>string(11)</td> <td><a href="https://www.showdoc.cc/liantuofu?page_id=1528825649116622" title="参见列表">参见列表</a></td> <td>13500006666</td> <td>银行预留手机号</td> </tr> <tr> <td>35</td> <td>business_license_url</td> <td>营业执照照片</td> <td>string(11)</td> <td><a href="https://www.showdoc.cc/liantuofu?page_id=1528825649116622" title="参见列表">参见列表</a></td> <td></td> <td>已上传的营业执照图片识别码<a href="https://www.showdoc.cc/web/#/lianfutong?page_id=810814235934936" title="“图片上传”">“图片上传”</a>接口</td> </tr> <tr> <td>36</td> <td>opening_permit_url</td> <td>开户许可证照片</td> <td>string</td> <td><a href="https://www.showdoc.cc/liantuofu?page_id=1528825649116622" title="参见列表">参见列表</a></td> <td></td> <td>已上传的负责人/法人身份证正面别码进件类型为“企业商户”时,为对法人身份证照片<a href="https://www.showdoc.cc/web/#/lianfutong?page_id=810814235934936" title="“图片上传”">“图片上传”</a>接口</td> </tr> <tr> <td>37</td> <td>identification_front_url</td> <td>负责人/法人身份证正面照片</td> <td>string</td> <td>Y</td> <td></td> <td>银行预留手机号</td> </tr> <tr> <td>38</td> <td>identification_opposite_url</td> <td>负责人/法人身份证反面照片</td> <td>string</td> <td>Y</td> <td></td> <td>已上传的负责人/人身份证反面图片识别码进件类型为“企业商户”时,为对法人身份证照片参见<a href="https://www.showdoc.cc/web/#/lianfutong?page_id=810814235934936" title="“图片上传”">“图片上传”</a>接口</td> </tr> <tr> <td>39</td> <td>door_ceb_url</td> <td>门头照</td> <td>string</td> <td><a href="https://www.showdoc.cc/liantuofu?page_id=1528825649116622" title="参见列表">参见列表</a></td> <td></td> <td>已上传的门头照图片识别码参见<a href="https://www.showdoc.cc/web/#/lianfutong?page_id=810814235934936" title="“图片上传”">“图片上传”</a>接口</td> </tr> <tr> <td>40</td> <td>inside_url</td> <td>店内环境照</td> <td>string</td> <td><a href="https://www.showdoc.cc/liantuofu?page_id=1528825649116622" title="参见列表">参见列表</a></td> <td></td> <td>已上传的店内环境照图片识别码参见<a href="https://www.showdoc.cc/web/#/lianfutong?page_id=810814235934936" title="“图片上传”">“图片上传”</a>接口</td> </tr> <tr> <td>41</td> <td>supplementary_material_url</td> <td>授权书照</td> <td>string</td> <td><a href="https://www.showdoc.cc/liantuofu?page_id=1528825649116622" title="参见列表">参见列表</a></td> <td></td> <td>已上传的授权书照图片识别码参见<a href="https://www.showdoc.cc/web/#/lianfutong?page_id=810814235934936" title="“图片上传”">“图片上传”</a>接口</td> </tr> <tr> <td>42</td> <td>merchantagreement_url</td> <td>商户协议照</td> <td>string</td> <td><a href="https://www.showdoc.cc/liantuofu?page_id=1528825649116622" title="参见列表">参见列表</a></td> <td></td> <td>已上传的商户协议照图片识别码参见<a href="https://www.showdoc.cc/web/#/lianfutong?page_id=810814235934936" title="“图片上传”">“图片上传”</a>接口</td> </tr> <tr> <td>43</td> <td>supplementary_material_url1</td> <td>其他照片1</td> <td>string</td> <td>N</td> <td></td> <td>已上传的其他照片1图片识别码参见<a href="https://www.showdoc.cc/web/#/lianfutong?page_id=810814235934936" title="“图片上传”">“图片上传”</a>接口</td> </tr> <tr> <td>44</td> <td>supplementary_material_url2</td> <td>其他照片2</td> <td>string</td> <td>N</td> <td></td> <td>已上传的其他照片2图片识别码参见<a href="https://www.showdoc.cc/web/#/lianfutong?page_id=810814235934936" title="“图片上传”">“图片上传”</a>接口</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>merchant.register</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></td> <td>当is_success=S时,返回以下参数</td> <td></td> <td></td> <td></td> <td></td> <td></td> </tr> <tr> <td>11</td> <td>core_merchant_no</td> <td>商户编号</td> <td>string(32)</td> <td>Y</td> <td>EW_N2320993266</td> <td>联富通商户编号 该编号将由联富通创建并告知商户,商户也可登录联富通管理后台查询获取。</td> </tr> <tr> <td>12</td> <td>merchant_no</td> <td>门店编号</td> <td>string(32)</td> <td>Y</td> <td>EW_N2320993266</td> <td>联富通门店编号 该编号将由联富通创建并告知商户,商户也可登录联富通管理后台查询获取。</td> </tr> <tr> <td>13</td> <td>core_merchant_login_name</td> <td>商户登录名登陆<a href="http://houtai.liantuofu.com" title="商户平台">商户平台</a>(不是联富通平台)</td> <td>string</td> <td>Y</td> <td>EW_N2320993266</td> <td>商户登录名由系统默认生成并返回,用于登陆对应的<a href="http://houtai.liantuofu.com" title="商户平台">商户平台</a>(不是联富通平台)</td> </tr> <tr> <td>14</td> <td>merchant_login_name</td> <td>门店登录名登陆<a href="http://houtai.liantuofu.com" title="商户平台">商户平台</a>(不是联富通平台)</td> <td>string(32)</td> <td>Y</td> <td>EW_N2320993266</td> <td>门店登录名,与请求对应若请求时未填写指定登录名,则由系统默认生成并返回。用于登陆对应的<a href="http://houtai.liantuofu.com" title="商户平台">商户平台</a>(不是联富通平台)</td> </tr> </tbody> </table> <h5>请求示例:</h5> <pre><code class="language-json">{ requestJson = { "body": { "address": "张无忌", "agent_no": "EW_N8484741367", "area_id": "110106", "bank": "102100099996", "business_category": "297", "business_license_no": "911303026690645423", "business_license_url": "01_153604766770181170967367256289.jpg", "card_no": "3267465464654654654", "certificate_holder_no": "500225199002260015", "certificate_no": "13082119880919805X", "city_id": "110100", "contact_name": "张无忌", "contact_phone": "13919561125", "door_ceb_url": "01_153604766770181170967367256289.jpg", "identification_front_url": "01_153604766770181170967367256289.jpg", "identification_opposite_url": "01_153604766770181170967367256289.jpg", "login_name": "zhangwj_dl017", "merchant_full_name": "张无忌", "merchant_name": "张无忌", "merchantagreement_url": "01_153604766770181170967367256289.jpg", "opening_permit_url": "01_153604766770181170967367256289.jpg", "province_id": "110000", "rate_list": "[{\"rate_type\":\"01\",\"rate_value\":\"0.0038\"},{\"rate_type\":\"02\",\"rate_value\":\"0.0048\"}]", "register_type": "03", "supplementary_material_url": "01_153604766770181170967367256289.jpg", "supplementary_material_url1": "01_153604766770181170967367256289.jpg", "supplementary_material_url2": "01_153604766770181170967367256289.jpg" }, "head": { "channel_partner_id": "18083009392565451", "input_charset": "UTF-8", "platform_merchant_no": "EW_N7619723563", "service": "merchant.register", "sign": "be78f84e28594cd46f868b0b266054ba", "sign_type": "MD5", "version": "1.0" } } }</code></pre> <h5>响应示例(成功):</h5> <pre><code class="language-json">{ "head": { "service": "merchant.register", "version": "1.0", "sign": "cbcb9e0400745a98843dc3be5107d590", "sign_type": "MD5", "input_charset": "UTF-8", "operation_code": "12fc3c7d-827b-4955-9334-e358498ea25c", "channel_partner_id": "18083009392565451", "platform_merchant_no": "EW_N7619723563" }, "body": { "is_success": "S", "error": null, "message": null, "core_merchant_no": "EW_N5398950421", "merchant_no": "EW_N7648787646", "core_merchant_login_name": "SHzhangwj_dl0171", "merchant_login_name": "zhangwj_dl0171" } } </code></pre> <h5>响应示例(失败):</h5> <pre><code class="language-json">{ "head": { "service": "merchant.register", "version": "1.0", "sign": "c030732601bbe66c594d3d2a0a14580b", "sign_type": "MD5", "input_charset": "UTF-8", "operation_code": "dd9b8d88-2658-46e6-9f86-65aac79a081e", "channel_partner_id": "18083009392565451", "platform_merchant_no": "EW_N7619723563" }, "body": { "is_success": "F", "error": "GL900109000100", "message": "登录名重复", "core_merchant_no": null, "merchant_no": null, "core_merchant_login_name": null, "merchant_login_name": null } } </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>

页面列表

ITEM_HTML