最新更新時間：2020.05.26 版本說明
商戶進(jìn)行委托代扣扣費前需要在可通知時間段內(nèi)調(diào)用「預(yù)扣費通知」的接口為用戶發(fā)送扣費提醒，并設(shè)定預(yù)計扣費金額，經(jīng)過扣費等待期后，在可扣費期內(nèi)可發(fā)起扣費，扣款金額不能高于預(yù)計扣費金額，扣費失敗可主動發(fā)起重試扣費（重試次數(shù)由其他規(guī)則限制），直到扣費成功，或者可扣費期結(jié)束。
一個扣費周期內(nèi)只能扣款成功一次，即無論可扣費期是否結(jié)束，只要周期內(nèi)扣款成功一次，該扣費周期則結(jié)束。
? 扣費等待期：商戶調(diào)用「預(yù)扣費通知」接口成功當(dāng)日及第二個自然日。
? 扣費持續(xù)天數(shù)：默認(rèn)為7天；在扣費等待期后，能夠進(jìn)行扣款的自然日天數(shù)；發(fā)完通知后，商家可在第3-9天發(fā)起扣款。
? 可扣費期：經(jīng)過扣費等待期后的N個自然日，N為扣費持續(xù)天數(shù)。
? 扣費周期：商戶調(diào)用「預(yù)扣費通知」接口成功后，到扣款成功或可扣費日期結(jié)束。
? 可通知時間段：為了不打擾用戶，商戶只能在北京時間每天 6:00～22:00調(diào)用「預(yù)扣費通知」
假如扣費持續(xù)天數(shù)為1，
通知下發(fā)當(dāng)天為“扣費等待期”，商戶不允許扣費；
第二天為“扣費等待期”，商戶不允許扣費；
第三天為“可扣費期”，在可扣費期內(nèi)可以發(fā)起扣費。
如：若需要在3號扣費，則需要在1號將通知下發(fā)給用戶，2號為用戶的扣費等待期，用戶可以選擇等待扣費或關(guān)閉扣費服務(wù)，3號商戶可正常發(fā)起扣費。
適用對象：服務(wù)商
請求URL： https://api.mch.weixin.qq.com/v3/partner-papay/contracts/{contract_id}/notify
請求方式： POST
數(shù)據(jù)格式： JSON
接口規(guī)則：https://wechatpay-api.gitbook.io/wechatpay-api-v3
接口請求方： 具有委托代扣扣費權(quán)限，且另行開通了預(yù)扣費通知權(quán)限的服務(wù)商商戶
path指該參數(shù)為路徑參數(shù)
query指該參數(shù)需在請求URL傳參
body指該參數(shù)需在請求JSON傳參
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 委托代扣協(xié)議id | contract_id | string[1,32] | 是 | path 簽約成功后，微信返回的委托代扣協(xié)議id。 示例值：123124412412423431 |
| 服務(wù)商商戶號 | sp_mchid | string[1,32] | 是 | body 填寫微信支付分配的服務(wù)商商戶號。 示例值：1230000109 |
| 服務(wù)商應(yīng)用ID | sp_appid | string[1,32] | 是 | body 服務(wù)商申請的公眾號或移動應(yīng)用appid。 示例值：wxd678efh567hg6787 |
| 子商戶號 | sub_mchid | string[1,32] | 是 | body 填寫微信支付分配的子商戶號。 示例值：12345512 |
| 子商戶應(yīng)用D | sub_appid | string[1,32] | 否 | body 子商戶的APPID。 示例值：wxd678efh567hg6787 |
| + 預(yù)計扣費金額信息 | estimated_amount | object | 是 | body 預(yù)計扣款的金額信息。 |
{
"sp_appid" : "wxd678efh567hg6787",
"sp_mchid" : "1230000109",
"estimated_amount" : {
"amount" : 1,
"currency" : "CNY"
},
"sub_mchid" : "12345512",
"sub_appid" : "wxd678efh567hg6787"
}
| 錯誤碼 | 描述 | 解決方案 |
|---|---|---|
| SYSTEMERROR | 接口返回錯誤 | 系統(tǒng)異常，請使用相同參數(shù)重新調(diào)用接口 |
| CONTRACT_NOT_EXIST | 簽約協(xié)議不存在 | 請檢查簽約協(xié)議號是否正確,是否已解約 |
| PARAM_ERROR | 參數(shù)錯誤 | 請根據(jù)接口返回的詳細(xì)信息檢查您的程序 |
| APPID_MCHID_NOT_MATCH | appid和mchid不匹配 | 請確認(rèn)appid和mchid是否匹配 |
| INVALID_REQUEST | 無效請求 | 請根據(jù)接口返回的詳細(xì)信息檢查您的程序 |
| RULELIMIT | 該請求存在風(fēng)險 | 請檢查當(dāng)前預(yù)計扣費金額，已扣款次數(shù)，確認(rèn)請求是否存在風(fēng)險。 |
| RESOURCE_ALREADY_EXISTS | 資源已經(jīng)存在 | 已經(jīng)成功發(fā)送通知，無需重復(fù)調(diào)用。 |