关闭二级商户充值
更新时间:2024.12.10以下情况可调用关单接口:1、商家操作超出规定时间限制,为防止重复处理。2、系统主动终止服务不再接受新的请求
接口说明
支持商户:【平台商户】
请求方式:【POST】/v3/platsolution/ecommerce/recharges/out-recharge-no/{out_recharge_no}/close
请求域名:【主域名】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)
【二级商户号】 二级商户号
请求示例
POST
应答参数
200 OK
sp_mchid 必填 string(32)
【平台商户号】 微信支付分配的商户号
sub_mchid 必填 string(32)
【二级商户号】 微信支付分配的商户号,充值商户号
recharge_id 必填 string(27)
【微信支付充值单号】 微信支付充值单号
out_recharge_no 必填 string(64)
【商户充值单号】 商户系统内部的充值单号,只能由数字、大小写字母组成,在平台商户系统内部唯一
account_type 必填 string
【充值入账账户】 仅支持保证金账户
可选取值
DEPOSIT
: 保证金账户
recharge_state 必填 string
【充值状态】 充值状态
可选取值
CLOSED
: 已关闭
recharge_scene 必填 string
【充值场景】 仅支持二级商户充值保证金
可选取值
ECOMMERCE_DEPOSIT
: 二级商户充值保证金
recharge_state_desc 选填 string(64)
【充值状态描述】 展示关闭充值的原因,如“平台商户主动关闭充值单”、“超过时间限制,系统自动关闭充值单”等
recharge_amount 必填 object
【充值金额】 单位为分,仅支持CNY。单笔限额规则:1、银行转账最多8亿元 2、扫码充值5万元
属性 | |
accept_time 必填 string(32)
【受理充值时间】 微信支付成功受理充值时间,不代表充值已经完成,使用rfc3339标准格式
close_time 必填 string(32)
【关闭充值时间】 当状态为“已关闭”时返回,使用rfc3339标准格式
应答示例
200 OK
错误码
公共错误码
状态码 | 错误码 | 描述 | 解决方案 |
---|---|---|---|
400 | PARAM_ERROR | 参数错误 | 请根据错误提示正确传入参数 |
400 | INVALID_REQUEST | HTTP 请求不符合微信支付 APIv3 接口规则 | 请参阅 接口规则 |
401 | SIGN_ERROR | 验证不通过 | 请参阅 签名常见问题 |
500 | SYSTEM_ERROR | 系统异常,请稍后重试 | 请稍后重试 |
业务错误码
状态码 | 错误码 | 描述 | 解决方案 |
---|---|---|---|
400 | INVALID_REQUEST | 商户已完成充值,无法关闭 | 请核实充值单状态 |
403 | NO_AUTH | 服务商未开通平台收付通 | 服务商开通微信支付平台收付通 |