对账文件下载
<h5>对账文件下载</h5>
<ul>
<li>对账文件下载</li>
<li>对账文件保留1年</li>
<li><span style="color:#F00">不建议使用接口获取对账单，尽可能使用SFTP获取，SFTP帐号微保提供</span></li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>/api/vbdownload/order/standard/billDownload</code></li>
</ul>
<h5>请求方式</h5>
<ul>
<li>POST </li>
</ul>
<h5>参数</h5>
<table>
<thead>
<tr>
<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;">customerNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(32)</td>
<td>商户号 <br><span style="color:#F00">示例：202112090603</td>
</tr>
<tr>
<td style="text-align: left;">date</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(8)</td>
<td>日期 <br><span style="color:#F00">示例：20211220</td>
</tr>
<tr>
<td style="text-align: left;">type</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(8)</td>
<td>对账文件类型 <br>PAY：交易<br>REFUND：退款 <br>DIVIDE：分账 <br>BINDCARD：绑卡 <br>UNBINDCARD：解绑 <br>type为空时，下载包含交易和退款<br><span style="color:#F00">示例：PAY</td>
</tr>
</tbody>
</table>
<h5>示例</h5>
<pre><code> {
Map&lt;String, String&gt; map = new HashMap&lt;String, String&gt;();
map.put(&quot;customerNo&quot;, &quot;202110110001&quot;);
map.put(&quot;date&quot;, &quot;20211111&quot;);
VbaoDownloadResponse response = null;
try {
response = QrcodeInterfaceCall.billDownload(map);
InputStream in = response.getResult();
System.out.println(IOUtils.toString(in, &quot;UTF-8&quot;));
} catch (Exception e) {
e.printStackTrace();
} finally {
// 关闭文件流,必须执行
VbaoDownloadResponse.close(response);
}
}</code></pre>
<h5>返回参数说明</h5>
<table>
<thead>
<tr>
<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;"></td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">binary</td>
<td>文件流</td>
</tr>
</tbody>
</table>
<h5>交易对账文件版本说明</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">版本</th>
<th style="text-align: left;">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">1.0</td>
<td style="text-align: left;">以逗号分割，基础版</td>
</tr>
<tr>
<td style="text-align: left;">1.1</td>
<td style="text-align: left;">以逗号分割，营销活动版对账文件</td>
</tr>
<tr>
<td style="text-align: left;">1.2</td>
<td style="text-align: left;">以逗号分割，在1.0基础上增加【渠道编码】字段</td>
</tr>
<tr>
<td style="text-align: left;">1.3</td>
<td style="text-align: left;">以^分割, 在1.2基础上,更改对账文件格式</td>
</tr>
<tr>
<td style="text-align: left;">1.4</td>
<td style="text-align: left;">以^分割, 在1.3基础上,增加【服务费总金额】、【服务费】字段</td>
</tr>
<tr>
<td style="text-align: left;">1.5</td>
<td style="text-align: left;">以^分割, 在1.4基础上,增加【一对多总商编获取所有子商编交易对账单】功能</td>
</tr>
<tr>
<td style="text-align: left;">1.6</td>
<td style="text-align: left;">以^分割, 在1.5基础上,增加【渠道支付流水号】、【用户ID】字段，支付宝或微信流水号，例如微信42开头的单号</td>
</tr>
<tr>
<td style="text-align: left;">1.7</td>
<td style="text-align: left;">以^分割, 在1.6基础上, 区分全部、交易和退款、分账/分账退回四个对账单</td>
</tr>
</tbody>
</table>
<h5>绑卡/解绑对账文件版本说明</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">版本</th>
<th style="text-align: left;">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">1.0</td>
<td style="text-align: left;">以^分割，基础版</td>
</tr>
</tbody>
</table>
<h5>对账文件示例</h5>
<p><span style="color:#F00">一般场景使用新标准版对账文件</span></p>
<h6>交易对账单-新标准版1.7</h6>
<p>全部包含交易和退款</p>
<pre><code>账单日期^20240222^对账单所属商户编号^202311017730
交易总金额^0.01^退款总金额^0.01^服务费总金额^0.00
交易总笔数^1^退款总笔数^1
交易时间^支付时间^商户编号^机构编码^商户订单号^微保订单号^业务类型^支付产品^支付方式^金额^商品名称^备注1^备注2^原订单商户订单号^原订单支付流水号^渠道编码^服务费^渠道支付流水号^用户ID
2024-02-22 16:52:22^2024-02-22 16:53:14^202311017730^^TP139859597895000^S1760588328658186242^收款^一码付^公众号支付^0.01^TestPay^^^^^Umfpay^0.00^4200002055202402228393057885^oEufkwLJnwpr2757aXfm1WpwsOKo
2024-02-22 16:54:12^2024-02-22 17:00:00^202311017730^^TR139969758504700^SR1760588790333616130^退款^^公众号支付^0.01^^Test^测试^TP139859597895000^S1760588328658186242^Umfpay^0.00^^</code></pre>
<p>交易</p>
<pre><code>账单日期^20240222^对账单所属商户编号^202311017730
交易总金额^0.01^服务费总金额^0.00
交易总笔数^1
交易时间^支付时间^商户编号^机构编码^商户订单号^微保订单号^业务类型^支付产品^支付方式^金额^商品名称^备注1^备注2^原订单商户订单号^原订单支付流水号^渠道编码^服务费^渠道支付流水号^用户ID
2024-02-22 16:52:22^2024-02-22 16:53:14^202311017730^^TP139859597895000^S1760588328658186242^收款^一码付^公众号支付^0.01^TestPay^^^^^Umfpay^0.00^4200002055202402228393057885^oEufkwLJnwpr2757aXfm1WpwsOKo</code></pre>
<p>退款</p>
<pre><code>账单日期^20240222^对账单所属商户编号^202311017730
退款总金额^0.01
退款总笔数^1
交易时间^支付时间^商户编号^机构编码^商户订单号^微保订单号^业务类型^支付产品^支付方式^金额^商品名称^备注1^备注2^原订单商户订单号^原订单支付流水号^渠道编码^服务费^渠道支付流水号^用户ID
2024-02-22 16:54:12^2024-02-22 17:00:00^202311017730^^TR139969758504700^SR1760588790333616130^退款^^公众号支付^0.01^^Test^测试^TP139859597895000^S1760588328658186242^Umfpay^0.00^^</code></pre>
<p>分账/分账退回</p>
<pre><code>账单日期^20240815^对账单所属商户编号^202112090603
分账总金额^0.39^分账退回总金额^0.13
分账总笔数^33^分账退回总笔数^12
请求时间^完成时间^商户编号^机构编码^商户分账请求号^微保分账订单号^商户分账明细请求号^分账接收方编号^分账金额^商品名称^分账说明^分账类型^原订单商户订单号^原订单支付流水号^渠道编码
2024-08-15 09:39:47^2024-08-15 09:39:46^202112090603^null^202408150000002^S1823896989681516546^202408140000001^202112090603^0.01^null^分账^202408150000002^S1823896989681516546^Yeepay_MP
2024-08-15 09:39:47^2024-08-15 09:39:46^202112090603^null^202408150000002^S1823896989681516546^202408140000002^202408147775^0.02^null^分账^202408150000002^S1823896989681516546^Yeepay_MP
2024-08-15 15:45:49^2024-08-15 15:45:49^202112090603^^SQ130025859235900^D1823989455277408258^SQ130025859235900^202112090603^0.01^null^完结^TPB128794894801100^S1823984292194041858^Yeepay
2024-08-15 09:42:01^2024-08-15 09:42:02^202112090603^null^202408150000002^DB1823897902534033410^202408140000002^202408147775^0.02^分账退还^退回^202408150000002^S1823896989681516546^null
2024-08-15 10:30:40^2024-08-15 10:30:40^202112090603^null^202408150000003^DB1823910144939851778^20240403000002^202408147775^0.01^分账退还^退回^202408150000003^S1823902695457488898^null</code></pre>
<h6>交易对账单-新标准版1.6</h6>
<pre><code>账单日期^20230330^对账单所属商户编号^202112090603
交易总金额^0.01^退款总金额^0.00^服务费总金额^0.00
交易总笔数^1^退款总笔数^0
交易时间^支付时间^商户编号^机构编码^商户订单号^微保订单号^业务类型^支付产品^支付方式^金额^商品名称^备注1^备注2^原订单商户订单号^原订单支付流水号^渠道编码^服务费^渠道支付流水号^用户ID
2023-03-30 17:20:43^2023-03-30 17:22:15^202112090603^null^20230330000001^S1641369855252672513^收款^一码付^公众号支付^0.01^test^null^{&quot;name&quot;:&quot;陈1111&quot;}^^^Yeepay_MP^0.01^42xxxxxxxx^openid/userid</code></pre>
<h6>交易对账单-新标准版1.5</h6>
<pre><code>账单日期^20230330^对账单所属商户编号^202112090603
交易总金额^0.01^退款总金额^0.00^服务费总金额^0.00
交易总笔数^1^退款总笔数^0
交易时间^支付时间^商户编号^机构编码^商户订单号^微保订单号^业务类型^支付产品^支付方式^金额^商品名称^备注1^备注2^原订单商户订单号^原订单支付流水号^渠道编码^服务费
2023-03-30 17:20:43^2023-03-30 17:22:15^202112090603^null^20230330000001^S1641369855252672513^收款^一码付^公众号支付^0.01^test^null^{&quot;name&quot;:&quot;陈1111&quot;}^^^Yeepay_MP^0.01</code></pre>
<h6>交易对账单-新标准版1.4</h6>
<pre><code>账单日期^20230330^对账单所属商户编号^202112090603
交易总金额^0.01^退款总金额^0.00^服务费总金额^0.00
交易总笔数^1^退款总笔数^0
交易时间^支付时间^商户编号^机构编码^商户订单号^微保订单号^业务类型^支付产品^支付方式^金额^商品名称^备注1^备注2^原订单商户订单号^原订单支付流水号^渠道编码^服务费
2023-03-30 17:20:43^2023-03-30 17:22:15^202112090603^null^20230330000001^S1641369855252672513^收款^一码付^公众号支付^0.01^test^null^{&quot;name&quot;:&quot;陈1111&quot;}^^^Yeepay_MP^0.01</code></pre>
<h6>交易对账单-新标准版1.3</h6>
<pre><code>账单日期^20230330^对账单所属商户编号^202112090603
交易总金额^0.01^退款总金额^0.00
交易总笔数^1^退款总笔数^0
交易时间^支付时间^商户编号^机构编码^商户订单号^微保订单号^业务类型^支付产品^支付方式^金额^商品名称^备注1^备注2^原订单商户订单号^原订单支付流水号^渠道编码
2023-03-30 17:20:43^2023-03-30 17:22:15^202112090603^null^20230330000001^S1641369855252672513^收款^一码付^公众号支付^0.01^test^null^{&quot;name&quot;:&quot;陈1111&quot;}^^^Yeepay_MP</code></pre>
<h6>交易对账单-标准版1.2</h6>
<pre><code>&quot;账单日期&quot;,&quot;2021-05-16&quot;,&quot;对账单所属商户编号&quot;,&quot;10086001234&quot;
&quot;交易总金额&quot;,&quot;435.80&quot;,&quot;退款总金额&quot;,&quot;13.90&quot;
&quot;交易总笔数&quot;,&quot;2&quot;,&quot;退款总笔数&quot;,&quot;1&quot;
&quot;交易时间&quot;,&quot;支付时间&quot;,&quot;商户编号&quot;,&quot;机构编码&quot;,&quot;商户订单号&quot;,&quot;微保订单号&quot;,&quot;业务类型&quot;,&quot;支付产品&quot;,&quot;支付方式&quot;,&quot;金额&quot;,&quot;商品名称&quot;,&quot;备注1&quot;,&quot;备注2&quot;,&quot;原订单商户订单号&quot;,&quot;原订单支付流水号&quot;,&quot;渠道编码&quot;
&quot;2021-05-16 02:00:56&quot;,&quot;2021-05-16 02:01:03&quot;,&quot;100860101234&quot;,&quot;6RNUX7HR&quot;,&quot;202105160000002257515178&quot;,&quot;S1473166176587415553&quot;,&quot;收款&quot;,&quot;一码付&quot;,&quot;公众号支付&quot;,&quot;13.90&quot;,&quot;商品1&quot;,&quot;备注11&quot;,&quot;备注12&quot;,&quot;&quot;,&quot;&quot;
&quot;2021-05-16 00:46:01&quot;,&quot;2021-05-16 00:46:19&quot;,&quot;100860101234&quot;,&quot;8QLUXPPB&quot;,&quot;202105160000002257480874&quot;,&quot;S1473166176587415554&quot;,&quot;收款&quot;,&quot;一码付&quot;,&quot;支付宝扫码&quot;,&quot;13.90&quot;,&quot;商品2&quot;,&quot;备注21&quot;,&quot;备注12&quot;,&quot;&quot;,&quot;&quot;
&quot;2021-05-17 00:47:01&quot;,&quot;2021-05-17 00:47:19&quot;,&quot;100860101234&quot;,&quot;8QLUXPPB&quot;,&quot;202105170000002257480874&quot;,&quot;R1473166176587415554&quot;,&quot;退款&quot;,&quot;一码付&quot;,&quot;支付宝扫码&quot;,&quot;-13.90&quot;,&quot;商品2&quot;,&quot;备注21&quot;,&quot;备注12&quot;,&quot;202105160000002257480874&quot;,&quot;S1473166176587415554&quot;,&quot;ICBC&quot;</code></pre>
<h6>交易对账单-标准版1.0</h6>
<pre><code>&quot;账单日期&quot;,&quot;2021-05-16&quot;,&quot;对账单所属商户编号&quot;,&quot;10086001234&quot;
&quot;交易总金额&quot;,&quot;435.80&quot;,&quot;退款总金额&quot;,&quot;13.90&quot;
&quot;交易总笔数&quot;,&quot;2&quot;,&quot;退款总笔数&quot;,&quot;1&quot;
&quot;交易时间&quot;,&quot;支付时间&quot;,&quot;商户编号&quot;,&quot;机构编码&quot;,&quot;商户订单号&quot;,&quot;微保订单号&quot;,&quot;业务类型&quot;,&quot;支付产品&quot;,&quot;支付方式&quot;,&quot;金额&quot;,&quot;商品名称&quot;,&quot;备注1&quot;,&quot;备注2&quot;,&quot;原订单商户订单号&quot;,&quot;原订单支付流水号&quot;
&quot;2021-05-16 02:00:56&quot;,&quot;2021-05-16 02:01:03&quot;,&quot;100860101234&quot;,&quot;6RNUX7HR&quot;,&quot;202105160000002257515178&quot;,&quot;S1473166176587415553&quot;,&quot;收款&quot;,&quot;一码付&quot;,&quot;公众号支付&quot;,&quot;13.90&quot;,&quot;商品1&quot;,&quot;备注11&quot;,&quot;备注12&quot;,&quot;&quot;,&quot;&quot;
&quot;2021-05-16 00:46:01&quot;,&quot;2021-05-16 00:46:19&quot;,&quot;100860101234&quot;,&quot;8QLUXPPB&quot;,&quot;202105160000002257480874&quot;,&quot;S1473166176587415554&quot;,&quot;收款&quot;,&quot;一码付&quot;,&quot;支付宝扫码&quot;,&quot;13.90&quot;,&quot;商品2&quot;,&quot;备注21&quot;,&quot;备注12&quot;,&quot;&quot;,&quot;&quot;
&quot;2021-05-17 00:47:01&quot;,&quot;2021-05-17 00:47:19&quot;,&quot;100860101234&quot;,&quot;8QLUXPPB&quot;,&quot;202105170000002257480874&quot;,&quot;R1473166176587415554&quot;,&quot;退款&quot;,&quot;一码付&quot;,&quot;支付宝扫码&quot;,&quot;-13.90&quot;,&quot;商品2&quot;,&quot;备注21&quot;,&quot;备注12&quot;,&quot;202105160000002257480874&quot;,&quot;S1473166176587415554&quot;</code></pre>
<h6>交易对账单-营销活动版1.1</h6>
<pre><code>&quot;账单日期&quot;,&quot;2021-05-16&quot;,&quot;对账单所属商户编号&quot;,&quot;10086001234&quot;
&quot;交易总金额&quot;,&quot;435.80&quot;,&quot;退款总金额&quot;,&quot;-13.90&quot;
&quot;交易总笔数&quot;,&quot;2&quot;,&quot;退款总笔数&quot;,&quot;1&quot;
&quot;用户实际支付总金额&quot;,&quot;1.57&quot;,&quot;用户实际退款总金额&quot;,&quot;-1.54&quot;
&quot;渠道营销费用&quot;,&quot;-0.15&quot;,&quot;渠道营销费用退回&quot;,&quot;0.15&quot;
&quot;交易时间&quot;,&quot;支付时间&quot;,&quot;商户编号&quot;,&quot;机构编码&quot;,&quot;商户订单号&quot;,&quot;微保订单号&quot;,&quot;业务类型&quot;,&quot;支付产品&quot;,&quot;支付方式&quot;,&quot;金额&quot;,&quot;商品名称&quot;,&quot;备注1&quot;,&quot;备注2&quot;,&quot;原订单商户订单号&quot;,&quot;原订单支付流水号&quot;,&quot;渠道活动费用&quot;,&quot;用户支付金额&quot;
&quot;2021-05-16 02:00:56&quot;,&quot;2021-05-16 02:01:03&quot;,&quot;100860101234&quot;,&quot;6RNUX7HR&quot;,&quot;202105160000002257515178&quot;,&quot;S1473166176587415553&quot;,&quot;收款&quot;,&quot;一码付&quot;,&quot;公众号支付&quot;,&quot;13.90&quot;,&quot;商品1&quot;,&quot;备注11&quot;,&quot;备注12&quot;,&quot;&quot;,&quot;&quot;,&quot;-0.04&quot;,&quot;&quot;
&quot;2021-05-16 00:46:01&quot;,&quot;2021-05-16 00:46:19&quot;,&quot;100860101234&quot;,&quot;8QLUXPPB&quot;,&quot;202105160000002257480874&quot;,&quot;S1473166176587415554&quot;,&quot;收款&quot;,&quot;一码付&quot;,&quot;支付宝扫码&quot;,&quot;13.90&quot;,&quot;商品2&quot;,&quot;备注21&quot;,&quot;备注12&quot;,&quot;&quot;,&quot;&quot;,&quot;-0.02&quot;,&quot;&quot;
&quot;2021-05-17 00:47:01&quot;,&quot;2021-05-17 00:47:19&quot;,&quot;100860101234&quot;,&quot;8QLUXPPB&quot;,&quot;202105170000002257480874&quot;,&quot;R1473166176587415554&quot;,&quot;退款&quot;,&quot;一码付&quot;,&quot;支付宝扫码&quot;,&quot;-13.90&quot;,&quot;商品2&quot;,&quot;备注21&quot;,&quot;备注12&quot;,&quot;202105160000002257480874&quot;,&quot;S1473166176587415554&quot;,&quot;0.02&quot;.&quot;&quot;</code></pre>
<h6>交易对账单-支付方式</h6>
<table>
<thead>
<tr>
<th>标识</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>WECHAT_SCAN</td>
<td>公众号扫码</td>
</tr>
<tr>
<td>WECHAT_JSAPI</td>
<td>公众号支付</td>
</tr>
<tr>
<td>MINI_PROGRAM</td>
<td>小程序</td>
</tr>
<tr>
<td>ALIPAY_SCAN</td>
<td>支付宝扫码</td>
</tr>
<tr>
<td>ALIPAY_LIFE</td>
<td>支付宝生活号</td>
</tr>
<tr>
<td>ALIPAY_H5</td>
<td>支付宝H5</td>
</tr>
<tr>
<td>ALIPAY_APP</td>
<td>支付宝APP</td>
</tr>
<tr>
<td>UNION_JSPAY</td>
<td>银联云闪付</td>
</tr>
<tr>
<td>B2B</td>
<td>B2B</td>
</tr>
<tr>
<td>B2C</td>
<td>B2C</td>
</tr>
<tr>
<td>BANKTRANSFERPAY</td>
<td>银行转账支付</td>
</tr>
<tr>
<td>BINDCARDPAY</td>
<td>绑卡支付</td>
</tr>
<tr>
<td>JDPAY_H5WALLET</td>
<td>京东钱包</td>
</tr>
<tr>
<td>JDPAY_H5CREDIT</td>
<td>京东白条<span style="color:#F00"> (暂不支持)</td>
</tr>
</tbody>
</table>