商户系统须通过调用此接口获取充值链接，随后发起充值流程

接口说明

支持商户：

【平台商户】

请求方式：

【POST】/v3/platsolution/ecommerce/recharges/apply

请求域名：

【主域名】

https://api.mch.weixin.qq.com

使用该域名将访问就近的接入点

【备域名】

https://api2.mch.weixin.qq.com

使用该域名将访问异地的接入点 ，指引点击查看

请求参数

Header HTTP头参数
Authorization 必填 string
请参考 签名认证 生成认证信息
Accept 必填 string
请设置为 application/json
Content-Type 必填 string
请设置为 application/json

Body 包体参数
sub_mchid 必填 string(32)
【二级商户号】 微信支付分配的商户号，出资商户号
out_recharge_no 必填 string(64)
【商户充值单号】 商户系统内部的充值单号，只能由数字、大小写字母组成，在平台商户系统内部唯一
recharge_scene 必填 string
【充值场景】 仅支持二级商户充值保证金
可选取值：

• ECOMMERCE_DEPOSIT: 二级商户充值保证金
• ECOMMERCE_BANK_TRANSFER: 平台商户银行转账充值
• NORMAL_BANK_TRANSFER: 普通商户银行转账充值
account_type 必填 string
【充值入账账户】 仅支持保证金账户
可选取值：

• DEPOSIT: 保证金账户
• BASIC: 基本账户
• OPERATION: 运营账户
• FEES: 手续费账户
recharge_amount 必填 object
【充值金额】 单位为分，仅支持CNY
• 属性
notify_url 选填 string(1024)
【商户回调地址】 异步接收充值结果的回调地址

请求示例

POST

应答参数

200OK
recharge_id 必填 string(27)
【微信支付充值单号】 微信支付充值单号
out_recharge_no 必填 string(64)
【商户充值单号】 商户系统内部的充值单号，只能由数字、大小写字母组成，在平台商户系统内部唯一
recharge_url 必填 string(2048)
【充值链接】 由链接进入充值页面

应答示例

200 OK

错误码

公共错误码

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

业务错误码

状态码	错误码	描述	解决方案
400	INVALID_REQUEST	入账账户不存在	二级子商户开通对应入账账户
400	INVALID_REQUEST	单笔充值金额超过上限	单笔充值金额小于等于2千万元
400	INVALID_REQUEST	该业务充值单号已存在	请核实业务充值单号是否重复
403	NO_AUTH	服务商未开通平台收付通	服务商开通微信支付平台收付通
403	NO_AUTH	平台充值权限被处罚，无法发起充值	服务商登录「合作伙伴平台-账户中心-违约记录」查看详情
403	NO_AUTH	商户号出入金权限被管控，请前往「微信支付商户平台-账户中心-违约记录」或「商家助手小程序-风险处理」查看详情	二级子商户前往「微信支付商户平台-账户中心-违约记录」或「商家助手小程序-风险处理」查看详情