申请二级商户充值

更新时间:2024.10.22

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

# 接口说明

支持商户:
【平台商户】
请求方式:
【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 系统异常,请稍后重试 请稍后重试

# 业务错误码

状态码 错误码 描述 解决方案
反馈
咨询
目录