支付寶 對賬說明

目前支付寶對外的常用對賬方式有兩種：一種是通過在支付寶后臺下載賬單的方式來對賬；一種是通過調(diào)用接口的方式來實(shí)現(xiàn)對賬。

新企業(yè)版賬單下載

商戶財(cái)務(wù)人員登錄新企業(yè)版（qy.alipay.com），可通過賬單下載頁面，下載登錄賬戶的已完成結(jié)算的對賬單，并使用該數(shù)據(jù)完成財(cái)務(wù)核算。

一、日賬單下載

進(jìn)入日賬單下載頁面，默認(rèn)顯示最近日賬單的所在月份，默認(rèn)選中最近日賬單所在日期。鼠標(biāo)移動(dòng)到已完成結(jié)算的日期，顯示可下載鏈接。點(diǎn)擊所在日期可進(jìn)行下載。

特殊說明

1. 賬單未生成：前一日的日賬單在第二天生成，在第二天生成之前在下載區(qū)域提示“賬單未生成”，不可點(diǎn)擊下載。

1. 本日無收支：若已完成結(jié)算的某日無任何收支，則在下載區(qū)域提示“本日無收支”，不可點(diǎn)擊下載。

1. 日賬單下載，支持范圍從2013年1月1日開始。

二、月賬單下載

月賬單下載功能同日賬單下載。進(jìn)入月賬單下載頁面，默認(rèn)顯示最近月賬單的所在年份，默認(rèn)選中最近月賬單所在月份。鼠標(biāo)移動(dòng)到已完成結(jié)算的日期，顯示可下載鏈接。點(diǎn)擊所在月份可進(jìn)行下載。

特殊說明

1. 賬單未生成

1. 月賬單下載，支持范圍從2013年1月開始。

1. 每月賬單一般會在次月4日或之前生成。

接口對賬方式

場景介紹

商戶/系統(tǒng)商可通過接口下載指定日期（當(dāng)天除外）的業(yè)務(wù)明細(xì)賬單文件，并結(jié)合自身業(yè)務(wù)系統(tǒng)實(shí)現(xiàn)自動(dòng)對賬。

獲取賬單技術(shù)實(shí)現(xiàn)大致分兩種模式：收款賬號接入模式（簽約賬號即為收款賬號）、主賬號簽約接入模式（此種模式包括ISV接入模式、一個(gè)主賬號簽約+N個(gè)收款賬號接入模式）。

1. 收款賬號接入模式

下載接口中指定appid所對應(yīng)PID下所有交易記錄的對賬單。

1. 主賬號簽約接入模式

包括ISV接入模式、一個(gè)主賬號簽約+N個(gè)收款賬號接入模式。

第一步：該應(yīng)用在開放平臺上添加第三方應(yīng)用授權(quán)功能。讓收款賬號給簽約主賬號授權(quán)。收款賬號無需簽約賬單下載接口權(quán)限。

第二步：請獲取服務(wù)端SDK進(jìn)行接口開發(fā)，請?jiān)谡埱髤?shù)中傳入授權(quán)token。簽約賬號即可查詢收款賬號的賬單。包括賬務(wù)賬單和業(yè)務(wù)賬單。

調(diào)用流程

1. 商戶系統(tǒng)調(diào)用查詢對賬單下載地址接口alipay.data.dataservice.bill.downloadurl.query，傳入指定日期，獲得該日期賬單文件的下載地址。
2. 商戶系統(tǒng)通過HTTP方式后臺訪問賬單下載鏈接，將賬單csv文件下載到本地后自行處理。注意該下載鏈接僅30秒，在得到鏈接后系統(tǒng)需要立刻請求下載賬單文件。

使用SDK快速接入

查詢對賬單下載地址接口alipay.data.dataservice.bill.downloadurl.query：

AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do", APP_ID, APP_PRIVATE_KEY, "json", CHARSET, ALIPAY_PUBLIC_KEY, "RSA2");//獲得初始化的AlipayClient
AlipayDataDataserviceBillDownloadurlQueryRequest request = new AlipayDataDataserviceBillDownloadurlQueryRequest();//創(chuàng)建API對應(yīng)的request類
request.setBizContent("{" +
"    \"bill_type\":\"trade\"," +
"    \"bill_date\":\"2016-04-05\"}"); //設(shè)置業(yè)務(wù)參數(shù)
AlipayDataDataserviceBillDownloadurlQueryResponse response = alipayClient.execute(request);//通過alipayClient調(diào)用API，獲得對應(yīng)的response類
System.out.print(response.getbody());
//根據(jù)response中的結(jié)果繼續(xù)業(yè)務(wù)邏輯處理

關(guān)鍵入?yún)ⅲ?/p>

關(guān)鍵出參：

下載賬單文件：

//將接口返回的對賬單下載地址傳入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();
    }
}

附錄

業(yè)務(wù)明細(xì)賬單：

賬務(wù)賬單明細(xì)：