按日下载提现异常文件

更新时间:2024.11.18

服务商按日查询并下载提现状态为异常的提现单,提现异常包括提现失败和银行退票。

注意

  • 每日09:00开始可以下载前一日的提现异常文件,支持下载90天内提现状态变为提现异常的提现单文件。

  • 日期(date)字段为提现状态变为提现异常的日期。建议输入日期为昨日,每天定时(早上9点后)查询昨日是否有状态为异常的提现单。

  • 电商服务商查询的结果包括电商服务商发起的提现和给电商二级商户发起的提现。

  • 同一笔提现的相同数据可能出现在不同日期。即提现单A的失败数据,可能同时出现在1日和3日。

  • 历史数据如果有某一日遗漏,则系统会补入当天的账单中。例如:今日为2019-11-15日,发现2019-11-12日某数据遗漏,则该数据会补入2019-11-15日。

接口说明

支持商户:【普通服务商】

请求方式:【GET】/v3/merchant/fund/withdraw/bill-type/{bill_type}

请求域名:【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点

     【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点 ,指引点击查看

请求参数

Header HTTP头参数

Authorization  必填 string

请参考签名认证生成认证信息


Accept  必填 string

请设置为application/json


path 路径参数

bill_type  必填 string

【账单类型】 账单类型

可选取值

  • NO_SUCC: 提现异常账单,包括提现失败和提现退票账单


query 查询参数

bill_date  必填 string(10)

【账单日期】 表示所在日期的提现账单,格式YYYY-MM-DD。例如:2008-01-01日发起的提现,2008-01-03日银行返回提现失败,则该提现数据将出现在bill_date为2008-01-03日的账单中


tar_type  选填 string

【压缩格式】 压缩格式,不填则默认是数据流

可选取值

  • GZIP: 返回格式为.gzip的压缩包账单

请求示例

GET

1curl -X GET \
2  https://api.mch.weixin.qq.com/v3/merchant/fund/withdraw/bill-type/NO_SUCC?bill_date=2019-08-17&tar_type=GZIP \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" 

应答参数

200 OK

hash_type  必填 string

【哈希类型】 从download_url下载的文件的哈希类型,用于校验文件的完整性。


hash_value  必填 string

【哈希值】 从download_url下载的文件的哈希值,用于校验文件的完整性


download_url  必填 string

【下载地址】 供下一步请求账单文件的下载地址,该地址30s内有效。

应答示例

200 OK

1{
2  "hash_type" : "SHA1",
3  "hash_value" : "79bb0f45fc4c42234a918000b2668d689e2bde04",
4  "download_url" : "https://xxxx.xxx.xxx"
5}

样例文件

提现异常账单.xlsx

错误码

公共错误码

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

请根据错误提示正确传入参数

400

INVALID_REQUEST

HTTP 请求不符合微信支付 APIv3 接口规则

请参阅 接口规则

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

业务错误码

状态码

错误码

描述

解决方案

400

INVALID_REQUEST

请求的账单日期已过期

请检查bill_date,并重新调用

400

NO_STATEMENT_EXIST

请求的账单文件不存在

请检查当前商户号请求的微信支付账户在指定日期是否有资金操作

400

STATEMENT_CREATING

请求的账单正在生成中

请先检查当前商户号的微信支付账户在指定日期内是否有资金操作,若有,则在T+1日上午10点后再重新下载

403

NO_AUTH

当前商户号没有使用该接口的权限

请确认是否已经开通相关权限

500

SYSTEM_ERROR

系统错误

系统异常,请使用相同参数稍后重新调用

 

 

反馈
咨询
目录
置顶