二级商户预约提现

2024-05-10 18:43| 来源: 网络整理| 查看: 265

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

该预约提现申请提交后，系统将在次日发起提现，预计当日到账。具体到账时间以实际银行处理为准。

注意：

单笔预约提现最大发起金额不能超过8亿。相同的“商户预约提现单号”+“特约商户商户号”可以提供6天内防重。预约提现发起后，单据的实际状态以查询接口为准。若预约提现发起成功，预计会在下个工作日到账。当API返回错误码为SYSTEM_ERROR时，请务必不要换单重试，使用原单(所有请求参数保持不变)发起重试。返回参数可能会有新增，且顺序可能不完全遵循此文档规范，如果在解析回包的时候发生错误，请务必不要换单重试，可以联系客服或小助手确认提现情况。错误码可能会有新增，如果遇到返回新的错误码，请务必不要换单重试，可以联系客服或小助手确认提现情况。 # 接口说明支持商户：【电商平台】请求方式：【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 必填 integer 【提现金额】提现金额，单位：分，不能超过8亿元 remark 选填 string(56) 【提现备注】商户对预约提现单的备注 bank_memo 选填 string(32) 【银行附言】展示在收款银行系统中的附言，由数字、字母、汉字组成（能否成功展示依赖银行系统支持） account_type 选填 string 【出款账户类型】出款账户类型可选取值：BASIC: 基本户OPERATION: 运营账户FEES: 手续费账户

请求示例

POST # 应答参数 200OK sub_mchid 必填 string(32) 【二级商户号】电商平台二级商户号，由微信支付生成并下发 withdraw_id 必填 string(128) 【微信支付预约提现单号】提交预约提现申请后，由微信支付返回的申请单号，作为查询申请状态的唯一标识 out_request_no 必填 string(32) 【商户预约提现单号】商户预约提现单号，由商户自定义生成，必须是字母数字

应答示例

200 OK # 错误码 # 公共错误码状态码错误码描述解决方案 400 PARAM_ERROR 参数错误请根据错误提示正确传入参数 400 INVALID_REQUEST HTTP 请求不符合微信支付 APIv3 接口规则请参阅接口规则 401 SIGN_ERROR 验证不通过请参阅签名常见问题 500 SYSTEM_ERROR 系统异常，请稍后重试请稍后重试 # 业务错误码状态码错误码描述解决方案 400 INVALID_REQUEST 二级商户未开启预约提现权限请确认电商平台商户号和二级商户商户号是否存在受理关系 400 INVALID_REQUEST 商户账户类型不存在或未开通请确认二级商户账户类型有效 403 ACCOUNT_ERROR 二级商户未绑卡二级商户号没有绑定结算银行卡，绑定后重试 403 ACCOUNT_NOT_VERIFIED 二级商户下行打款未成功二级商户号结算银行卡信息有误，修改后重试 403 CONTRACT_NOT_CONFIRMED 二级商户未开启预约提现权限二级商户号预约提现权限已关闭，无法发起预约提现 403 NO_AUTH 无接口使用权限请开通商户号相关权限 403 NOT_ENOUGH 二级商户号账户可用余额不足二级商户号账户可用余额不足 403 REQUEST_BLOCKED 二级商户未开启预约提现权限二级商户号预约提现权限被冻结，无法发起预约提现 404 ORDER_NOT_EXIST 预约提现单号不存在请检查订单号是否正确 429 FREQUENCY_LIMITED 频率限制请降低频率后重试 500 SYSTEM_ERROR 系统错误系统异常，请使用相同参数稍后重新调用

【本文地址】

公司简介

联系我们