查询二级商户充值结果

更新时间：2024.12.20

提交充值申请后，可调用该接口查询充值状态。充值到账存在延迟：
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标准格式

应答示例

200 OK

1充值成功（扫码）：
2{
3  "sp_mchid": "1900001109",
4  "sub_mchid": "1900001121",
5  "recharge_id": "100000202405180012345678",
6  "out_recharge_no": "cz202407181234",
7  "recharge_channel": "QR_RECHARGE",
8  "account_type": "DEPOSIT",
9  "recharge_state": "SUCCESS",
10  "recharge_scene": "ECOMMERCE_DEPOSIT",
11  "recharge_state_desc": "充值成功",
12  "recharge_amount": {
13    "amount": 500000,
14    "currency": "CNY"
15  }, 
16  "qr_recharge_info":{
17    "employee_type": "STAFF",
18    "openid": "owYiu0WOJdGCYxoHrPabGhI39uT4"
19  },
20  "accept_time": "2015-05-19T13:29:35+08:00",
21  "success_time": "2015-05-20T14:29:35+08:00",
22  "close_time" : "2015-05-20T13:29:35+08:00"
23}
24
25充值成功（银行转账）：
26{
27  "sp_mchid": "1900001109",
28  "sub_mchid": "1900001121",
29  "recharge_id": "100000202405180012345678",
30  "out_recharge_no": "cz202407181234",
31  "recharge_channel": "BANK_TRANSFER",
32  "account_type": "DEPOSIT",
33  "recharge_state": "SUCCESS",
34  "recharge_scene": "ECOMMERCE_DEPOSIT",
35  "recharge_state_desc": "充值成功",
36  "recharge_amount": {
37      "amount": 500000,
38      "currency": "CNY"
39  },
40  "bank_transfer_info": {
41      "bill_no": "111111",
42      "memo": "转账充值附言",
43      "bank_name": "中国银行",
44      "bank_card_tail": "0722",
45      "bank_account_name" : "某某某有限公司"
46  },
47  "accept_time": "2015-05-19T13:29:35+08:00",
48  "success_time": "2015-05-20T14:29:35+08:00",
49  "close_time" : "2015-05-20T13:29:35+08:00"
50}
51
52充值成功（网银）：
53{
54  "sp_mchid": "2480304861",
55  "sub_mchid": "2600021157",
56  "recharge_id": "100000202405180012345678",
57  "out_recharge_no": "cz202407181234",
58  "recharge_channel": "ONLINE_BANK",
59  "account_type": "DEPOSIT",
60  "recharge_state": "SUCCESS",
61  "recharge_scene": "ECOMMERCE_DEPOSIT",
62  "recharge_state_desc": "充值成功",
63  "recharge_amount": {
64      "amount": 10,
65      "currency": "CNY"
66  },
67  "online_bank_recharge_info": {
68      "bill_no": "162412031618542392059",
69      "bank_name": "工商银行",
70      "online_bank_type": "ONLINE_BANK_TYPE_CORPORATE",
71      "bank_card_tail": "9999",
72      "bank_account_name": "超级玛丽399"
73  },
74  "accept_time": "2024-12-03T15:06:00+08:00",
75  "success_time": "2024-12-03T15:10:21+08:00",
76  "close_time" : "2015-05-20T13:29:35+08:00"
77}

错误码

公共错误码

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

业务错误码

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

文档是否有帮助

更多支持

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