微信支付

2023-11-11 02:07| 来源: 网络整理| 查看: 265

返回上一层文档首页 / 申请交易账单API 申请交易账单API

最新更新时间：2021.12.10 版本说明

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

注意：

• 微信侧未成功下单的交易不会出现在对账单中。支付成功后撤销的交易会出现在对账单中，跟原支付单订单号一致；

• 对账单中涉及金额的字段单位为“元”；

• 对账单接口只能下载三个月以内的账单。

接口说明

适用对象：直连商户

请求URL：https://api.mch.weixin.qq.com/v3/bill/tradebill

请求方式：GET

path指该参数为路径参数

query指该参数需在请求URL传参

body指该参数需在请求JSON传参

请求参数参数名变量类型[长度限制] 必填描述账单日期 bill_date string[1,10] 是 query 格式yyyy-MM-dd 仅支持三个月内的账单下载申请。示例值：2019-06-11 账单类型 bill_type string[1,32] 否 query 不填则默认是ALL 枚举值： ALL：返回当日所有订单信息（不含充值退款订单） SUCCESS：返回当日成功支付的订单（不含充值退款订单） REFUND：返回当日退款订单（不含充值退款订单）示例值：ALL 压缩类型 tar_type string[1,32] 否 query 不填则默认是数据流枚举值： GZIP：返回格式为.gzip的压缩包账单示例值：GZIP 请求示例 URL https://api.mch.weixin.qq.com/v3/bill/tradebill?bill_date=2020-12-31&bill_type=ALL ｛ JAVA示例代码｝返回参数参数名变量类型[长度限制] 必填描述哈希类型 hash_type string[1,32] 是枚举值： SHA1：SHA1值示例值：SHA1 哈希值 hash_value string[1,1024] 是原始账单（gzip需要解压缩）的摘要值，用于校验文件的完整性。示例值：79bb0f45fc4c42234a918000b2668d689e2bde04 账单下载地址 download_url string[1,2048] 是供下一步请求账单文件的下载地址，该地址30s内有效。示例值：https://api.mch.weixin.qq.com/v3/billdownload/file?token=xxx 返回示例正常示例 { "download_url": "https://api.mch.weixin.qq.com/v3/billdownload/file?token=6XIv5TUPto7pByrTQKhd6kwvyKLG2uY2wMMR8cNXqaA_Cv_isgaUtBzp4QtiozLO", "hash_type": "SHA1", "hash_value": "8823044c286bea726f149bfcfce0b0318122d755" } http://2323weixin.qq.com 错误码公共错误码状态码错误码描述解决方案 500 SYSTEM_ERROR 系统错误系统异常，请使用相同参数稍后重新调用 400 PARAM_ERROR 参数错误请使用正确的参数重新调用 400 INVALID_REQUEST 参数错误请检查bill_date，并重新调用 400 NO_STATEMENT_EXIST 账单文件不存在请检查当前商户号是否在指定日期有交易或退款发生 400 STATEMENT_CREATING 账单生成中请先检查当前商户号在指定日期内是否有成功的交易或退款，若有，则在T+1日上午8点后再重新下载 400 INVALID_REQUEST 参数错误请按第一步申请账单的API指引，重新获取账单地址后再请求 403 NO_AUTH 权限异常请检查本次请求的商户是否与第一步申请账单API的请求商户一致

【本文地址】

公司简介

联系我们