最新更新时间：2022.12.01 版本说明
针对被微信支付平台不收不付管控的电商子商户，如子商户账户内还有可用余额，且无法解脱（例如.营业执照注销吊销），则服务商可为子商户申请走注销提现的流程，将可用余额进行提现操作。在商户号注销后，电商平台可发起提现申请, 审批通过后, 将会按照指定的收款方式返回给商户。
• 商户上送敏感信息时使用微信支付平台公钥加密，证书序列号包含在请求HTTP头部的Wechatpay-Serial，详见接口规则
• 当返回错误码为“SYSTEMERROR”时，请不要更换商户提现申请单号，一定要使用原商户提现申请单号重试，否则可能造成重复支付等资金风险。
• 提交时遇到任何错误，请商户务必不要换单重试，请商户调用查询提现申请单状态接口确认提现申请单单据的状态, 再决定是否要换单重试, 避免重复提现。
• 请商户在自身的系统中合理设置付款频次并做好并发控制，防范错付风险。
• 因商户自身系统设置存在问题导致的资金损失，由商户自行承担。
适用对象：服务商
请求URL：https://api.mch.weixin.qq.com/v3/mch_operate/risk/withdrawl-apply
请求方式：POST
path 指该参数为路径参数
query 指该参数为URL参数
body 指该参数需在请求JSON传参
| 参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 二级商户号 | sub_mchid | string[1, 32] | 是 | body资金出款电商平台二级商户号。即电商平台二级商户号，由微信支付生成并下发。调用该提现接口前，会要求该二级商户号已注销 示例值：1900000109 |
| 二级商户号的出款子账户类型 | out_account_type | string | 是 | body根据实际的出款子账户选择 BASIC_ACCOUNT - 基本户，商户的基本户 OPERATE_ACCOUNT - 运营账户，商户的运营账户 示例值：BASIC_ACCOUNT |
| 提现金额 | amount | int | 是 | body单位：分，金额不能超过100万元 示例值：101 |
| 商户提现申请单号 | out_request_no | string[1, 32] | 是 | body商户提现申请单号，由商户自定义生成，必须是字母数字 示例值：2019061122222222122 |
| 收款对象类型 | payee_type | string | 是 | body根据实际的收款对象选择 CONTRIBUTION_MERCHANT：出资商户号收款，即已注销商户号资金提现给商户自己，收款账号类型对公银行卡账户 或 对私银行卡账户 SERVICE_PROVIDER_MERCHANT：电商平台收款，即已注销商户号资金提现给服务商，收款账号类型支持电商平台同名对公银行卡账户 OTHER_MERCHANT：其他商户号收款，即已注销商户号资金提现给其他商户，其他商户即除电商平台自身或出资商户号以外的商户, 收款账号类型视商户号主体类型，可支持对公或对私银行卡账户 INDIVIDUAL：个人收款，即已注销商户号资金提现给个人银行卡（例如给“达人、主播”），收款账号类型支持对私银行卡账户 示例值：OTHER_MERCHANT |
| 收款对象对应的商户号 | payee_mchid | string[1, 32] | 条件选填 | body当收款对象不为个人时必填。 payee_type为“SERVICE_PROVIDER_MERCHANT电商平台收款”，payee_mchid填写对应电商平台服务商商户号； payee_type为“CONTRIBUTION_MERCHANT出资商户号收款”，payee_mchid填写对应二级子商户号； payee_type为“OTHER_MERCHANT其他商户号收款”，payee_mchid填写对应其他第三方收款商户号； 示例值：1900000109 |
| + 收款账号信息 | payee_info | object | 是 | body实际的收款账号 |
| + 付款申请证明材料 | proof_media_list | object | 否 | body各类证明材料 |
| + 补充材料 | additional_materials | object | 否 | body1、不在上述证明材料中的其他需要服务商补充的，请填写通过[图片上传]接口预先上传图片生成好的MediaID |
| 备注 | remark | string[1, 1024] | 否 | body付款申请备注，方便服务商备注特殊情况。为了提高审核效率，可在此字段描述“原出资商户主体是否已注销”或其他情况 示例值：特殊理由 |
{
"additional_materials": {
"additional_media": [
"jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ"
]
},
"amount": 101,
"out_account_type": "BASIC_ACCOUNT",
"out_request_no": "2019061122222222122",
"payee_info": {
"account_type": "ACCOUNT_TYPE_CORPORATE",
"bank_account_info": {
"account_bank": "工商银行",
"account_name": "AOZdYGISxo4y44/UgZ69bdu9X+tfMUJ9dl+LetjM45/zMbrYu+wWZ8gn4CTdo+D/m9MrPg+V4sm73oxqdQu/hj7aWyDl4GQtPXVdaztB9jVbVZh3QFzV+BEmytMNQp9dt1uWJktlfdDdLR3AMWyMB377xd+m9bSr/ioDTzagEcGe+vLYiKrzcroQv3OR0p3ppFYoQ3IfYeU/04S4t9rNFL+kyblK2FCCqQ11NdbbHoCrJc7NV4oASq6ZFonjTtgjjgKsadIKHXtb3JZKGZjduGdtkRJJp0/0eow96uY1Pk7Rq79Jtt7+I8juwEc4P4TG5xzchG/5IL9DBd+Z0zZXkw==",
"account_number": "d+xT+MQCvrLHUVDWv/8MR/dB7TkXM2YYZlokmXzFsWs35NXUot7C0NcxIrUF5FnxqCJHkNgKtxa6RxEYyba1+VBRLnqKG2fSy/Y5qDN08Ej9zHCwJjq52Wg1VG8MRugli9YMI1fI83KGBxhuXyemgS/hqFKsfYGiOkJqjTUpgY5VqjtL2N4l4z11T0ECB/aSyVXUysOFGLVfSrUxMPZy6jWWYGvT1+4P633f+R+ki1gT4WF/2KxZOYmli385ZgVhcR30mr4/G3HBcxi13zp7FnEeOsLlvBmI1PHN4C7Rsu3WL8sPndjXTd75kPkyjqnoMRrEEaYQE8ZRGYoeorwC+w==",
"bank_branch_id": "402713354941"
},
"identity_info": {
"id_doc_type": "IDENTIFICATION_TYPE_IDCARD",
"identification_name": "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIEdkwzXRAI7FUhrfPK3SNjaBTEu9GmsugMIA9r3x887Q+ODuC8HH2nzAn7NGpE/e3yiHgWhk0ps5k5DP/2qIdGdONoDzZelrxCl/NWWNUyB93K9F+jC1JX2IMttdY+aQ6zBlw0xnOiNW6Hzy7UtC+xriudjD5APomty7/mYNxLMpRSvWKIjOv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==",
"identification_no": "AOZdYGISxo4y44/UgZ69bdu9X+tfMUJ9dl+LetjM45/zMbrYu+wWZ8gn4CTdo+D/m9MrPg+V4sm73oxqdQu/hj7aWyDl4GQtPXVdaztB9jVbVZh3QFzV+BEmytMNQp9dt1uWJktlfdDdLR3AMWyMB377xd+m9bSr/ioDTzagEcGe+vLYiKrzcroQv3OR0p3ppFYoQ3IfYeU/04S4t9rNFL+kyblK2FCCqQ11NdbbHoCrJc7NV4oASq6ZFonjTtgjjgKsadIKHXtb3JZKGZjduGdtkRJJp0/0eow96uY1Pk7Rq79Jtt7+I8juwEc4P4TG5xzchG/5IL9DBd+Z0zZXkw=="
}
},
"payee_mchid": "1900000109",
"payee_type": "OTHER_MCH",
"proof_media_list": {
"proof_payee_media": [
{
"proof_media": "jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ",
"proof_media_type": "WECHAT_PAY_WITHDRAWAL_APPLICATION_TYPE_1"
}
]
},
"remark": "特殊理由",
"sub_mchid": "1900000109"
}
| 参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 微信支付提现申请单号 | applyment_id | string[1, 32] | 否 | 电商平台提交二级商户可用余额提现申请后，由微信支付返回的申请单号，作为查询申请状态的唯一标识。 示例值：20220101332222 |
| 商户提现申请单号 | out_request_no | string[1, 32] | 否 | 商户预约提现单号，由商户自定义生成，需要全局唯一 示例值：1234567 |
{
"applyment_id": "20220101332222",
"out_request_no": "1234567"
}
| 状态码 | 错误码 | 描述 | 解决方案 |
|---|---|---|---|
| 403 | NO_AUTH | 商户暂无权限使用此功能 | 仅允许电商平台允许使用。 |
| 400 | PARAM_ERROR | 参数错误 | 请使用正确的参数重新调用 |
| 400 | RESOURCE_ALREADY_EXISTS | 重复提交, 商户的提现申请单号已经存在, 请调用查询状态接口检查 | 重复提交, 商户的提现申请单号已经存在, 请调用查询状态接口检查 |
| 400 | PARAM_ERROR | 参数错误 | 请使用正确的参数重新调用，电商平台提交相同单号的请求但参数和历史提交的参数不一致 |
| 403 | NOTENOUGH | 二级商户号账户可用余额不足 | 二级商户号账户可用余额不足 |
| 429 | FREQUENCY_LIMITED | 频率限制 | 请降低频率后重试 |