查询银行转账充值结果

更新时间:2024.09.25

提交充值申请后,可调用该接口查询充值状态。银行充值到账存在延迟:一般可在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

1curl -X GET \
2  https://api.mch.weixin.qq.com/v3/recharge/bank-transfer-recharges/out-recharge-no/cz202407181234 \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json"

返回参数

200 OK

 

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

1{
2  "accept_time": "2024-09-18T16:52:44+08:00",
3  "account_type": "BASIC",
4  "bank_transfer_info": {
5    "bank_card_tail": "7310",
6    "bank_name": "招商银行",
7    "bill_no": "bank_bill_no_8923918116",
8    "memo": "测试附言"
9  },
10  "mchid": "2600017184",
11  "out_recharge_no": "test260001718403",
12  "recharge_amount": {
13    "amount": 80000000000,
14    "currency": "CNY"
15  },
16  "recharge_id": "172664956467128801",
17  "recharge_scene": "NORMAL_BANK_TRANSFER",
18  "recharge_state": "SUCCESS",
19  "recharge_state_desc": "充值成功",
20  "success_time": "2024-09-18T16:53:06+08:00"
21}

错误码

业务错误码

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数格式校验失败

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

400

INVALID_REQUEST

请求参数符合参数格式,但不符合业务规则

请根据错误提示处理

400

INVALID_REQUEST

充值单不存在

请检查充值单号

403

NO_AUTH

商户无权限

请联系对接的运营人员申请权限

429

FREQUENCY_LIMIT_EXCEED

频率超限

该笔请求未处理,请降低频率后使用相同的参数再重试

500

SYSTEM_ERROR

系统错误

请使用相同参数稍后重试

 

 

更多技术问题
技术咨询
反馈
咨询
目录
置顶