特约商户余额提现

更新时间：2024.11.21

收付通平台通过预约提现API帮助二级商户发起账户预约提现申请，完成账户提现。

注意

单笔提现最大发起金额不能超过8亿
相同的“商户提现单号”+“特约商户号”可以提供6天内防重。
余额提现发起后，单据的实际状态以查询接口为准。
若余额提现发起成功，预计会在下个工作日到账。
当API返回错误码为SYSTEM_ERROR时，请务必不要换单重试，使用原单(所有请求参数保持不变)发起重试。
返回参数可能会有新增，且顺序可能不完全遵循此文档规范，如果在解析回包的时候发生错误，请务必不要换单重试，可以联系客服或小助手确认提现情况。
错误码可能会有新增，如果遇到返回新的错误码，请务必不要换单重试，可以联系客服或小助手确认提现情况。
接口限频：平台服务商 40次/秒。如需调整请联系微信支付客服或小助手。

接口说明

支持商户：【普通服务商】

请求方式：【POST】/v3/ecommerce/fund/withdraw

请求域名：【主域名】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_request_no 　必填 string(32)

【商户提现单号】商户提现单号，由商户自定义生成，必须是字母数字

amount 　必填 int

【提现金额】提现金额，单位：分，不能超过8亿元

remark 　选填 string(56)

【提现备注】商户对预约提现单的备注，商户自定义字段

bank_memo 　选填 string(32)

【银行附言】展示在收款银行系统中的附言，由数字、字母、汉字组成（能否成功展示依赖银行系统支持）

account_type 　选填 string

【出款账户类型】出款账户类型

可选取值

BASIC: 基本账户
FEES: 手续费账户
OPERATION: 运营账户

请求示例

POST

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/ecommerce/fund/withdraw \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Content-Type: application/json" \
6  -d '{
7    "sub_mchid" : "1900000109",
8    "out_request_no" : "20190611222222222200000000012122",
9    "amount" : 1,
10    "remark" : "交易提现",
11    "bank_memo" : "xx平台提现",
12    "account_type" : "BASIC"
13  }'
14

应答参数

200 OK

sub_mchid 　必填 string(32)

【特约商户号】服务商特约商户号，由微信支付生成并下发

withdraw_id 　必填 string(128)

【微信支付提现单号】服务商提交特约商户提现申请后，由微信支付返回的申请单号，作为查询申请状态的唯一标识。

out_request_no 　必填 string(32)

【商户预约提现单号】商户预约提现单号，由商户自定义生成，必须是字母数字

应答示例

200 OK

1{
2  "sub_mchid" : "1900000109",
3  "withdraw_id" : "12321937198237912739132791732912793127931279317929791239112123",
4  "out_request_no" : "20190611222222222200000000012122"
5}
6

错误码

公共错误码

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

业务错误码

错误码	描述	解决方案
403	REQUEST_BLOCKED	特约商户未开启手动提现权限
400	PARAM_ERROR	参数错误
404	ORDER_NOT_EXIST	提现单号不存在
403	NOT_ENOUGH	特约商户号账户可用余额不足
403	NO_AUTH	无接口使用权限
400	INVALID_REQUEST	特约商户未开启手动提现权限
429	FREQUENCY_LIMITED	频率限制
403	CONTRACT_NOT_CONFIRMED	特约商户未开启手动提现权限
403	ACCOUNT_NOT_VERIFIED	特约商户下行打款未成功
403	ACCOUNT_ERROR	特约商户未绑卡

文档是否有帮助

更多支持

开发文档(商户)开发文档(V2版)开发者社区微信开放平台微信公众平台腾讯客服