电商平台提现API

电商平台通过该接口可将其平台的收入进行提现

接口说明

适用对象: 电商平台
请求 URL: https://api.mch.weixin.qq.com/v3/merchant/fund/withdraw
请求方式: POST
接口规则: https://wechatpay-api.gitbook.io/wechatpay-api-v3

path 指该参数需在请求 URL 传参
query 指该参数需在请求 JSON 传参

变量	类型	必填	参数名/描述/示例值
out_request_no	string(32）	是	query `商户提现单号`, 由商户自定义生成。
			20190611222222222200000000012122
amount	int	是	query `提现金额`, 单位: 分(RMB）
			1
remark	string(255）	否	query `备注` 商户对提现单的备注。
			交易体现
bank_memo	string(32）	否	query `银行附言` 展示在收款银行系统中的附言, 由数字、字母、汉字组成(能否成功展示依赖银行系统支持）。
			xx 平台提现
account_type	string	是	query `账户类型` 枚举值: BASIC: 基本账户 OPERATION: 运营账户 FEES: 手续费账户
			BASIC

{
  "out_request_no": "20190611222222222200000000012122",
  "amount": 1,
  "remark": "交易提现",
  "bank_memo": "xx 平台提现",
  "account_type": "BASIC"
}

变量	类型	必填	参数名/描述/示例值
withdraw_id	string(128）	否	`微信支付提现单号` 微信支付系统生成的提现单号。
			12321937198237912739132791732912793127931279317929791239112123
out_request_no	string(32）	是	`商户提现单号`, 由商户自定义生成。
			20190611222222222200000000012122

正常示例

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

状态码	错误码	描述	解决方案
403	NO_AUTH	无接口权限	请确认是否已经开通相关权限
403	NOT_ENOUGH	商户号账户可用余额不足	请确认商户号账户可用余额是否充足
403	REQUEST_BLOCKED	商户号提现权限被冻结, 无法发起提现	商户号提现权限为被冻结状态, 无法发起提现
403	CONTRACT_NOT_CONFIRM	商户号提现权限已关闭, 无法发起提现	商户号提现权限已关闭, 无法发起提现
400	INVALID_REQUEST	当前请求已经超过有效期	当前请求已经超过有效期
403	ACCOUNT_ERROR	商户号没有绑定结算银行卡	请绑定后重试
403	ACCOUNT_NOT_VERIFIED	商户号结算银行卡信息有误	请修改后重试
400	PARAM_ERROR	参数错误	请使用正确的参数重新调用提交相同商户单号的请求但参数和历史提交的参数不一致

Was this page helpful?

最后修改 April 12, 2020: 整理文档 (f36b91e)