对账说明
新企业版账单下载
trabill_type = signcustomer
账单。trabill_type = trade
账单。
日账单下载
**
特殊说明
月账单下载
特殊说明
接口对账方式
场景介绍
收款账号接入模式
主账号开通接入模式
调用流程

1.
2.
使用SDK快速接入
package com.java.sdk.demo;
import com.alipay.v3.ApiException;
import com.alipay.v3.ApiClient;
import com.alipay.v3.util.model.AlipayConfig;
import com.alipay.v3.Configuration;
import com.alipay.v3.api.AlipayDataDataserviceBillDownloadurlApi;
import com.alipay.v3.model.*;
import java.io.File;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
public class AlipayDataDataserviceBillDownloadurlApiQuery {
public static void main(String[] args) throws ApiException {
ApiClient defaultClient = Configuration.getDefaultApiClient();
// 初始化alipay参数(全局设置一次)
AlipayConfig alipayConfig = new AlipayConfig();
alipayConfig.setServerUrl("https://openapi.alipay.com");
alipayConfig.setAppId("<-- 请填写您的AppId,例如:2019091767145019 -->");
alipayConfig.setPrivateKey("<-- 请填写您的应用私钥,例如:MIIEvQIBADANB ... ... -->");
alipayConfig.setAlipayPublicKey("<-- 请填写您的支付宝公钥,例如:MIIBIjANBg... -->");
defaultClient.setAlipayConfig(alipayConfig);
AlipayDataDataserviceBillDownloadurlApi api = new AlipayDataDataserviceBillDownloadurlApi();
String billType = "trade";
String billDate = "2016-04-05";
String smid = "2088123412341234";
try {
AlipayDataDataserviceBillDownloadurlQueryResponseModel response = api.query(billType, billDate, smid);
} catch (ApiException e) {
AlipayDataDataserviceBillDownloadurlQueryDefaultResponse errorObject = (AlipayDataDataserviceBillDownloadurlQueryDefaultResponse) e.getErrorObject();
System.out.println("调用失败:" + errorObject);
}
}
}
关键入参
参数名称 | 参数说明 |
---|---|
bill_type | 账单类型,枚举支持:trade:商家基于支付宝交易收单的业务账单,对应 对账中心 > 账单下载 的 交易账单。signcustomer:基于商家支付宝余额收入及支出等资金变动的账务账单,对应 对账中心 > 账单下载 的 资金账单。 |
bill_date | 需要下载的账单日期,最晚是当期日期的前一天。 |
关键出参
参数名称 | 参数说明 |
---|---|
bill_download_url | 账单文件下载地址,30 秒有效。 |
下载账单文件
//将接口返回的对账单下载地址传入urlStr
String urlStr = "http://dwbillcenter.alipay.com/downloadBillFile.resource?bizType=X&userId=X&fileType=X&bizDates=X&downloadFileName=X&fileId=X";
//指定希望保存的文件路径
String filePath = "/Users/fund_bill_20160405.zip";
URL url = null;
HttpURLConnection httpUrlConnection = null;
InputStream fis = null;
FileOutputStream fos = null;
try {
url = new URL(urlStr);
httpUrlConnection = (HttpURLConnection) url.openConnection();
httpUrlConnection.setConnectTimeout(5 * 1000);
httpUrlConnection.setDoInput(true);
httpUrlConnection.setDoOutput(true);
httpUrlConnection.setUseCaches(false);
httpUrlConnection.setRequestMethod("GET");
httpUrlConnection.setRequestProperty("Charsert", "UTF-8");
httpUrlConnection.connect();
fis = httpUrlConnection.getInputStream();
byte[] temp = new byte[1024];
int b;
fos = new FileOutputStream(new File(filePath));
while ((b = fis.read(temp)) != -1) {
fos.write(temp, 0, b);
fos.flush();
}
} catch (MalformedURLException e) {
e.printStackTrace();
} catch (IOException e) {
e.printStackTrace();
} finally {
try {
if(fis!=null) fis.close();
if(fos!=null) fos.close();
if(httpUrlConnection!=null) httpUrlConnection.disconnect();
} catch (IOException e) {
e.printStackTrace();
}
}
附录
业务账单
汇总

业务账单明细

账单与支付接口字段对应关系
支付宝交易号 | 商户订单号 | 商品名称 | 门店编号 | 门店名称 | 终端号 | 订单金额(元) | 商家实收(元) | 集分宝(元) | 商家优惠(元) | 券核销金额(元) | 券名称 | 退款批次号 | 服务费(元) |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
trade_no | out_trade_no | goods_detail#goods_name | store_id | store_name | terminal_id | total_amount | receipt_amount | point_amount | mdiscount_amount | voucher_detail_list#amount | voucher_detail_list#name | batch_no | charge_amount |
支付宝系统中全局唯一标识用户一笔交易的流水号。 | 商户系统中唯一标识一笔用户交易的流水号。 | 商品名称。 | 商户门店编号。 | 请求交易支付中的商户店铺的名称。 | 商户机具终端编号。 | 订单总金额,单位为 元。 | 商家实收=订单金额 total_amount - 商户出资的优惠金额 。 | 该笔交易过程中使用集分宝的付款金额。 | 该笔交易过程中使用的商家优惠金额。 | 该笔交易过程中使用优惠券核销的付款金额。 | 本笔交易使用的券名称。 | 该笔交易产生退款后退款批次识别号,对应退款 out_request_no 字段。 | 该笔交易收取商家服务费(手续费)金额。 |
账务账单
汇总

账务账单明细

下载设置

