查询二级商户充值结果
更新时间:2024.12.25提交充值申请后,可调用该接口查询充值状态。充值到账存在延迟: 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
使用该域名将访问异地的接入点 ,指引点击查看
# 请求参数
- Authorization 必填请参考 签名认证 生成认证信息
- Accept 必填请设置为
application/json
Header HTTP头参数
- out_recharge_no 必填【商户充值单号】 商户系统内部的充值单号,只能由数字、大小写字母组成,在平台商户系统内部唯一
Path 路径参数
- sub_mchid 必填【二级商户号】 二级商户号
Query 查询参数
请求示例
GET
# 应答参数
- sp_mchid 必填【平台商户号】 微信支付分配的商户号
- sub_mchid 必填【二级商户号】 微信支付分配的商户号,充值商户号
- recharge_id 必填【微信支付充值单号】 微信支付充值单号
- out_recharge_no 必填【商户充值单号】 商户系统内部的充值单号,只能由数字、大小写字母组成,在平台商户系统内部唯一
- recharge_channel 选填【充值渠道】 仅在“充值成功”时返回,其它状态不返回
可选取值:BANK_TRANSFER
: 银行转账QR_RECHARGE
: 扫码充值ONLINE_BANK
: 网银充值
- account_type 必填【充值入账账户】 仅支持保证金账户
可选取值:DEPOSIT
: 保证金账户BASIC
: 基本账户OPERATION
: 运营账户FEES
: 手续费账户
- recharge_state 必填【充值状态】 充值状态
可选取值:SUCCESS
: 充值成功RECHARGING
: 充值中CLOSED
: 已关闭
- recharge_scene 必填【充值场景】 仅支持二级商户充值保证金
可选取值:ECOMMERCE_DEPOSIT
: 二级商户充值保证金ECOMMERCE_BANK_TRANSFER
: 平台商户银行转账充值NORMAL_BANK_TRANSFER
: 普通商户银行转账充值
- recharge_state_desc 选填【充值状态描述】 展示关闭充值的原因,如“平台商户主动关闭充值单”、“超过时间限制,系统自动关闭充值单”等
- recharge_amount 必填【充值金额】 单位为分,仅支持CNY。单笔限额规则:1、银行转账最多8亿元 2、扫码充值5万元
- 属性
- bank_transfer_info 选填【转账充值的付款信息】 包括付款账户、银行附言等内容
- 属性
- qr_recharge_info 选填【扫码充值的付款信息】 包括充值用户
OpenID
- 属性
- online_bank_recharge_info 选填【网银充值的付款信息】 包括付款账户、银行交易订单号等内容
- 属性
- accept_time 选填【受理充值时间】 微信支付成功受理充值时间,不代表充值已经完成,使用rfc3339标准格式
- success_time 选填【充值成功时间】 当状态为“充值成功”时返回,使用rfc3339标准格式
- close_time 选填【关闭充值时间】 当状态为“已关闭”时返回,使用rfc3339标准格式
200OK
应答示例
200 OK
# 错误码
# 公共错误码
状态码 | 错误码 | 描述 | 解决方案 |
---|---|---|---|
400 | PARAM_ERROR | 参数错误 | 请根据错误提示正确传入参数 |
400 | INVALID_REQUEST | HTTP 请求不符合微信支付 APIv3 接口规则 | 请参阅 接口规则 |
401 | SIGN_ERROR | 验证不通过 | 请参阅 签名常见问题 |
500 | SYSTEM_ERROR | 系统异常,请稍后重试 | 请稍后重试 |
# 业务错误码
状态码 | 错误码 | 描述 | 解决方案 |
---|---|---|---|
400 | INVALID_REQUEST | 充值单不存在 | 请检查业务充值单号 |
403 | NO_AUTH | 服务商未开通平台收付通 | 服务商开通微信支付平台收付通 |
文档是否有帮助