查询银行转账充值结果

更新时间:2024.12.26

提交充值申请后,可调用该接口查询充值状态。银行充值到账存在延迟:一般可在10分钟内到账。受央行大额系统工作时间限制,周一至周四17:15-20:30,周五17:15-24:00,节假日全天会延迟到账

# 接口说明

支持商户:
【普通商户】
请求方式:
【GET】/v3/recharge/bank-transfer-recharges/out-recharge-no/{out_recharge_no}
请求域名:
【主域名】
https://api.mch.weixin.qq.com
使用该域名将访问就近的接入点
【备域名】
https://api2.mch.weixin.qq.com
使用该域名将访问异地的接入点 ,指引点击查看

# 请求参数

    Header HTTP头参数
  • Authorization 必填 string
    请参考 签名认证 生成认证信息
  • Accept 必填 string
    请设置为 application/json
    Path 路径参数
  • out_recharge_no 必填 string(64)
    【商户充值单号】 商户系统内部的充值单号,只能由数字、大小写字母组成,在平台商户系统内部唯一

请求示例

GET

# 返回参数

    200OK
  • mchid 必填 string(32)
    【充值商户号】 微信支付分配的商户号,充值商户号
  • recharge_id 必填 string(27)
    【微信支付充值单号】 微信支付充值单号
  • out_recharge_no 必填 string(64)
    【商户充值单号】 商户系统内部的充值单号,只能由数字、大小写字母组成,在平台商户系统内部唯一
  • account_type 必填 string
    【充值入账账户】 充值入账账户。可选取值:
    • BASIC: 基本户
    • OPERATION: 运营户
    • FEES: 手续费账户
  • recharge_state 必填 string
    【充值状态】 充值状态。可选取值:
    • SUCCESS: 充值成功
    • RECHARGING: 充值中
    • CLOSED: 已关闭(充值单七天有效,如若商户不充值,则过期系统会自动关闭)
  • recharge_scene 必填 string
    【充值场景】 充值场景。可选取值:
    • NORMAL_BANK_TRANSFER: 银行转账充值
  • recharge_state_desc 选填 string(64)
    【充值状态描述】 展示关闭充值的原因,如“平台商户主动关闭充值单”、“超过时间限制,系统自动关闭充值单”等
  • recharge_amount 必填 object
    【充值金额】 单位为分,仅支持CNY
    • 属性
  • bank_transfer_info 选填 object
    【转账充值的付款信息】 包括充值附言等内容
    • 属性
  • accept_time 选填 string(32)
    【受理充值时间】 微信支付成功受理充值时间,不代表充值已经完成,使用rfc3339标准格式
  • success_time 选填 string(32)
    【充值成功时间】 当状态为“充值成功”时返回,使用rfc3339标准格式
  • close_time 选填 string(32)
    【关闭充值时间】 当状态为“已关闭”时返回,使用rfc3339标准格式

返回示例

200 OK

# 错误码

# 业务错误码

状态码 错误码 描述 解决方案
400 PARAM_ERROR 参数格式校验失败 请根据错误提示正确传入参数
400 INVALID_REQUEST 请求参数符合参数格式,但不符合业务规则 请根据错误提示处理
400 INVALID_REQUEST 充值单不存在 请检查充值单号
403 NO_AUTH 商户无权限 请联系对接的运营人员申请权限
429 FREQUENCY_LIMIT_EXCEED 频率超限 该笔请求未处理,请降低频率后使用相同的参数再重试
500 SYSTEM_ERROR 系统错误 请使用相同参数稍后重试
更多技术问题
技术咨询
反馈
咨询
目录

您当前查看的是旧版文档,将于 2025年 3 月 31日 进行下线处理。为了获得最新的内容和产品能力,请点击 [这里] 访问新版文档中心