数据格式
请求网易支付查询单笔订单的接口采用统一的参数定义规则:
参数 | 参数名称 | 长度 | 必填 | 样例 |
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:交易明细对账[下载文件内容不加签名]; WITHDRAW_BILL:提现对账单 |
返回参数
参数 | 参数名称 | 是否为空 | 样例 |
msg | 处理结果报文 | 如果查询失败为空 | |
sign | Msg签名信息 | 如果查询失败为空 | |
operationCode | 返回码 | 不为空 | 0000 |
errorMsg | 错误内容 | 如果查询失败, 返回错误详细信息;查询成功为空 | msg_is_null |
Msg中的参数说明
参数 | 参数名称 | 样例 |
businessResp | 业务操作返回码 | 020000 |
detailMsg | 业务操作返回信息 | 操作成功 |
*platformId * | 转出平台商户号,原样返回 | 2009061117PT25762148 |
downloadUrl | 下载的账单的url地址(需要到nos下载,具有时效性); |
csv文件,每列以英文逗号隔开
由定时任务每日凌晨生成昨天的对账单。如果是交易对账单,查询时间根据商户订单日期PLATFORM_ORDERDATE查,对账单中含有(“已付款,等待卖家发货”、“已发货”、“交易成功”、“卖家审核中”、“退款审核中”、“已退款”)这6状态的订单;
如果是收支明细对账单,查询时间根据operation_time字段查。
第一行为标题行,最后一行显示了总交易金额和总交易笔数,中间行为所有的交易明细。
订单状态说明:
订单状态 | 状态说明 |
1 | 已付款 |
2 | 已发货 |
3 | 交易成功 |
4 | 退款处理中 |
5 | 已退款 |
7 | 卖家资料审核中 |
比不含签名的交易对账单多了“签名”列
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> |