关闭二级商户充值

更新时间: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

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/platsolution/ecommerce/recharges/out-recharge-no/cz2020042013/close?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)

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


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

1{
2  "sp_mchid": "2480304861",
3  "sub_mchid": "2600014354",
4  "recharge_id": "172464316226512401",
5  "out_recharge_no": "hayleetest0000019",
6  "account_type": "DEPOSIT",
7  "recharge_state": "CLOSED",
8  "recharge_scene": "ECOMMERCE_DEPOSIT",
9  "recharge_state_desc": "服务商主动关闭充值单",
10  "recharge_amount": {
11    "amount": 11,
12    "currency": "CNY"
13  },
14  "accept_time": "2024-08-26T11:32:42+08:00",
15  "close_time": "2024-08-26T11:42:01+08:00"
16}

 

错误码

公共错误码

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

请根据错误提示正确传入参数

400

INVALID_REQUEST

HTTP 请求不符合微信支付 APIv3 接口规则

请参阅 接口规则

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

业务错误码

状态码

错误码

描述

解决方案

400

INVALID_REQUEST

商户已完成充值,无法关闭

请核实充值单状态

403

NO_AUTH

服务商未开通平台收付通

服务商开通微信支付平台收付通

 

 

反馈
咨询
目录
置顶