企业内部开发
基础
连接微信
办公
会议
会议统计管理
企业内部开发
服务端API
小程序接入对外收款
账单
交易账单申请
交易账单申请
最后更新:2024/12/09

按天提供交易账单文件,服务商可以通过该接口获取账单文件的下载地址。文件内包含交易相关的金额、时间、营销等信息,供商户核对订单、退款、银行到账等情况。

 

请求方式: POST(HTTPS)
请求URL: https://qyapi.weixin.qq.com/cgi-bin/miniapppay/get_bill?access_token=ACCESS_TOKEN

请求包体

{
	"bill_date":"xx",
	"mchid":"xx",
	"bill_type":"xx",
	"tar_type":"xx"
}

参数说明:

参数名变量类型[长度限制]必填描述
账单日期bill_datestring[10,10]query 格式yyyy-MM-dd
仅支持三个月内的账单下载申请。
示例值:2019-06-11
商户号mchidstring[8,32]用于下载某个商户下的交易或退款数据。
示例值:1900000001
账单类型bill_typestring[1,32]query 不填则默认是ALL
枚举值:
ALL:返回当日所有订单信息(不含充值退款订单)
SUCCESS:返回当日成功支付的订单(不含充值退款订单)
REFUND:返回当日退款订单(不含充值退款订单)
示例值:ALL
压缩类型tar_typestring[1,32]query 不填则默认是数据流
枚举值:
GZIP:返回格式为.gzip的压缩包账单
示例值:GZIP

返回结果:

{
		"download_url": "xxx",
		"hash_type": "xxx",
		"hash_value": "xxx",
		"auth": "xxx"
}

参数说明

参数名变量类型[长度限制]必填描述
哈希类型hash_typestring[1,32]枚举值:
SHA1:SHA1值
示例值:SHA1
哈希值hash_valuestring[1,1024]原始账单(gzip需要解压缩)的摘要值,用于校验文件的完整性。
示例值:79bb0f45fc4c42234a918000b2668d689e2bde04
账单下载地址download_urlstring[1,2048]供下一步请求账单文件的下载地址,该地址30s内有效。
示例值:https://api.mch.weixin.qq.com/v3/billdownload/file?token=xxx
校验头authstring[1,2048]https请求校验头,用于作为https校验的Authorization
如:auth取值为"Authorization: xxx" 则可通过
curl download_url -H 'Authorzation: xxx'的方法下载到账单文件数据流

示例文件
交易账单文件内包含:明细数据表头、明细数据内容、汇总数据表头、汇总数据四个部分,每个字段使用英文逗号 , 间隔,明细数据内容每个字段前会增加1个字符 ` 用于避免获取的内容被excel展示为科学计数法的格式、丢失数据细节

交易账单示例文件

上一篇退款通知
下一篇概述
    本节内容
服务端API
基础
连接微信
办公
会议
会议统计管理
客户端API
小程序
基础
连接微信
办公
WECOM-JSSDK
JS-SDK
基础
连接微信
办公
更新日志
联系我们