查询银行转账充值结果

更新时间：2024.12.19

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

接口说明

支持商户：【平台商户】

请求方式：【GET】/v3/platsolution/ecommerce/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/platsolution/ecommerce/bank-transfer-recharges/out-recharge-no/cz202407181234 \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" 
5

应答参数

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

【充值场景】仅支持平台商户银行转账充值

可选取值

ECOMMERCE_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  "mchid" : "1900001121",
3  "recharge_id" : "172234484162395401",
4  "out_recharge_no" : "cz2020042013",
5  "account_type" : "DEPOSIT",
6  "recharge_state" : "SUCCESS",
7  "recharge_scene" : "ECOMMERCE_DEPOSIT",
8  "recharge_state_desc" : "超过时间限制，系统自动关闭充值单",
9  "recharge_amount" : {
10    "amount" : 500000,
11    "currency" : "CNY"
12  },
13  "bank_transfer_info" : {
14    "memo" : "转账充值附言",
15    "return_time" : "2015-05-20T13:29:35+08:00",
16    "return_reason" : "银行转账充值金额与申请充值金额不一致",
17    "bank_name" : "中国银行",
18    "bank_card_tail" : "0722",
19    "bank_account_name" : "某某某有限公司"
20  },
21  "accept_time" : "2015-05-20T13:29:35+08:00",
22  "success_time" : "2015-05-20T13:29:35+08:00",
23  "close_time" : "2015-05-20T13:29:35+08:00"
24}
25

错误码

公共错误码

状态码	错误码	描述	解决方案
400	PARAM_ERROR	参数错误	请根据错误提示正确传入参数
400	INVALID_REQUEST	HTTP 请求不符合微信支付 APIv3 接口规则	请参阅接口规则
401	SIGN_ERROR	验证不通过	请参阅签名常见问题
500	SYSTEM_ERROR	系统异常，请稍后重试	请稍后重试

业务错误码

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

文档是否有帮助

更多支持

开发文档(商户)开发文档(V2版)开发者社区微信开放平台微信公众平台腾讯客服