商户进件
特约商户进件
基础支付
JSAPI支付
APP支付
H5支付
Native支付
小程序支付
合单支付
付款码支付
经营能力
支付即服务
点金计划
行业方案
电商收付通(商户进件)
电商收付通(普通支付)
电商收付通(合单支付)
电商收付通(分账)
电商收付通(补差)
电商收付通(退款)
电商收付通(余额查询)
电商收付通(商户提现)
电商收付通(下载账单)
智慧商圈
微信支付分停车服务
营销工具
代金券
商家券
委托营销
支付有礼
小程序发券插件
H5发券
图片上传(营销专用)
现金红包
资金应用
分账
连锁品牌分账
风险合规
商户开户意愿确认
消费者投诉2.0
其他能力
图片上传
视频上传

二级商户余额提现API

最新更新时间:2021.06.21 版本说明


电商平台通过余额提现API帮助二级商户发起账户余额提现申请,完成账户余额提现。

注意:

1. 单笔提现最大发起金额不能超过8亿

2. 相同的“商户提现单号”+“二级商户商户号”可以提供6天内防重。

3. 余额提现发起后,单据的实际状态以查询接口为准。

4. 若余额提现发起成功,预计会在下个工作日到账。

5. 当API返回错误码为SYSTEM_ERROR时,请务必不要换单重试,使用原单(所有请求参数保持不变)发起重试。

6. 返回参数可能会有新增,且顺序可能不完全遵循此文档规范,如果在解析回包的时候发生错误,请务必不要换单重试,可以联系客服或小助手确认提现情况。

7. 错误码可能会有新增,如果遇到返回新的错误码,请务必不要换单重试,可以联系客服或小助手确认提现情况。

接口说明

适用对象:电商平台

请求URL:https://api.mch.weixin.qq.com/v3/ecommerce/fund/withdraw

请求方式:POST


path 指该参数为路径参数

query 指该参数为URL参数

body 指该参数需在请求JSON传参


请求参数

参数名 变量 类型[长度限制] 必填 描述
二级商户号 sub_mchid string[1, 32] body电商平台二级商户号,由微信支付生成并下发。
示例值:1900000109
商户提现单号 out_request_no string[1, 32] body商户提现单号,由商户自定义生成,必须是字母数字。
示例值:20190611222222222200000000012122
提现金额 amount int body单位:分,金额不能超过8亿元
示例值:1
提现备注 remark string[1, 56] body商户对提现单的备注,商户自定义字段。
示例值:交易提现
银行附言 bank_memo string[1, 32] body展示在收款银行系统中的附言,数字、字母最长32个汉字(能否成功展示依赖银行系统支持)
示例值:微信支付提现
出款账户类型 account_type string[1,16] body枚举值:
BASIC:基本户
OPERATION:运营账户
FEES:手续费账户
示例值:BASIC

请求示例


{
  "sub_mchid": "1900000109",
  "out_request_no": "20190611222222222200000000012122",
  "amount": 1,
  "remark": "交易提现",
  "bank_memo": "微信支付提现",
   "account_type": "BASIC"
}

{
JAVA示例代码
}

返回参数

参数名 变量 类型[长度限制] 必填 描述
二级商户号 sub_mchid string[1, 32] 电商平台二级商户号,由微信支付生成并下发。
示例值:1900000109
微信支付提现单号 withdraw_id string[1, 128] 电商平台提交二级商户提现申请后,由微信支付返回的申请单号,作为查询申请状态的唯一标识。
示例值:12321937198237912739132791732912793127931279317929791239112123
商户提现单号 out_request_no string[1, 32] 商户提现单号,由商户自定义生成。
示例值:20190611222222222200000000012122

返回示例


{
  "sub_mchid": "1900000109",
  "withdraw_id": "12321937198237912739132791732912793127931279317929791239112123",
  "out_request_no": "20190611222222222200000000012122"
}
                    

http://2323weixin.qq.com
                    

错误码公共错误码

状态码 错误码 描述 解决方案
500 SYSTEM_ERROR 系统错误 系统异常,请使用相同参数稍后重新调用
403 REQUEST_BLOCKED 二级商户未开启手动提现权限 二级商户号提现权限被冻结,无法发起提现
400 PARAM_ERROR 参数错误 请使用正确的参数重新调用
400 PARAM_ERROR 参数错误 请使用正确的参数重新调用,电商平台提交相同商户单号的请求但参数和历史提交的参数不一致
404 ORDER_NOT_EXIST 提现单号不存在 请检查订单号是否正确
403 NOT_ENOUGH 二级商户号账户可用余额不足 二级商户号账户可用余额不足
403 NO_AUTH 无接口使用权限 请开通商户号相关权限
400 INVALID_REQUEST 二级商户未开启手动提现权限 请确认电商平台商户号和二级商户商户号是否存在受理关系
429 FREQUENCY_LIMITED 频率限制 请降低频率后重试
403 CONTRACT_NOT_CONFIRM 二级商户未开启手动提现权限 二级商户号提现权限已关闭,无法发起提现
403 ACCOUNT_NOT_VERIFIED 二级商户下行打款未成功 二级商户号结算银行卡信息有误,修改后重试
403 ACCOUNT_ERROR 二级商户未绑卡 二级商户号没有绑定结算银行卡,绑定后重试
400 INVALID_REQUEST 商户账户类型不存在或未开通 请确认二级商户账户类型有效


技术咨询

文档反馈