查询二级商户充值结果

更新时间：2025.01.23

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

接口说明

支持商户：【平台商户】

请求方式：【GET】/v3/platsolution/ecommerce/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)

【商户充值单号】商户系统内部的充值单号，只能由数字、大小写字母组成，在平台商户系统内部唯一

query 查询参数

sub_mchid 　必填 string(32)

【二级商户号】二级商户号

请求示例

GET

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

应答参数

200 OK

sp_mchid 　必填 string(32)

【平台商户号】微信支付分配的商户号

sub_mchid 　必填 string(32)

【二级商户号】微信支付分配的商户号，充值商户号

recharge_id 　必填 string(27)

【微信支付充值单号】微信支付充值单号

out_recharge_no 　必填 string(64)

【商户充值单号】商户系统内部的充值单号，只能由数字、大小写字母组成，在平台商户系统内部唯一

recharge_channel 　选填 string

【充值渠道】仅在“充值成功”时返回，其它状态不返回

可选取值

BANK_TRANSFER: 银行转账
QR_RECHARGE: 扫码充值
ONLINE_BANK: 网银充值

account_type 　必填 string

【充值入账账户】仅支持保证金账户

可选取值

DEPOSIT: 保证金账户

recharge_state 　必填 string

【充值状态】充值状态

可选取值

SUCCESS: 充值成功
RECHARGING: 充值中
CLOSED: 已关闭

recharge_scene 　必填 string

【充值场景】仅支持二级商户充值保证金

可选取值

ECOMMERCE_DEPOSIT: 二级商户充值保证金

recharge_state_desc 　选填 string(64)

【充值状态描述】展示关闭充值的原因，如“平台商户主动关闭充值单”、“超过时间限制，系统自动关闭充值单”等

recharge_amount 　必填 object

【充值金额】单位为分，仅支持CNY。单笔限额规则：1、银行转账最多8亿元 2、扫码充值5万元

属性

bank_transfer_info 　选填 object

【转账充值的付款信息】仅转账充值成功后返回，包括付款账户、银行附言等内容

属性

qr_recharge_info 　选填 object

【扫码充值的付款信息】仅扫码充值成功后返回，包括充值用户OpenID

属性

openid 　选填 string(64)

【用户OpenID】用户OpenID

employee_type 　选填 string

【员工类型】员工类型

可选取值

ADMIN: 超级管理员
STAFF: 员工
LEGAL_PERSON: 法人

online_bank_recharge_info 选填 object

【网银充值的付款信息】仅网银充值成功后返回，包括付款账户、银行交易订单号等内容

属性

bill_no 选填 string(64)

【银行交易订单号】银行交易订单号

bank_name 选填 string(128)

【开户银行名称】开户银行名称

online_bank_type 选填 string

【网银类型】网银类型
可选取值：

ONLINE_BANK_TYPE_CORPORATE: 企业网银

ONLINE_BANK_TYPE_PERSONAL: 个人网银

bank_card_tail 选填 string(4)

【银行卡号后四位】银行卡号后四位

bank_account_name 选填 string(512)

【银行账户名称】银行账户名称

accept_time 　必填 string(32)

【受理充值时间】微信支付成功受理充值时间，不代表充值已经完成，使用rfc3339标准格式

success_time 　选填 string(32)

【充值成功时间】当状态为“充值成功”时返回，使用rfc3339标准格式

close_time 　选填 string(32)

【关闭充值时间】当状态为“已关闭”时返回，使用rfc3339标准格式

available_recharge_channels 　选填 array[string]

【可用充值渠道列表】申请充值时传入的可用渠道列表

可选取值

BANK_TRANSFER: 银行转账
QR_RECHARGE: 扫码充值
ONLINE_BANK: 网银充值

应答示例

200 OK

充值成功（扫码）：

1{
2  "sp_mchid": "1900001109",
3  "sub_mchid": "1900001121",
4  "recharge_id": "100000202405180012345678",
5  "out_recharge_no": "cz202407181234",
6  "recharge_channel": "QR_RECHARGE",
7  "account_type": "DEPOSIT",
8  "recharge_state": "SUCCESS",
9  "recharge_scene": "ECOMMERCE_DEPOSIT",
10  "recharge_state_desc": "充值成功",
11  "recharge_amount": {
12    "amount": 500000,
13    "currency": "CNY"
14  }, 
15  "qr_recharge_info":{
16    "employee_type": "STAFF",
17    "openid": "owYiu0WOJdGCYxoHrPabGhI39uT4"
18  },
19  "accept_time": "2015-05-19T13:29:35+08:00",
20  "success_time": "2015-05-20T14:29:35+08:00",
21  "close_time" : "2015-05-20T13:29:35+08:00",
22  "available_recharge_channels" : [
23    "QR_RECHARGE"
24  ]
25}

充值成功（银行转账）：

1{
2  "sp_mchid": "1900001109",
3  "sub_mchid": "1900001121",
4  "recharge_id": "100000202405180012345678",
5  "out_recharge_no": "cz202407181234",
6  "recharge_channel": "BANK_TRANSFER",
7  "account_type": "DEPOSIT",
8  "recharge_state": "SUCCESS",
9  "recharge_scene": "ECOMMERCE_DEPOSIT",
10  "recharge_state_desc": "充值成功",
11  "recharge_amount": {
12      "amount": 500000,
13      "currency": "CNY"
14  },
15  "bank_transfer_info": {
16      "bill_no": "111111",
17      "memo": "转账充值附言",
18      "bank_name": "中国银行",
19      "bank_card_tail": "0722",
20      "bank_account_name" : "某某某有限公司"
21  },
22  "accept_time": "2015-05-19T13:29:35+08:00",
23  "success_time": "2015-05-20T14:29:35+08:00",
24  "close_time" : "2015-05-20T13:29:35+08:00",
25  "available_recharge_channels" : [
26    "BANK_TRANSFER"
27  ]
28}

充值成功（网银）：

1{
2  "sp_mchid": "2480304861",
3  "sub_mchid": "2600021157",
4  "recharge_id": "100000202405180012345678",
5  "out_recharge_no": "cz202407181234",
6  "recharge_channel": "ONLINE_BANK",
7  "account_type": "DEPOSIT",
8  "recharge_state": "SUCCESS",
9  "recharge_scene": "ECOMMERCE_DEPOSIT",
10  "recharge_state_desc": "充值成功",
11  "recharge_amount": {
12      "amount": 10,
13      "currency": "CNY"
14  },
15  "online_bank_recharge_info": {
16      "bill_no": "162412031618542392059",
17      "bank_name": "工商银行",
18      "online_bank_type": "ONLINE_BANK_TYPE_CORPORATE",
19      "bank_card_tail": "9999",
20      "bank_account_name": "超级玛丽399"
21  },
22  "accept_time": "2024-12-03T15:06:00+08:00",
23  "success_time": "2024-12-03T15:10:21+08:00",
24  "close_time" : "2015-05-20T13:29:35+08:00",
25  "available_recharge_channels" : [
26    "ONLINE_BANK"
27  ]
28}

错误码

公共错误码

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

业务错误码

状态码	错误码	描述	解决方案
400	INVALID_REQUEST	充值单不存在	请检查业务充值单号
403	NO_AUTH	服务商未开通平台收付通	服务商开通微信支付平台收付通

文档是否有帮助

更多支持

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