对账文件下载API

数据格式

请求网易支付查询单笔订单的接口采用统一的参数定义规则:

参数

参数名称

长度

必填

样例

sign

根据msg和算法签名后的字符

String


msg

消息体,根据业务参数列表,拼装而成的消息体

String


msgType

消息类型,XML,JSON

String

XML

比如:https://api.epay.163.com/generate_trade_bill_service.htm?platformId=xxx&msg=&msgType=&sign=,其中platformId、msg、msgType和sign是必填参数。
*platformId:*商户号,用于商户路由和商户限流,platformId放在http请求的url里,其他请求业务参数封装好后放在post参数中;如果有特殊字符为避免请求被转码等问题,每个参数发送时需进行UrlEncode。


接口地址

https://api.epay.163.com/generate_trade_bill_service.htm?

platformId=2014082822PT79963677&msg=ewogICAgInZlcnNpb24iOiAiMS4wLjAiLAogICAgImFjdGlvbiI6ICJxdWVyeV90cmFkZV9iaWxsX2Rvd25sb2FkX3VybCIsCiAgICAicGxhdGZvcm1JZCI6ICIyMDE0MDgyODIyUFQ3OTk2MzY3NyIsCiAgICAidHJhZGVUaW1lIjogIjIwMTYwMjAzIiwKICAgICJmaWxlVHlwZSI6Ik9SREVSX0JJTExfTk9fU0lHTkVEIgp9&msgType=JSON&sign=123

 

查询参数

参数

参数名称

长度

必填

样例

version

版本号

8

1.0.0

action

操作名称

30

query_trade_bill_download_url

platformId 

商户平台ID

60

2014082822PT79963677

tradeTime 

平台对账下载时间,格式:yyyyMMdd *

8

20160203

fileType

文件类型 *

30

ORDER_BILL_NO_SIGNED:交易明细对账[下载文件内容不加签名];
ORDER_BILL_SIGNED:交易明细对账[下载文件内容加签名];
ACCOUNT_BALANCE_BILL:收支明细对账单

WITHDRAW_BILL:提现对账单


返回参数

参数

参数名称

是否为空

样例

msg

处理结果报文

如果查询失败为空


sign

Msg签名信息

如果查询失败为空


operationCode

返回码

不为空

0000

errorMsg

错误内容

如果查询失败, 返回错误详细信息;查询成功为空

msg_is_null

Msg中的参数说明

参数

参数名称

样例

businessResp

业务操作返回码

020000

detailMsg

业务操作返回信息

操作成功

*platformId *

转出平台商户号,原样返回

2009061117PT25762148  

downloadUrl

下载的账单的url地址(需要到nos下载,具有时效性); 
  
如果为null,则表示该平台号当前日期的对账单还没有生成


 

对账单文件说明

文件格式

csv文件,每列以英文逗号隔开

文件生成说明

由定时任务每日凌晨生成昨天的对账单。如果是交易对账单,查询时间根据商户订单日期PLATFORM_ORDERDATE查,对账单中含有(已付款,等待卖家发货已发货交易成功卖家审核中退款审核中已退款)这6状态的订单;

如果是收支明细对账单,查询时间根据operation_time字段查。

文件内容说明

1)交易对账单(不含签名)

点此下载文件示例

第一行为标题行,最后一行显示了总交易金额和总交易笔数,中间行为所有的交易明细。

订单状态说明:

订单状态 

状态说明

1

已付款

2

已发货

3

交易成功

4

退款处理中

5

已退款

7

卖家资料审核中 

2)交易对账单(含签名)

比不含签名的交易对账单多了签名

3)收支明细对账单

10行统计了当日各种类型订单的统计信息,如下:

网易支付对账单(20160511 


当日交易金额:

5268.67

当日提现金额:

0

当日充值金额:

0

当日交易退款金额:

0

当日提现退款金额:

0

当日充值退款金额:

0

当日转账金额:

0

当日商户交易前余额:

1521571.23

当日商户交易后剩余余额:

1526839.9

11行为标题行,11行后为具体的收支明细。

收支明细(不含积分明细):点此下载文件示例

如果商户具有积分明细查询接口的权限(权限名query_jf_account_detail,版本为1.0.0),那么收支明细对账单中还有积分明细(在收支明细之后)。

收支明细和积分明细对账单:点此下载文件示例

4)提现对账单

第一行为标题行,其余行是每笔提现明细。

状态字段说明(均为提现最终状态):


状态
描述
SUCCESS提现成功
FAIL提现失败

提现对账单:点此下载文本示例


5)对账单csv文件解析(Java示例)

相关类:com.csvreader.CsvReader

pom.xml引入:

 <dependency>
    <groupId>net.sourceforge.javacsv</groupId>
    <artifactId>javacsv</artifactId>
    <version>2.0</version>
  </dependency>