以下情况可调用关单接口：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

应答参数

200OK
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: 保证金账户
• BASIC: 基本账户
• OPERATION: 运营账户
• FEES: 手续费账户
recharge_state 必填 string
【充值状态】 充值状态
可选取值：

• SUCCESS: 充值成功
• RECHARGING: 充值中
• CLOSED: 已关闭
recharge_scene 必填 string
【充值场景】 仅支持二级商户充值保证金
可选取值：

• ECOMMERCE_DEPOSIT: 二级商户充值保证金
• ECOMMERCE_BANK_TRANSFER: 平台商户银行转账充值
• NORMAL_BANK_TRANSFER: 普通商户银行转账充值
recharge_state_desc 选填 string(64)
【充值状态描述】 展示关闭充值的原因，如“平台商户主动关闭充值单”、“超过时间限制，系统自动关闭充值单”等
recharge_amount 必填 object
【充值金额】 单位为分，仅支持CNY。单笔限额规则：1、银行转账最多8亿元 2、扫码充值5万元
• 属性
bank_transfer_info 选填 object
【转账充值的付款信息】 包括付款账户、银行附言等内容
• 属性
qr_recharge_info 选填 object
【扫码充值的付款信息】 包括充值用户OpenID
• 属性
online_bank_recharge_info 选填 object
【网银充值的付款信息】 包括付款账户、银行交易订单号等内容
• 属性
accept_time 选填 string(32)
【受理充值时间】 微信支付成功受理充值时间，不代表充值已经完成，使用rfc3339标准格式
success_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	服务商未开通平台收付通	服务商开通微信支付平台收付通