申请二级商户充值
更新时间:2024.10.22商户系统须通过调用此接口获取充值链接,随后发起充值流程
# 接口说明
支持商户:
【平台商户】
请求方式:
【POST】/v3/platsolution/ecommerce/recharges/apply
请求域名:
【主域名】
https://api.mch.weixin.qq.com
使用该域名将访问就近的接入点【备域名】
https://api2.mch.weixin.qq.com
使用该域名将访问异地的接入点 ,指引点击查看
# 请求参数
- Authorization 必填请参考 签名认证 生成认证信息
- Accept 必填请设置为
application/json
- Content-Type 必填请设置为
application/json
Header HTTP头参数
- sub_mchid 必填【二级商户号】 微信支付分配的商户号,出资商户号
- out_recharge_no 必填【商户充值单号】 商户系统内部的充值单号,只能由数字、大小写字母组成,在平台商户系统内部唯一
- recharge_scene 必填【充值场景】 仅支持电商平台充值保证金
可选取值:ECOMMERCE_DEPOSIT
: 二级商户充值保证金ECOMMERCE_BANK_TRANSFER
: 平台银行转账充值NORMAL_BANK_TRANSFER
: 普通商户银行转账充值
- account_type 必填【充值入账账户】 仅支持保证金账户
可选取值:DEPOSIT
: 保证金账户BASIC
: 基本账户OPERATION
: 运营账户FEES
: 手续费账户
- recharge_amount 必填【充值金额】 单位为分,仅支持CNY
- 属性
- notify_url 选填【商户回调地址】 异步接收充值结果的回调地址
Body 包体参数
请求示例
POST
# 应答参数
- recharge_id 必填【微信支付充值单号】 微信支付充值单号
- out_recharge_no 必填【商户充值单号】 商户系统内部的充值单号,只能由数字、大小写字母组成,在平台商户系统内部唯一
- recharge_url 必填【充值链接】 由链接进入充值页面
200OK
应答示例
200 OK
# 错误码
# 公共错误码
状态码 | 错误码 | 描述 | 解决方案 |
---|---|---|---|
400 | PARAM_ERROR | 参数错误 | 请根据错误提示正确传入参数 |
400 | INVALID_REQUEST | HTTP 请求不符合微信支付 APIv3 接口规则 | 请参阅 接口规则 |
401 | SIGN_ERROR | 验证不通过 | 请参阅 签名常见问题 |
500 | SYSTEM_ERROR | 系统异常,请稍后重试 | 请稍后重试 |
# 业务错误码
状态码 | 错误码 | 描述 | 解决方案 |
---|
文档是否有帮助