聚合支付API

<h5>接口使用描述</h5> <pre><code>为了商户在对接过程中不再传递channelPay=WXPAY|ALIPAY,减少商户在处理业务流程中的操作步骤，现在提供聚合支付（支持主扫支付，公众号支付）通用接口。 除了支付入口不同，支付完成的流程结果和后续操作，与主扫支付，公众号支付相同，不再复述。 注意此接口，不支持云闪付支付。</code></pre> <h5>接口地址</h5> <pre><code> 接口地址：https://api.liantuofu.com/open/jspay</code></pre> <p>&lt;br/&gt;</p> <h4>请求参数&lt;img src='<a href="https://www.showdoc.cc/server/api/common/visitfile/sign/bfc24f8d7eb93fae8e66d4ab2b4bc461?showdoc=.jpg">https://www.showdoc.cc/server/api/common/visitfile/sign/bfc24f8d7eb93fae8e66d4ab2b4bc461?showdoc=.jpg</a>' align='right' style=' width:300px;height:100 px'/&gt;</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>appId</td> <td>合作方标识</td> <td>string</td> <td>Y</td> <td>EW_N2949193174</td> <td>合作商户编码，用于以后所有接口发起请求时验签使用</td> </tr> <tr> <td>2</td> <td>sign</td> <td>签名。具体参见“<a href="https://www.showdoc.cc/web/#/liantuofu?page_id=673453270295568">签名规则</a>”</td> <td>string</td> <td>Y</td> <td>1b70687c8a4c72f50c749baf95a482c0</td> <td>MD5加密验签值。具体参见“<a href="https://www.showdoc.cc/web/#/liantuofu?page_id=673453270295568">签名规则</a>”</td> </tr> <tr> <td>3</td> <td>random</td> <td>随机数</td> <td>string</td> <td>Y</td> <td>123</td> <td>用来增加加密验签的复杂度，长度不限制，只限制传递数字，不支持中文，字母，特殊符号。</td> </tr> <tr> <td>4</td> <td>merchantCode</td> <td>门店编号</td> <td>string</td> <td>Y</td> <td>EW_N9479011740</td> <td>门店编号，用于后续接口请求参数的使用</td> </tr> <tr> <td>5</td> <td>expireSeconds</td> <td>二维码有效期以秒为单位</td> <td>string</td> <td>N</td> <td>300</td> <td>最大不超过2592000（即30天），此字段如果不填，则默认有效期为600秒</td> </tr> <tr> <td>6</td> <td>outTradeNo</td> <td>商户订单号</td> <td>string(64)</td> <td>Y</td> <td>CS100082018050166666</td> <td>由商户生成的该笔交易的全局唯一ID，商户需确保其唯一性，重新发起一笔支付要使用新订单号，避免重复支付。后续可通过该ID查询对应订单信息。 建议值：公司简称+门店编号+时间戳+序列 支持8-64位数字、英文字母、“-”及“_”，其他字符不支持</td> </tr> <tr> <td>7</td> <td>totalAmount</td> <td>订单总金额</td> <td>double</td> <td>Y</td> <td>88.88</td> <td>单位为元，精确到小数点后两位，取值范围[0.01至100000000]</td> </tr> <tr> <td>8</td> <td>operatorId</td> <td>操作员id</td> <td>string</td> <td>N</td> <td>1234409009</td> <td>收银员账号登陆时，登陆返回信息中的操作员ID(收银员ID)</td> </tr> <tr> <td>9</td> <td>orderRemark</td> <td>订单备注</td> <td>string</td> <td>N</td> <td>订单备注</td> <td>在联拓富后台展示到订单列表里</td> </tr> <tr> <td>11</td> <td>notifyUrl</td> <td>通知地址</td> <td>string(256)</td> <td>N</td> <td><a href="http://www.test.com/test/test.t">http://www.test.com/test/test.t</a></td> <td>异步接收交易结果通知的商户服务地址 0-256位任意字符 此值目前空置即可，商户可通过“<a href="https://www.showdoc.cc/web/?#/lianfutong?page_id=438919398067126">订单查询</a>”接口获取交易结果 交易完成后，联拓富平台将以后台异步通知的方式，将交易结果发送到商户传递的此服务地址</td> </tr> <tr> <td>12</td> <td>orderSource</td> <td>订单来源</td> <td>int</td> <td>Y</td> <td>16</td> <td>16 新接口</td> </tr> <tr> <td>13</td> <td>clientIp</td> <td>客户端ip</td> <td>string</td> <td>N</td> <td>16</td> <td>客户端ip</td> </tr> <tr> <td>14</td> <td>longitude</td> <td>用户地址位罱(经度)</td> <td>string</td> <td>N</td> <td>16</td> <td>用户地址位罱(经度)</td> </tr> <tr> <td>15</td> <td>latitudle</td> <td>用户地址位置(纬度)</td> <td>string</td> <td>N</td> <td>16</td> <td>用户地址位置(纬度)</td> </tr> </tbody> </table> <h4>响应参数</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>code</td> <td>结果</td> <td>string</td> <td>Y</td> <td>SUCCESS</td> <td>请求结果 SUCCESS：表示请求成功 FAILED：表示查询失败</td> </tr> <tr> <td>2</td> <td>msg</td> <td>结果描述</td> <td>string</td> <td>Y</td> <td>描述信息</td> <td>无论是成功或者失败，message都会针对于当前的结果返回响应的结果描述</td> </tr> <tr> <td>3</td> <td>subCode</td> <td>错误代码</td> <td>string</td> <td>N</td> <td>LOGIN_ERROR</td> <td>如果code为FAILED，subcode会返回详细的错误code,以便错误信息描述的更加精确</td> </tr> <tr> <td>4</td> <td>subMsg</td> <td>错误描述</td> <td>string</td> <td>N</td> <td>EW_N2320993253</td> <td>如果code为FAILED，subMsg会返回详细的错误描述,以便错误信息描述的更加精确</td> </tr> <tr> <td>5</td> <td>sign</td> <td>签名</td> <td>string</td> <td>Y</td> <td>1b70687c8a4c72f50c749baf95a482c0</td> <td>请求时传递的sign</td> </tr> <tr> <td>6</td> <td>random</td> <td>随机数</td> <td>string</td> <td>Y</td> <td>123</td> <td>请求时传递的随机数</td> </tr> <tr> <td>7</td> <td>url</td> <td>支付二维码链接</td> <td>string</td> <td>Y</td> <td><a href="http://*****/frontcash/kshwithdraw.in?store_no=KS_N2334039117&amp;operator_no=EW_N6370349149&amp;uuid=60a52d705b5d46018db998911bda1cf7">http://*****/frontcash/kshwithdraw.in?store_no=KS_N2334039117&amp;operator_no=EW_N6370349149&amp;uuid=60a52d705b5d46018db998911bda1cf7</a></td> <td>聚合支付接口返回的统一支付链接</td> </tr> <tr> <td>8</td> <td>expireSeconds</td> <td>有效时间(秒) ,与请求时传递有效时间相同</td> <td>string</td> <td>Y</td> <td>300</td> <td>有效时间(秒)</td> </tr> </tbody> </table> <p>&lt;br/&gt;&lt;br/&gt;</p> <h5>请求示例:</h5> <pre><code>outTradeNo=2018072517090001&amp;amp;totalAmount=0.01&amp;amp;authCode=134700965368585815&amp;amp;operatorId=10181383&amp;amp;sign=21346a97ae6750028f664bb15abfc3ed&amp;amp;appId=SC_I5640724439&amp;amp;random=6666666666666666666&amp;amp;merchantCode=SC_I2528987310&amp;amp;expireSeconds=300&amp;amp;orderRemark=aaabbbbcccc&amp;amp;returnUrl=http://liantuo.com</code></pre> <h5>响应示例（成功）：</h5> <pre><code class="language-json">{ &amp;quot;code&amp;quot;:&amp;quot;SUCCESS&amp;quot;, &amp;quot;msg&amp;quot;:&amp;quot;成功&amp;quot;, &amp;quot;url&amp;quot;:&amp;quot;http://api.liantuofu.com/payQr?key=PAY11111&amp;quot;, &amp;quot;expireSeconds&amp;quot;:700 }</code></pre> <h5>响应示例（失败）：</h5> <pre><code class="language-json">{ &amp;quot;code&amp;quot;:&amp;quot;FAILED&amp;quot;, &amp;quot;msg&amp;quot;:&amp;quot;授权码检验错误&amp;quot;, &amp;quot;subCode&amp;quot;:&amp;quot;SYSTEM_ERROR&amp;quot;, &amp;quot;subMsg&amp;quot;:&amp;quot;系统异常&amp;quot; }</code></pre> <h5>错误码</h5> <table> <thead> <tr> <th>错误码</th> <th>错误描述</th> <th>建议处理</th> </tr> </thead> <tbody> <tr> <td>TRADE_REPEAT_ORDER_ERROR</td> <td>订单号重复</td> <td>更换订单号重新请求支付</td> </tr> <tr> <td>APPID_ERROR</td> <td>APPID 参数错误</td> <td>核实自己的appid是否正确</td> </tr> <tr> <td>PAY_CONFIG_ERROR</td> <td>支付配置错误</td> <td>核实门店是否勾选支付配置</td> </tr> <tr> <td>SYSTEM_ERROR</td> <td>系统异常</td> <td>调用订单查询确认订单状态</td> </tr> </tbody> </table>