二级商户账户余额提现API
电商平台通过余额提现API帮助二级商户发起账户余额提现申请, 完成账户余额提现。
注意
相同的“商户提现单号”+“二级商户商户号”可以提供 20 天内防重。接口说明
适用对象: 电商平台
请求 URL: https://api.mch.weixin.qq.com/v3/ecommerce/fund/withdraw
请求方式: POST
接口规则: https://wechatpay-api.gitbook.io/wechatpay-api-v3
path 指该参数需在请求 URL 传参query 指该参数需在请求 JSON 传参
请求参数
| 变量 | 类型 | 必填 | 参数名/描述/示例值 |
|---|---|---|---|
| sub_mchid | string(32) | 是 | query 二级商户号, 由微信支付生成并下发。 |
| 1900000109 | |||
| out_request_no | string(32) | 是 | query 商户提现单号 必须是字母数字 |
| 20190611222222222200000000012122 | |||
| amount | int(64) | 是 | query 提现金额(单位: 分） |
| 100 | |||
| remark | string(56) | 否 | query 备注 商户对提现单的备注 |
| 交易提现 | |||
| bank_memo | string(32) | 否 | query 银行附言 展示在收款银行系统中的附言, 数字、字母最长 32 个汉字(能否成功展示依赖银行系统支持）。 |
| 微信支付提现 |
请求示例
{
"sub_mchid": "2222222222",
"out_request_no": "20190611222222222200000000012122",
"amount": 1,
"remark": "交易提现",
"bank_memo": "xx 平台提现"
}
返回参数
| 变量 | 类型 | 必填 | 参数名/描述/示例值 |
|---|---|---|---|
| sub_mchid | string(32) | 是 | 二级商户号, 由微信支付生成并下发。 |
| 1900000109 | |||
| withdraw_id | string(128) | 是 | 微信支付提现单号 电商平台提交二级商户提现申请后, 由微信支付返回的申请单号, 作为查询申请状态的唯一标识。 |
| 12321937198237912739132791732912793127931279317929791239112123 | |||
| out_request_no | string(32) | 否 | 商户提现单号 |
| 20190611222222222200000000012122 |
返回示例
正常示例
{
"sub_mchid": "1900000109",
"withdraw_id": "12321937198237912739132791732912793127931279317929791239112123",
"out_request_no": "20190611222222222200000000012122"
}
错误码公共错误码
| 状态码 | 错误码 | 描述 | 解决方案 |
|---|---|---|---|
| 500 | SYSTEM_ERROR | 系统错误 | 系统异常, 请使用相同参数稍后重新调用 |
| 403 | REQUEST_BLOCKED | 二级商户未开启手动提现权限 | 二级商户号提现权限被冻结, 无法发起提现 |
| 400 | PARAM_ERROR | 参数错误 | 请使用正确的参数重新调用 |
| 400 | PARAM_ERROR | 参数错误 | 请使用正确的参数重新调用, 电商平台提交相同商户单号的请求但参数和历史提交的参数不一致 |
| 404 | ORDER_NOT_EXISTS | 提现单号不存在 | 请检查订单号是否正确 |
| 403 | NOT_ENOUGH | 二级商户号账户可用余额不足 | 二级商户号账户可用余额不足 |
| 403 | NO_AUTH | 无接口使用权限 | 请开通商户号相关权限 |
| 400 | INVALID_REQUEST | 二级商户未开启手动提现权限 | 请确认电商平台商户号和二级商户商户号是否存在受理关系 |
| 429 | FREQUENCY_LIMITED | 频率限制 | 请降低频率后重试 |
| 403 | CONTRACT_NOT_CONFIRM | 二级商户未开启手动提现权限 | 二级商户号提现权限已关闭, 无法发起提现 |
| 403 | ACCOUNT_NOT_VERIFIED | 二级商户下行打款未成功 | 二级商户号结算银行卡信息有误, 修改后重试 |
| 403 | ACCOUNT_ERROR | 二级商户未绑卡 | 二级商户号没有绑定结算银行卡, 绑定后重试 |
Feedback
Was this page helpful?
很高兴听到！ 请告诉我们，我们如何才能改善.
很遗憾听到这个消息。 请告诉我们，我们如何才能改善.
最后修改 April 12, 2020: 整理文档 (f36b91e)