最新更新時間:2020.06.26 版本說明
商戶進行委托代扣扣費前需要在可通知時間段內(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天;在扣費等待期后,能夠進行扣款的自然日天數(shù);發(fā)完通知后,商家可在第3-9天發(fā)起扣款。
? 可扣費期:經(jīng)過扣費等待期后的N個自然日,N為扣費持續(xù)天數(shù)。
? 扣費周期:商戶調(diào)用「預(yù)扣費通知」接口成功后,到扣款成功或可扣費日期結(jié)束。
? 可通知時間段:為了不打擾用戶,商戶只能在北京時間每天 7:00~22:00調(diào)用「預(yù)扣費通知」
假如扣費持續(xù)天數(shù)為1, 通知下發(fā)當(dāng)天為“扣費等待期”,商戶不允許扣費;
第二天為“扣費等待期”,商戶不允許扣費;
第三天為“可扣費期”,在可扣費期內(nèi)可以發(fā)起扣費。
如:若需要在3號扣費,則需要在1號將通知下發(fā)給用戶,2號為用戶的扣費等待期,用戶可以選擇等待扣費或關(guān)閉扣費服務(wù),3號商戶可正常發(fā)起扣費。
適用對象:直連商戶
請求URL: https://api.mch.weixin.qq.com/v3/papay/contracts/{contract_id}/notify
請求方式: POST
數(shù)據(jù)格式: JSON
接口規(guī)則:https://wechatpay-api.gitbook.io/wechatpay-api-v3
接口請求方: 具有委托代扣扣費權(quán)限,且另行開通了預(yù)扣費通知權(quán)限的直連商戶
path指該參數(shù)為路徑參數(shù)
query指該參數(shù)需在請求URL傳參
body指該參數(shù)需在請求JSON傳參
參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
---|---|---|---|---|
委托代扣協(xié)議id | contract_id | string[1,32] | 是 | path 簽約成功后,微信返回的委托代扣協(xié)議id。 示例值:123124412412423431 |
直連商戶號 | mchid | string[1,32] | 是 | body 填寫微信支付分配的商戶號。 示例值:1230000109 |
應(yīng)用ID | appid | string[1,32] | 是 | body 直連商戶的APPID。 示例值:wxd678efh567hg6787 |
+ 預(yù)計扣費金額信息 | estimated_amount | object | 是 | body 預(yù)計扣款的金額信息。 |
{
"mchid" : "1230000109",
"appid" : "wxd678efh567hg6787",
"estimated_amount" : {
"amount" : 1,
"currency" : "CNY"
}
}
錯誤碼 | 描述 | 解決方案 |
---|---|---|
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)用。 |