余额提现状态查询

查询微信特约商户提现单的提现结果。

提示

需开通余额提现授权。
可查询90日内发起的提现单据，发起时间以微信支付提现单创建时间为准。
若查到提现单状态是'SUCCESS'，并不代表银行入账一定成功，部分情况下可能发生银行退票(银行预计在7个工作日内处理退票)。
若查询到提现单状态是'REFUND'，代表提现退票，此时应检查登记的账户信息是否有误，退票后资金会自动退回发起时的商户账户内。
若查询到提现单状态是'INIT'，请使用原单(所有请求参数保持不变)发起重试

请求接口

openapi/pay/fund/wxSpFundWithdrawQuery

公共参数

请求参数

参数	必填	类型	说明
sub_mchid	是	String(32)	特约商户号
withdraw_id	否	String(128)	微信支付提现单号，二选一
out_request_no	否	String(32)	商户提现单号，二选一

content请求实例

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

响应参数

名称	必填	类型	说明
sub_mchid	是	String(32)	特约商户号
status	是	String(16)	提现单状态 CREATE_SUCCESS：受理成功 SUCCESS：提现成功 FAIL：提现失败 REFUND：提现退票 CLOSE：关单 INIT：业务单已创建
withdraw_id	是	String(128)	微信支付提现单号，作为查询申请状态的唯一标识
out_request_no	是	String(32)	商户提现单号
amount	是	int	提现金额，单位：分
create_time	否	String(32)	发起提现时间，格式："yyyy-MM-dd HH:mm:ss"
update_time	否	String(32)	提现状态更新时间，格式："yyyy-MM-dd HH:mm:ss"
reason	否	String(255)	失败原因
remark	否	String(56)	提现备注
bank_memo	否	String(16)	银行附言
account_type	否	String(16)	账户类型
account_number	否	String(4)	入账银行账号后四位
account_bank	否	String(16)	入账银行
bank_name	否	String(128)	入账银行全称（含支行）

响应示例

{
  "sub_mchid": "1900000109",
  "status": "CREATE_SUCCESS",
  "withdraw_id": "12321937198237912739132791732912793127931279317929791239112123",
  "out_request_no": "20210611222222222200000000012122",
  "amount": 1,
  "create_time": "2021-06-11 13:29:35",
  "update_time": "2021-06-11 13:29:35",
  "reason": "卡号错误",
  "remark": "交易提现",
  "bank_memo": "微信提现",
  "account_type": "BASIC",
  "account_number": "1178",
  "account_bank": "工商银行",
  "bank_name": "中国工商银行股份有限公司深圳软件园支行"
}

错误描述说明

公共返回码

错误描述	解决方案
特约商户未开启手动提现权限	情况1：特约商户号提现权限被冻结，无法发起提现
特约商户未开启手动提现权限	情况2：特约商户号提现权限已关闭，无法发起提现
特约商户未开启手动提现权限	情况3：请确认服务商商户号和特约商户号是否存在受理关系
参数错误	请使用正确的参数重新调用
特约商户号账户可用余额不足	特约商户号账户可用余额不足
无接口使用权限	请开通商户号相关权限
频率限制	请降低频率后重试
特约商户下行打款未成功	特约商户号结算银行卡信息有误，修改后重试
特约商户未绑卡	特约商户号没有绑定结算银行卡，绑定后重试

请求接口​

公共参数​

请求参数​

content请求实例​

响应参数​

响应示例​

错误描述说明​

请求接口

公共参数

请求参数

content请求实例

响应参数

响应示例

错误描述说明