结算查询
<p><strong>接口描述：</strong> </p>
<ul>
<li>用于前一天结算查询</li>
</ul>
<p><strong>接口URL：</strong>
测试 <code>https://test.gdyfsk.com/yfpay/opensettle/page</code>
正式 <code>https://open.gdyfsk.com/yfpay/opensettle/page</code></p>
<p><strong>请求方式：</strong></p>
<ul>
<li>POST </li>
</ul>
<p><strong>请求头部：</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">标签</th>
<th style="text-align: left;">必填</th>
<th>内容</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">Content-Type</td>
<td style="text-align: left;">是</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: left;">类型</th>
<th style="text-align: left;">必填</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: left;">string(8)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">机构号 ，系统分配</td>
<td>900075</td>
</tr>
<tr>
<td style="text-align: left;">page</td>
<td style="text-align: left;">string(32)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">当前多少页</td>
<td>1</td>
</tr>
<tr>
<td style="text-align: left;">size</td>
<td style="text-align: left;">string(32)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">一页多少条</td>
<td>10</td>
</tr>
<tr>
<td style="text-align: left;">settle_no</td>
<td style="text-align: left;">string(64)</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">结算订单号</td>
<td>8596451215423</td>
</tr>
<tr>
<td style="text-align: left;">bd_id</td>
<td style="text-align: left;">string(64)</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">业务经理id</td>
<td>12</td>
</tr>
<tr>
<td style="text-align: left;">agent2_id</td>
<td style="text-align: left;">string(64)</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">二级服务商id</td>
<td>13</td>
</tr>
<tr>
<td style="text-align: left;">agent1_id</td>
<td style="text-align: left;">string(64)</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">一级服务商id</td>
<td>14</td>
</tr>
<tr>
<td style="text-align: left;">merchant_no</td>
<td style="text-align: left;">string(64)</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">商户号</td>
<td>Y52211090004</td>
</tr>
<tr>
<td style="text-align: left;">merchant_name</td>
<td style="text-align: left;">string(64)</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">商户名</td>
<td>田园</td>
</tr>
<tr>
<td style="text-align: left;">channel_type</td>
<td style="text-align: left;">string(64)</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">通道类型</td>
<td>16</td>
</tr>
<tr>
<td style="text-align: left;">settle_status</td>
<td style="text-align: left;">string(64)</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">结算状态</td>
<td>I:处理中 F:结算失败 S:结算成功，为空则未返回结算状态；</td>
</tr>
<tr>
<td style="text-align: left;">settle_type</td>
<td style="text-align: left;">string(64)</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">结算类型</td>
<td>0:对公结算 1:对私法人结算 2:对私非法人结算 3:虚拟户结算</td>
</tr>
<tr>
<td style="text-align: left;">settle_cycle</td>
<td style="text-align: left;">string(64)</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">结算方式</td>
<td>D1 T1</td>
</tr>
<tr>
<td style="text-align: left;">channel_acct_no</td>
<td style="text-align: left;">string(64)</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">通道商户号</td>
<td>2018116165053</td>
</tr>
<tr>
<td style="text-align: left;">start_date</td>
<td style="text-align: left;">string(64)</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">开始时间</td>
<td>yyyymmdd</td>
</tr>
<tr>
<td style="text-align: left;">finish_date</td>
<td style="text-align: left;">string(14)</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">结束时间</td>
<td>yyyymmdd</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">string(32)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">签名</td>
<td>51c7d68424e5492199cf7f4734a2b977</td>
</tr>
</tbody>
</table>
<p><strong>请求示例：</strong></p>
<ul>
<li>通过支付订单号查询</li>
</ul>
<pre><code class="language-json">{
&quot;inst_no&quot;: 900075,
&quot;merchant_no&quot;: &quot;Y52211090004&quot;,
&quot;sign&quot;: &quot;6e461f5c95c055b3aed017b8fcb8a1a9&quot;
}</code></pre>
<p><strong>返回参数：</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th style="text-align: left;">必含</th>
<th style="text-align: left;">说明</th>
<th>参数示例</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">settle_cycle</td>
<td style="text-align: left;">string(32)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">结算方式</td>
<td>T1，D1</td>
</tr>
<tr>
<td style="text-align: left;">settle_no</td>
<td style="text-align: left;">string(128)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">结算订单号</td>
<td>1000906198396059</td>
</tr>
<tr>
<td style="text-align: left;">settle_date</td>
<td style="text-align: left;">string(32)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">yyyymmdd</td>
</tr>
<tr>
<td style="text-align: left;">card_no</td>
<td style="text-align: left;">string(32)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">卡号</td>
<td>623058*<strong>****</strong>0060</td>
</tr>
<tr>
<td style="text-align: left;">card_name</td>
<td style="text-align: left;">string(32)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">账户名</td>
<td>广东安快智能科技有限公司湖北分公司</td>
</tr>
<tr>
<td style="text-align: left;">bank_code</td>
<td style="text-align: left;">string(80)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">银行联行号</td>
<td>03134402</td>
</tr>
<tr>
<td style="text-align: left;">settle_amt</td>
<td style="text-align: left;">string(50)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">结算金额</td>
<td>单位分</td>
</tr>
<tr>
<td style="text-align: left;">settle_fee_amt</td>
<td style="text-align: left;">string(64)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">结算手续费</td>
<td>单位分</td>
</tr>
<tr>
<td style="text-align: left;">settle_fee_cust_id</td>
<td style="text-align: left;">string(32)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">手续费承担方</td>
<td>6666000151863117</td>
</tr>
<tr>
<td style="text-align: left;">settle_type</td>
<td style="text-align: left;">string(64)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">结算类型</td>
<td>0:对公结算 1:对私法人结算 2:对私非法人结算 3:虚拟户结算</td>
</tr>
<tr>
<td style="text-align: left;">settle_status</td>
<td style="text-align: left;">string(3)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">结算状态</td>
<td>I:处理中 F:结算失败 S:结算成功，为空则未返回结算状态</td>
</tr>
<tr>
<td style="text-align: left;">settle_abstract</td>
<td style="text-align: left;">string(64)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">结算摘要</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">settle_batch_no</td>
<td style="text-align: left;">string(14)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">结算批次号</td>
<td>20181116155621</td>
</tr>
<tr>
<td style="text-align: left;">settle_desc</td>
<td style="text-align: left;">string(14)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">结算信息</td>
<td>校验失败:多次结算不成功户,户名与卡号不一致</td>
</tr>
<tr>
<td style="text-align: left;">channel_type</td>
<td style="text-align: left;">string(8)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">通道类型</td>
<td>16</td>
</tr>
<tr>
<td style="text-align: left;">channel_id</td>
<td style="text-align: left;">string(8)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">通道id</td>
<td>16</td>
</tr>
<tr>
<td style="text-align: left;">merchant_id</td>
<td style="text-align: left;">string(64)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">商户id</td>
<td>12</td>
</tr>
<tr>
<td style="text-align: left;">bd_id</td>
<td style="text-align: left;">string(64)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">业务经理</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">agent1_id</td>
<td style="text-align: left;">string(64)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">一级</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">agent2_id</td>
<td style="text-align: left;">string(128)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">二级</td>
<td>1234</td>
</tr>
<tr>
<td style="text-align: left;">create_time</td>
<td style="text-align: left;">string(32)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">创建时间</td>
<td>yyyy-mm-dd HH:mm:ss</td>
</tr>
<tr>
<td style="text-align: left;">merchant_no</td>
<td style="text-align: left;">string(32)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">商户号</td>
<td>852406170001</td>
</tr>
<tr>
<td style="text-align: left;">merchant_name</td>
<td style="text-align: left;">string(32)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">商户名称</td>
<td>广东安快智能科技有限公司湖北分公司</td>
</tr>
<tr>
<td style="text-align: left;">channel_acct_no</td>
<td style="text-align: left;">string(32)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">通道商户号</td>
<td>6666000151863117</td>
</tr>
</tbody>
</table>
<p><code>备注：</code> 若返回结果result_code=PAY_IN_PROCESS 支付中，需要调用订单查询接口进行轮询，建议返回后5秒开始。一共轮询15次间隔5秒</p>
<p><strong>返回示例：</strong> </p>
<ul>
<li>成功返回结果：</li>
</ul>
<pre><code class="language-json">{
&quot;code&quot;: 200,
&quot;data&quot;: [
{
&quot;id&quot;: 1,
&quot;settle_cycle&quot;: &quot;T1&quot;,
&quot;settle_no&quot;: &quot;1000906197873266&quot;,
&quot;settle_date&quot;: &quot;20240813&quot;,
&quot;card_no&quot;: &quot;623058*********0060&quot;,
&quot;card_name&quot;: &quot;广东安快智能科技有限公司湖北分公司&quot;,
&quot;bank_code&quot;: &quot;03134402&quot;,
&quot;settle_amt&quot;: 468,
&quot;settle_fee_amt&quot;: 1,
&quot;settle_fee_cust_id&quot;: &quot;6666000151863117&quot;,
&quot;settle_type&quot;: 0,
&quot;settle_status&quot;: &quot;F&quot;,
&quot;settle_abstract&quot;: &quot;&quot;,
&quot;settle_batch_no&quot;: &quot;0&quot;,
&quot;settle_desc&quot;: &quot;respCode=2024,codeMsg=USS校验失败:多次结算不成功户,户名与卡号不一致&quot;,
&quot;channel_type&quot;: 16,
&quot;channel_id&quot;: 16,
&quot;merchant_id&quot;: 1962,
&quot;bd_id&quot;: 245,
&quot;agent1_id&quot;: 100,
&quot;agent2_id&quot;: 101,
&quot;create_time&quot;: 1723619468000,
&quot;merchant_no&quot;: &quot;852406170001&quot;,
&quot;merchant_name&quot;: &quot;一休分账商户&quot;,
&quot;channel_acct_no&quot;: &quot;6666000151863117&quot;
}
],
&quot;pageInfo&quot;: {
&quot;page_size&quot;: 10,
&quot;page_num&quot;: 1,
&quot;total_elements&quot;: 8,
&quot;total_page&quot;: 1
},
&quot;message&quot;: &quot;操作成功&quot;
}
</code></pre>