最新更新時(shí)間：2022.12.01 版本說明
針對(duì)被微信支付平臺(tái)不收不付管控的電商子商戶，如子商戶賬戶內(nèi)還有可用余額，且無法解脫（例如.營業(yè)執(zhí)照注銷吊銷），則服務(wù)商可為子商戶申請(qǐng)走注銷提現(xiàn)的流程，將可用余額進(jìn)行提現(xiàn)操作。在商戶號(hào)注銷后，電商平臺(tái)可發(fā)起提現(xiàn)申請(qǐng), 審批通過后, 將會(huì)按照指定的收款方式返回給商戶。
? 商戶上送敏感信息時(shí)使用微信支付平臺(tái)公鑰加密，證書序列號(hào)包含在請(qǐng)求HTTP頭部的Wechatpay-Serial，詳見接口規(guī)則
? 當(dāng)返回錯(cuò)誤碼為“SYSTEMERROR”時(shí)，請(qǐng)不要更換商戶提現(xiàn)申請(qǐng)單號(hào)，一定要使用原商戶提現(xiàn)申請(qǐng)單號(hào)重試，否則可能造成重復(fù)支付等資金風(fēng)險(xiǎn)。
? 提交時(shí)遇到任何錯(cuò)誤，請(qǐng)商戶務(wù)必不要換單重試，請(qǐng)商戶調(diào)用查詢提現(xiàn)申請(qǐng)單狀態(tài)接口確認(rèn)提現(xiàn)申請(qǐng)單單據(jù)的狀態(tài), 再?zèng)Q定是否要換單重試, 避免重復(fù)提現(xiàn)。
? 請(qǐng)商戶在自身的系統(tǒng)中合理設(shè)置付款頻次并做好并發(fā)控制，防范錯(cuò)付風(fēng)險(xiǎn)。
? 因商戶自身系統(tǒng)設(shè)置存在問題導(dǎo)致的資金損失，由商戶自行承擔(dān)。
適用對(duì)象：服務(wù)商
請(qǐng)求URL：https://api.mch.weixin.qq.com/v3/mch_operate/risk/withdrawl-apply
請(qǐng)求方式：POST
path 指該參數(shù)為路徑參數(shù)
query 指該參數(shù)為URL參數(shù)
body 指該參數(shù)需在請(qǐng)求JSON傳參
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 二級(jí)商戶號(hào) | sub_mchid | string[1, 32] | 是 | body資金出款電商平臺(tái)二級(jí)商戶號(hào)。即電商平臺(tái)二級(jí)商戶號(hào)，由微信支付生成并下發(fā)。調(diào)用該提現(xiàn)接口前，會(huì)要求該二級(jí)商戶號(hào)已注銷 示例值：1900000109 |
| 二級(jí)商戶號(hào)的出款子賬戶類型 | out_account_type | string | 是 | body根據(jù)實(shí)際的出款子賬戶選擇 BASIC_ACCOUNT - 基本戶，商戶的基本戶 OPERATE_ACCOUNT - 運(yùn)營賬戶，商戶的運(yùn)營賬戶 示例值：BASIC_ACCOUNT |
| 提現(xiàn)金額 | amount | int | 是 | body單位：分，金額不能超過100萬元 示例值：101 |
| 商戶提現(xiàn)申請(qǐng)單號(hào) | out_request_no | string[1, 32] | 是 | body商戶提現(xiàn)申請(qǐng)單號(hào)，由商戶自定義生成，必須是字母數(shù)字 示例值：2019061122222222122 |
| 收款對(duì)象類型 | payee_type | string | 是 | body根據(jù)實(shí)際的收款對(duì)象選擇 CONTRIBUTION_MERCHANT：出資商戶號(hào)收款，即已注銷商戶號(hào)資金提現(xiàn)給商戶自己，收款賬號(hào)類型對(duì)公銀行卡賬戶 或 對(duì)私銀行卡賬戶 SERVICE_PROVIDER_MERCHANT：電商平臺(tái)收款，即已注銷商戶號(hào)資金提現(xiàn)給服務(wù)商，收款賬號(hào)類型支持電商平臺(tái)同名對(duì)公銀行卡賬戶 OTHER_MERCHANT：其他商戶號(hào)收款，即已注銷商戶號(hào)資金提現(xiàn)給其他商戶，其他商戶即除電商平臺(tái)自身或出資商戶號(hào)以外的商戶, 收款賬號(hào)類型視商戶號(hào)主體類型，可支持對(duì)公或?qū)λ姐y行卡賬戶 INDIVIDUAL：個(gè)人收款，即已注銷商戶號(hào)資金提現(xiàn)給個(gè)人銀行卡（例如給“達(dá)人、主播”），收款賬號(hào)類型支持對(duì)私銀行卡賬戶 示例值：OTHER_MERCHANT |
| 收款對(duì)象對(duì)應(yīng)的商戶號(hào) | payee_mchid | string[1, 32] | 條件選填 | body當(dāng)收款對(duì)象不為個(gè)人時(shí)必填。 payee_type為“SERVICE_PROVIDER_MERCHANT電商平臺(tái)收款”，payee_mchid填寫對(duì)應(yīng)電商平臺(tái)服務(wù)商商戶號(hào)； payee_type為“CONTRIBUTION_MERCHANT出資商戶號(hào)收款”，payee_mchid填寫對(duì)應(yīng)二級(jí)子商戶號(hào)； payee_type為“OTHER_MERCHANT其他商戶號(hào)收款”，payee_mchid填寫對(duì)應(yīng)其他第三方收款商戶號(hào)； 示例值：1900000109 |
| + 收款賬號(hào)信息 | payee_info | object | 是 | body實(shí)際的收款賬號(hào) |
| + 付款申請(qǐng)證明材料 | proof_media_list | object | 否 | body各類證明材料 |
| + 補(bǔ)充材料 | additional_materials | object | 否 | body1、不在上述證明材料中的其他需要服務(wù)商補(bǔ)充的，請(qǐng)?zhí)顚懲ㄟ^[圖片上傳]接口預(yù)先上傳圖片生成好的MediaID |
| 備注 | remark | string[1, 1024] | 否 | body付款申請(qǐng)備注，方便服務(wù)商備注特殊情況。為了提高審核效率，可在此字段描述“原出資商戶主體是否已注銷”或其他情況 示例值：特殊理由 |
{
"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"
}
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 微信支付提現(xiàn)申請(qǐng)單號(hào) | applyment_id | string[1, 32] | 否 | 電商平臺(tái)提交二級(jí)商戶可用余額提現(xiàn)申請(qǐng)后，由微信支付返回的申請(qǐng)單號(hào)，作為查詢申請(qǐng)狀態(tài)的唯一標(biāo)識(shí)。 示例值：20220101332222 |
| 商戶提現(xiàn)申請(qǐng)單號(hào) | out_request_no | string[1, 32] | 否 | 商戶預(yù)約提現(xiàn)單號(hào)，由商戶自定義生成，需要全局唯一 示例值：1234567 |
{
"applyment_id": "20220101332222",
"out_request_no": "1234567"
}
| 狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 403 | NO_AUTH | 商戶暫無權(quán)限使用此功能 | 僅允許電商平臺(tái)允許使用。 |
| 400 | PARAM_ERROR | 參數(shù)錯(cuò)誤 | 請(qǐng)使用正確的參數(shù)重新調(diào)用 |
| 400 | RESOURCE_ALREADY_EXISTS | 重復(fù)提交, 商戶的提現(xiàn)申請(qǐng)單號(hào)已經(jīng)存在, 請(qǐng)調(diào)用查詢狀態(tài)接口檢查 | 重復(fù)提交, 商戶的提現(xiàn)申請(qǐng)單號(hào)已經(jīng)存在, 請(qǐng)調(diào)用查詢狀態(tài)接口檢查 |
| 400 | PARAM_ERROR | 參數(shù)錯(cuò)誤 | 請(qǐng)使用正確的參數(shù)重新調(diào)用，電商平臺(tái)提交相同單號(hào)的請(qǐng)求但參數(shù)和歷史提交的參數(shù)不一致 |
| 403 | NOTENOUGH | 二級(jí)商戶號(hào)賬戶可用余額不足 | 二級(jí)商戶號(hào)賬戶可用余額不足 |
| 429 | FREQUENCY_LIMITED ? ? | 頻率限制 | 請(qǐng)降低頻率后重試 |