查询对账单下载地址接口注意事项

简介: 接口调用示例流程建议参考:alipay.data.dataservice.bill.downloadurl.query(查询对账单下载地址) 集成流程  一、bill_download_url 下载账单地址参数解析  1、bizType参数是依据下载账单传入的账单类型bill_type来确定的,如果传入的是bill_type是trade那么地址中的 bizType=trade,如果传入的bill_type是signcustomer那么bizType=fnd   2、userId参数是下载的账单对应的用户的pid后拼接上0156(最后四个数字请忽略)。

接口调用示例流程建议参考:alipay.data.dataservice.bill.downloadurl.query(查询对账单下载地址) 集成流程  

一、bill_download_url 下载账单地址参数解析  

1、bizType参数是依据下载账单传入的账单类型bill_type来确定的,

如果传入的是bill_type是trade那么地址中的 bizType=trade,

如果传入的bill_type是signcustomer那么bizType=fnd   

2、userId参数是下载的账单对应的用户的pid后拼接上0156(最后四个数字请忽略)。 

 如示例中的userId=20885016245603350156对应的商户pid=2088501624560335   

3、fileType为下载账单格式。fileType=csv.zip表示账单是csv格式的压缩文件   

4、bizDates为传入的下载的账单的日期,比如下载2018年01月的账单bizDates=201801   

5、downloadFileName为账单下载地址下载的文件的名称   

6、timestamp是账单下载地址的获取时间,token可以用来标记账单下载地址,每一次生成账单下载地址生成的时候这两个参数都不同   

7、如果是使用第三方应用授权调用userId和downloadFileName中的pid参数是授权商户app_auth_token对应的pid也就是账单对应的客户的pid,不是调用接口的商户的pid  

8、账单的下载格式是csv格式的表格,该表格的文字编码是ANSI编码(不同的国家和地区制定了不同的标准,由此产生了 GB2312、GBK、Big5、Shift_JIS 等各自的编码标准。这些使用 1 至 4 个字节来代表一个字符的各种汉字延伸编码方式,称为 ANSI 编码。在简体中文Windows操作系统中,ANSI 编码代表 GBK 编码;在日文Windows操作系统中,ANSI 编码代表 Shift_JIS 编码。 不同 ANSI 编码之间互不兼容,当信息在国际间交流时,无法将属于两种语言的文字,存储在同一段 ANSI 编码的文本中。)

二 、常见接口报错

1、下载数据乱码

保存账单的文件路径结尾需改成.zip 

示例代码参考:下载账单文件代码示例 

2、下载超时,请重新下载

账单下载地址必须在30秒内使用,超出时间后会报错:"下载超时,请重新下载",如图:  



  

 注:出现这个错误需要调用接口重新获取账单下载地址,这里两次获取的账单下载地址timestamp和token参数就是不同的。 

三、调用接口注意事项  

1、账单类型bill_type参数有两种trade和signcustomer。

trade指商户基于支付宝交易收单的业务账单,即调用支付宝交易接口产生的交易信息,不包含非接口交易的账单信息。

signcustomer是指基于商户支付宝余额收入及支出等资金变动的帐务账单,即所有支付宝余额产生的变动的交易信息,包含调用接口产生的交易账单以及非接口交易的账单信息

2、账单下载日期支持下载日账单,月账单,不支持年度账单。

日账单:日账单不支持下载当日账单,只能下载前一日24点前的账单(T+1),日期格式如:2018-01-05  

注:建议在第二日10:00以后下载 

月账单:月账单不支持下载当月账单,只能下载上一月的账单信息,日期格式如:2018-01。 

注:月账单一般会在次月 4 日或之前生成,建议次月4号或后面日期下载。 

3、历史账单最久可以下载30个月之前的账单,具体的下载时间以实际可下载时间为准。    

4、该接口支持沙箱测试, 但是沙箱下载的账单信息为空没有实际数据,建议以正式账号下载的账单信息为准。   

 四、demo分享(仅供参考)  

 alipay.data.dataservice.bill.downloadurl.query.zip   

