对账单下载
<h1>对账单下载接口</h1>
<p>*需要对账单下载商户请提交申请信息</p>
<p><strong>接口地址</strong></p>
<p><code>正式</code><br />
<code>https://open.gdyfsk.com/yfpay/bill/billDownload</code></p>
<p><code>测试</code><br />
<code>https://test.gdyfsk.com/api/yfpay/bill/billDownload</code></p>
<p><strong>请求方式</strong></p>
<p><code>POST</code></p>
<p><strong>请求头部</strong></p>
<p><code>Content-Type:application/json</code></p>
<p><strong>请求参数</strong></p>
<table>
<thead>
<tr>
<th>参数</th>
<th>类型</th>
<th>约束</th>
<th>描述</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>inst_no</td>
<td>string</td>
<td>M</td>
<td>机构号 ，通道分配</td>
<td>60000001</td>
</tr>
<tr>
<td>mch_no</td>
<td>string</td>
<td>M</td>
<td>商户号</td>
<td>Y52212200002</td>
</tr>
<tr>
<td>bill_date</td>
<td>string</td>
<td>M</td>
<td>交易日期 填写前一天日期</td>
<td>20231013</td>
</tr>
<tr>
<td>sign</td>
<td>string</td>
<td>M</td>
<td>签名字符串</td>
<td>920ff5b412adb411c6648948f2212fb9</td>
</tr>
</tbody>
</table>
<p><strong>请求示例（微信）</strong></p>
<pre><code>{
&quot;inst_no&quot;: &quot;60000001&quot;,
&quot;mch_no&quot;: &quot;Y52212190001&quot;,
&quot;bill_date&quot;: &quot;20231013&quot;,
&quot;sign&quot;: &quot;fcc3e513f87aa8c92eaff6ead4bf652a&quot;
}</code></pre>
<p><strong>响应参数</strong></p>
<table>
<thead>
<tr>
<th>参数</th>
<th>类型</th>
<th>必填</th>
<th>描述</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td>return_code</td>
<td>string</td>
<td>M</td>
<td>响应码：SUCCESS成功，FAIL失败，响应码仅代表通信或参数</td>
<td>SUCCESS</td>
</tr>
<tr>
<td>return_msg</td>
<td>string</td>
<td>M</td>
<td>返回信息提示，“请求成功”，“对账单文件不存在”，“有必传字段未传” 等</td>
<td>请求成功成功</td>
</tr>
<tr>
<td>result_code</td>
<td>string</td>
<td>M</td>
<td>业务结果：BILL_SUCCESS 请求成功，BILL_FALL 请求失败 ，只有在return_code为BILL_SUCCESS时才会返回下载地址。</td>
<td>BILL_SUCCESS</td>
</tr>
<tr>
<td>download_url</td>
<td>string</td>
<td>O</td>
<td>对账单下载地址</td>
<td></td>
</tr>
<tr>
<td>sign</td>
<td>string</td>
<td>M</td>
<td>签名</td>
<td>336437c53711dd466154c4162cbe1c52</td>
</tr>
</tbody>
</table>
<p><strong>响应示例</strong></p>
<pre><code> {
&quot;download_url&quot;: &quot;xxx&quot;,
&quot;result_code&quot;: &quot;BILL_SUCCESS&quot;,
&quot;return_code&quot;: &quot;SUCCESS&quot;,
&quot;return_msg&quot;: &quot;请求成功！&quot;,
&quot;sign&quot;: &quot;3e289c68f1dc6ab8000187ca6c5ccc68&quot;
}</code></pre>
<hr />
<p>富友商户号|卡号|卡属性|参考号|交易类型|交易代码|终端号|商户订单号| |总交易金额|交易状态|交易状态说明|交易完成时间|交易日期|原交易订单号（退款订单不为空）|交易手续费</p>
<p>0005210F0323560|||900025426215|TX09|WX01|11341312|146120231016070822028584125965||23.70|1|SUCCESS|2023-10-16 07:08:24|20231016||0.06
0005210F0323560|||900025426215|TX09|WX01|11341312|146120231016070822028584125965||8.80|1|SUCCESS|2023-10-16 07:18:13|20231016||0.02
0005210F0323560|||900025426215|TX09|WX01|11341312|146120231016070822028584125965||18.90|1|SUCCESS|2023-10-16 07:05:21|20231016||0.05
0005210F0323560|||900025426215|TX09|WX01|11341312|146120231016070822028584125965||11.10|1|SUCCESS|2023-10-16 07:28:01|20231016||0.03
0005210F0323560|||900025426215|TX18|V53||146120231016070822028584125965||210.43|1|SUCCESS|2023-10-17 23:55:21|20231017|1461202310160708220285849565821|0.74</p>
<h3>[示例交易 (以下表格样式仅为文档方便查看用，请以上述的txt文本为准)：]</h3>
<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 style="text-align: left;">交易类型</th>
<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 style="text-align: left;">交易状态</th>
<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 style="text-align: left;">交易手续费</th>
<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 style="text-align: left;">差错交易标识</th>
<th style="text-align: left;">备注</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">0005210F0323560</td>
<td style="text-align: left;"></td>
<td style="text-align: left;"></td>
<td style="text-align: left;">900025426215</td>
<td style="text-align: left;">TX09</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">100377310821217022323103800259</td>
<td style="text-align: left;">4001992001201702231071621512</td>
<td style="text-align: left;">0.01</td>
<td style="text-align: left;">1</td>
<td style="text-align: left;">SUCCESS</td>
<td style="text-align: left;">2017-02-23 23<img src="https://github.githubassets.com/images/icons/emoji/09.png" alt="09" />15</td>
<td style="text-align: left;">20170223</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">0.00</td>
<td style="text-align: left;">B14566</td>
<td style="text-align: left;">WX01</td>
<td style="text-align: left;">1</td>
<td style="text-align: left;">0.38%，无封顶</td>
<td style="text-align: left;">0</td>
<td style="text-align: left;">示例交易</td>
</tr>
<tr>
<td style="text-align: left;">0002610F1066539</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">02</td>
<td style="text-align: left;">111380150122</td>
<td style="text-align: left;">TX15</td>
<td style="text-align: left;">61045300</td>
<td style="text-align: left;">881911290003930192</td>
<td style="text-align: left;">2019112122001478030736870394</td>
<td style="text-align: left;">506.00</td>
<td style="text-align: left;">1</td>
<td style="text-align: left;">SUCCESS</td>
<td style="text-align: left;">2018-11-21 00<img src="https://github.githubassets.com/images/icons/emoji/03.png" alt="03" />41</td>
<td style="text-align: left;">20181121</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">1.77</td>
<td style="text-align: left;">678037</td>
<td style="text-align: left;">AL01</td>
<td style="text-align: left;">0</td>
<td style="text-align: left;">0.25%</td>
<td style="text-align: left;">0</td>
<td style="text-align: left;">示例交易</td>
</tr>
<tr>
<td style="text-align: left;">0004610F0757341</td>
<td style="text-align: left;">626958<strong>**</strong>9381</td>
<td style="text-align: left;">02</td>
<td style="text-align: left;">211603262385</td>
<td style="text-align: left;">TX02</td>
<td style="text-align: left;">61051906</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">020898602B41117700456248184610481600</td>
<td style="text-align: left;">280.00</td>
<td style="text-align: left;">1</td>
<td style="text-align: left;">SUCCESS</td>
<td style="text-align: left;">2019-08-29 16<img src="https://github.githubassets.com/images/icons/emoji/03.png" alt="03" />48</td>
<td style="text-align: left;">20190829</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">1.06</td>
<td style="text-align: left;">2019112116034286131501</td>
<td style="text-align: left;">S22</td>
<td style="text-align: left;">1</td>
<td style="text-align: left;">0.38%，无封顶</td>
<td style="text-align: left;">0</td>
<td style="text-align: left;">示例交易</td>
</tr>
</tbody>
</table>
<hr />
<p><strong>字段说明</strong></p>
<p>交易状态始终为1 --成功交易<br />
交易状态说明始终为 SUCCESS<br />
差错交易标识：0 普通交易，1差错交易<br />
是否优惠费率：0 普通交易，1优惠交易<br />
外部订单号只显示pos交易的，如没有则为空 </p>
<p>卡属性</p>
<table>
<thead>
<tr>
<th style="text-align: center;">值</th>
<th style="text-align: center;">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: center;">01</td>
<td style="text-align: center;">借记卡</td>
</tr>
<tr>
<td style="text-align: center;">02</td>
<td style="text-align: center;">贷记卡</td>
</tr>
<tr>
<td style="text-align: center;">03</td>
<td style="text-align: center;">准贷记卡</td>
</tr>
<tr>
<td style="text-align: center;">04</td>
<td style="text-align: center;">预付卡</td>
</tr>
<tr>
<td style="text-align: center;">05</td>
<td style="text-align: center;">外卡</td>
</tr>
<tr>
<td style="text-align: center;">09</td>
<td style="text-align: center;">单位结算卡</td>
</tr>
</tbody>
</table>
<p>交易类型</p>
<table>
<thead>
<tr>
<th style="text-align: center;">业务类型</th>
<th style="text-align: center;">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: center;">TX01</td>
<td style="text-align: center;">预授权完成</td>
</tr>
<tr>
<td style="text-align: center;">TX02</td>
<td style="text-align: center;">银行卡收单</td>
</tr>
<tr>
<td style="text-align: center;">TX03</td>
<td style="text-align: center;">退货</td>
</tr>
<tr>
<td style="text-align: center;">TX09</td>
<td style="text-align: center;">微信扫码支付</td>
</tr>
<tr>
<td style="text-align: center;">TX10</td>
<td style="text-align: center;">D0即时到账</td>
</tr>
<tr>
<td style="text-align: center;">TX15</td>
<td style="text-align: center;">支付宝扫码支付</td>
</tr>
<tr>
<td style="text-align: center;">TX18</td>
<td style="text-align: center;">扫码退货</td>
</tr>
<tr>
<td style="text-align: center;">TX23</td>
<td style="text-align: center;">支付宝花呗分期（用户贴息）</td>
</tr>
<tr>
<td style="text-align: center;">TX25</td>
<td style="text-align: center;">京东钱包支付</td>
</tr>
<tr>
<td style="text-align: center;">TX26</td>
<td style="text-align: center;">QQ钱包支付</td>
</tr>
<tr>
<td style="text-align: center;">TX27</td>
<td style="text-align: center;">银联二维码</td>
</tr>
<tr>
<td style="text-align: center;">TX37</td>
<td style="text-align: center;">微信扫码线上</td>
</tr>
<tr>
<td style="text-align: center;">TX42</td>
<td style="text-align: center;">翼支付H5</td>
</tr>
<tr>
<td style="text-align: center;">TX58</td>
<td style="text-align: center;">定时结算</td>
</tr>
<tr>
<td style="text-align: center;">TX91</td>
<td style="text-align: center;">预授权完成（微信）</td>
</tr>
<tr>
<td style="text-align: center;">TX93</td>
<td style="text-align: center;">预授权完成（支付宝）</td>
</tr>
<tr>
<td style="text-align: center;">TX68</td>
<td style="text-align: center;">DCC消费</td>
</tr>
<tr>
<td style="text-align: center;">TX70</td>
<td style="text-align: center;">EDC消费</td>
</tr>
<tr>
<td style="text-align: center;">TX91</td>
<td style="text-align: center;">预授权完成（微信）</td>
</tr>
<tr>
<td style="text-align: center;">TX93</td>
<td style="text-align: center;">预授权完成（支付宝）</td>
</tr>
<tr>
<td style="text-align: center;">TX66</td>
<td style="text-align: center;">支付宝花呗分期（商户付息）</td>
</tr>
<tr>
<td style="text-align: center;">PY68</td>
<td style="text-align: center;">银联扫码分期（商户贴息）</td>
</tr>
<tr>
<td style="text-align: center;">PY69</td>
<td style="text-align: center;">银联扫码分期（持卡人贴息）</td>
</tr>
<tr>
<td style="text-align: center;">PY71</td>
<td style="text-align: center;">支付宝信用卡分期（商户贴息）</td>
</tr>
<tr>
<td style="text-align: center;">PY70</td>
<td style="text-align: center;">支付宝信用卡分期（用户贴息）</td>
</tr>
<tr>
<td style="text-align: center;">CX01</td>
<td style="text-align: center;">预授权完成撤销</td>
</tr>
<tr>
<td style="text-align: center;">CX02</td>
<td style="text-align: center;">银行卡撤销</td>
</tr>
<tr>
<td style="text-align: center;">CX09</td>
<td style="text-align: center;">微信撤销</td>
</tr>
<tr>
<td style="text-align: center;">CX15</td>
<td style="text-align: center;">支付宝撤销</td>
</tr>
<tr>
<td style="text-align: center;">CX25</td>
<td style="text-align: center;">京东钱包撤销</td>
</tr>
<tr>
<td style="text-align: center;">CX26</td>
<td style="text-align: center;">QQ钱包撤销</td>
</tr>
<tr>
<td style="text-align: center;">CX91</td>
<td style="text-align: center;">预授权完成（微信）撤销</td>
</tr>
<tr>
<td style="text-align: center;">CX93</td>
<td style="text-align: center;">预授权完成（支付宝）撤销</td>
</tr>
<tr>
<td style="text-align: center;">PW85</td>
<td style="text-align: center;">订单分账</td>
</tr>
<tr>
<td style="text-align: center;">AP25</td>
<td style="text-align: center;">批次结算（分账）</td>
</tr>
<tr>
<td style="text-align: center;">AP26</td>
<td style="text-align: center;">用户结算（分账）</td>
</tr>
<tr>
<td style="text-align: center;">AP28</td>
<td style="text-align: center;">富管家</td>
</tr>
<tr>
<td style="text-align: center;">AP29</td>
<td style="text-align: center;">富管家-商户结算</td>
</tr>
<tr>
<td style="text-align: center;">AP33</td>
<td style="text-align: center;">富管家-转记账</td>
</tr>
<tr>
<td style="text-align: center;">AP39</td>
<td style="text-align: center;">富管家-转账记账</td>
</tr>
<tr>
<td style="text-align: center;">AP40</td>
<td style="text-align: center;">富管家-充值记账撤销</td>
</tr>
<tr>
<td style="text-align: center;">AP41</td>
<td style="text-align: center;">富管家-分账退回</td>
</tr>
<tr>
<td style="text-align: center;">AP43</td>
<td style="text-align: center;">富管家-充值订单记账</td>
</tr>
<tr>
<td style="text-align: center;">AP44</td>
<td style="text-align: center;">富管家-订单分账记账</td>
</tr>
<tr>
<td style="text-align: center;">AP45</td>
<td style="text-align: center;">富管家-订单分账</td>
</tr>
<tr>
<td style="text-align: center;">AP47</td>
<td style="text-align: center;">富管家—单笔转结</td>
</tr>
<tr>
<td style="text-align: center;">AP48</td>
<td style="text-align: center;">富管家—定时转结</td>
</tr>
<tr>
<td style="text-align: center;">AP49</td>
<td style="text-align: center;">富管家-订单归集</td>
</tr>
<tr>
<td style="text-align: center;">AP71</td>
<td style="text-align: center;">富管家—余额同步</td>
</tr>
<tr>
<td style="text-align: center;">AP72</td>
<td style="text-align: center;">富管家—转账记账退回</td>
</tr>
<tr>
<td style="text-align: center;">AP73</td>
<td style="text-align: center;">富管家—余额分账</td>
</tr>
<tr>
<td style="text-align: center;">AP74</td>
<td style="text-align: center;">富管家—余额分账记账</td>
</tr>
<tr>
<td style="text-align: center;">AP75</td>
<td style="text-align: center;">富管家-余额归集</td>
</tr>
<tr>
<td style="text-align: center;">AP76</td>
<td style="text-align: center;">富管家-归集退回</td>
</tr>
<tr>
<td style="text-align: center;">AP77</td>
<td style="text-align: center;">富管家-订单分账（结算）</td>
</tr>
<tr>
<td style="text-align: center;">AP78</td>
<td style="text-align: center;">富管家-余额分账（结算）</td>
</tr>
<tr>
<td style="text-align: center;">AP80</td>
<td style="text-align: center;">富管家-订单分账（商户子账号出金）</td>
</tr>
<tr>
<td style="text-align: center;">AP84</td>
<td style="text-align: center;">富管家-商户同名账户充值</td>
</tr>
<tr>
<td style="text-align: center;">AP85</td>
<td style="text-align: center;">富管家-商户异名账户充值</td>
</tr>
</tbody>
</table>