客商提现获取账户列表接口
<h5>接口使用描述</h5>
<pre><code>客商结算账户查询,获取客商结算账户列表,为'客商结算授权链接接口'提供transactionId参数支持
重要提示:客商银行通道结算接口,只适用于进件客商银行通道,对外开放的提现接口API</code></pre>
<h5>接口地址</h5>
<pre><code> 接口地址:http://api.liantuofu.com/open/settle/ksAccountList</code></pre>
<p><br/></p>
<img src='https://www.showdoc.cc/server/api/common/visitfile/sign/bfc24f8d7eb93fae8e66d4ab2b4bc461?showdoc=.jpg' align='right' style=' width:300px;height:100 px'/>
<h4>请求参数</h4>
<table>
<thead>
<tr>
<th>NO</th>
<th>字段</th>
<th>名称</th>
<th>长度</th>
<th>必填</th>
<th>示例</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>1</td>
<td>appId</td>
<td>商户编号</td>
<td>string</td>
<td>Y</td>
<td>EW_N5946005323</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>cda1b6e5e423d67eb5399924d7c9f47c</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>N</td>
<td>EW_N4130797151</td>
<td>门店编号,用于后续接口请求参数的使用</td>
</tr>
</tbody>
</table>
<h4>响应参数</h4>
<table>
<thead>
<tr>
<th>NO</th>
<th>字段</th>
<th>名称</th>
<th>长度</th>
<th>必填</th>
<th>示例</th>
<th>说明</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>APPID_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>appId参数错误</td>
<td>如果code为FAILED,subcode会返回详细的错误code,以便错误信息描述的更加精确</td>
</tr>
<tr>
<td>5</td>
<td>accountList</td>
<td>账户列表</td>
<td>array</td>
<td>N</td>
<td>[{"transactionId": "000000000004832","bankName": "建设银行","balanceAccount": "6227000000011737425","accountHolder": "张三"}]</td>
<td>如果code为SUCCESS,当前查询商户下对应的客商支付通道账户列表,客商进件时的提现账户信息,可以用来显示在页面上,用于对不同的账户进行提现,如果返回null,表示无客商提现账户</td>
</tr>
</tbody>
</table>
<h4>accountList</h4>
<table>
<thead>
<tr>
<th>NO</th>
<th>字段</th>
<th>名称</th>
<th>长度</th>
<th>必填</th>
<th>示例</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>1</td>
<td>transactionId</td>
<td>交易id</td>
<td>string</td>
<td>N</td>
<td>000000000004832</td>
<td>渠道身份编号,</td>
</tr>
<tr>
<td>2</td>
<td>bankName</td>
<td>开户银行</td>
<td>string</td>
<td>N</td>
<td>建设银行</td>
<td>提现银行卡号开户银行名称</td>
</tr>
<tr>
<td>3</td>
<td>balanceAccount</td>
<td>银行卡号</td>
<td>string</td>
<td>N</td>
<td>6227000000011737425</td>
<td>进件时填写的提现银行卡卡号</td>
</tr>
<tr>
<td>4</td>
<td>accountHolder</td>
<td>开户姓名</td>
<td>string</td>
<td>N</td>
<td>张三</td>
<td>进件时填写的提现银行卡号开户姓名</td>
</tr>
</tbody>
</table>
<p><br/><br/></p>
<h5>请求示例:</h5>
<pre><code>appId=EW_N5946005323&merchantCode=EW_N4130797151&random=123&sign=cda1b6e5e423d67eb5399924d7c9f47c</code></pre>
<h5>响应示例(成功):</h5>
<pre><code> {
"code": "SUCCESS",
"msg": "查询成功",
"accountList": [
{
"transactionId": "000000000004832",
"bankName": "建设银行",
"balanceAccount": "6227000000011737425",
"accountHolder": "张三"
}
]
}</code></pre>
<h5>响应示例(失败):</h5>
<pre><code> {
"code":"FAILED",
"msg":"无效的appId",
"subCode":"APPID_ERROR",
"subMsg":"appId参数错误"
}</code></pre>
<h5>错误码:</h5>
<table>
<thead>
<tr>
<th>错误码</th>
<th>错误描述</th>
<th>建议处理</th>
</tr>
</thead>
<tbody>
<tr>
<td>APPID_ERROR</td>
<td>appId参数错误</td>
<td>核实自己的appid是否正确</td>
</tr>
</tbody>
</table>