注:在demo中配置好自己的appid以及秘钥调用即可。   

如有其它疑问,欢迎大家在帖子后面追问!

目录
相关文章
|
Windows
windows下curl的下载和使用
windows下curl的下载和使用
1396 0
Kam
|
Java
java中使用@Value获取值为null问题解决:
java中使用@Value获取值为null问题解决
Kam
2160 0
使用JavaStream将List转为Map
使用JavaStream将List转为Map
|
4月前
|
Java API Go
阿里千问大模型API多语言对接实战:PHP/Java/.NET/Python/Go五栖开发指南
本文系统讲解了如何通过PHP、Java、.NET(C#)、Python、Go五种主流编程语言对接阿里云通义千问大模型API。从账号注册、服务开通、API Key获取等前置准备开始,详细阐述了DashScope原生SDK与OpenAI兼容接口两种调用方式。针对每种语言,均提供了完整的依赖安装、客户端初始化、单轮对话、多轮对话及流式输出的代码示例,并深入解析了请求参数、响应结构、错误处理等核心知识点。此外,文章还涵盖了WorkspaceId的配置方法、模型选型建议、RAM权限管理最佳实践以及成本优化策略,帮助开发者在不同技术栈下快速、安全地将千问大模型能力集成到实际业务中。
|
4月前
|
数据采集 供应链 API
1688开放平台API接口接入指南:从注册、认证到获取密钥全流程(附避坑点)(附python源码)
本文详解1688开放平台API接入全流程:涵盖企业账号认证、应用创建、权限申请与代码对接四大阶段,直击5大高频“坑”(如账号类型误选、签名错误、审核驳回等),并附可直接运行的Python客户端源码(含MD5签名、商品查询等核心功能),助你高效、安全打通B2B供应链。
|
6月前
|
人工智能 数据可视化 安全
OpenClaw是什么?怎么部署?超详细实操教程
OpenClaw是开源智能体框架,让AI从“只动嘴”升级为“真动手”——可直接操作电脑执行文件整理、网页搜索等任务。本文详解其云端一键部署(阿里云支持)、API配置及技能扩展,新手30分钟即可拥有专属AI助理!
622 3
|
10月前
|
缓存 API 数据安全/隐私保护
淘宝京东拼多多API应用差异大揭秘,商家必看!
本文深度解析淘宝、京东、拼多多三大电商API在接口风格、权限控制、数据推送等方面的差异,涵盖实战代码与成本优化策略,助力商家高效对接平台系统,提升运营效率。
|
数据采集 测试技术 API
用“爬虫”思路做淘宝 API 接口测试:从申请 Key 到 Python 自动化脚本
本文介绍基于淘宝开放平台TOP的合规API测试实践,结合Python与官方SDK实现接口签名、数据驱动测试及自动化爬虫。通过AppKey/AppSecret鉴权,调用taobao.item.get接口进行商品数据探测,集成响应时间监控与断言验证,支持JUnit报告与Jenkins流水线。强调遵守平台规则,避免风控,适用于价格监控、库存对账等场景,兼具合法性与高效性。(239字)
|
安全 Unix Linux
VMware Workstation 17.6.3 发布下载,现在完全免费无论个人还是商业用途
VMware Workstation 17.6.3 发布下载,现在完全免费无论个人还是商业用途
163331 65
|
前端开发
create-react-app 如何使用 less/sass 和 react-css-modules?
本文详细介绍了在 create-react-app 项目中如何使用 less/sass 和 react-css-modules 来管理和应用样式。首先,通过安装相应依赖并配置 webpack 支持 less/sass;接着,介绍如何使用这些预处理器编写样式;最后,讲解了如何配置和使用 react-css-modules 实现样式的模块化管理,以及如何结合使用 less/sass 和 react-css-modules 提高开发效率和代码质量。
553 3

热门文章

最新文章