收款限額詳解:單筆、近 24 小時和近 30 天限額,以及 payment_limit_exceeded 是什麼意思
商戶收款限額如何運作:單筆、近 24 小時和近 30 天的滾動限額、哪些訂單會計入、payment_limit_exceeded 錯誤的含義,以及如何提高限額。
本文目錄
收款限額規定了一個商戶賬戶能收多少錢:每筆多少,以及一段時間內一共多少。支付服務商設置限額是為了控制風險,最常見於新商戶和個人商戶;當一筆訂單會超出某個限額時,請求會被拒絕,並返回類似 payment_limit_exceeded 的錯誤。了解你的限額是如何計算的,就能在買家看到錯誤之前,判斷一筆訂單能不能通過。
這篇文章説明 KukoPay 的收款限額如何運作:三種限額、為什麼採用滾動窗口而不是按天計算、哪些訂單會計入、payment_limit_exceeded 對你的代碼和買家意味着什麼,以及如何提高限額。
哪些商戶有收款限額?
- 個人商戶(沒有營業執照、以個人身份通過審核的商戶)總是有收款限額,初始為下文的默認值。限額可以提高,但不能取消,見 個人可以做跨境收款嗎。
- 企業和個體工商戶默認沒有收款限額;平台可能出於風控需要為其設置。
- 沙箱永遠不受限額約束,對所有商戶都是如此。
賬戶審核通過後,你可以在控制台的 費率與限額 頁面查看自己的限額,以及每個窗口已經佔用了多少。
三種限額
每個幣種都有三種限額,單位為該幣種的最小貨幣單位:
| 幣種 | 單筆上限 | 近 24 小時 | 近 30 天 |
|---|---|---|---|
| USD | $1,000 | $5,000 | $30,000 |
| HKD | HK$8,000 | HK$40,000 | HK$240,000 |
| CNY | ¥7,000 | ¥35,000 | ¥200,000 |
以上是個人商戶的默認值。一筆訂單必須同時滿足三個條件:不超過單筆上限,並且兩個窗口都還有剩餘額度。
為什麼用滾動窗口,而不是每日限額?
「近 24 小時」指的是這筆訂單之前的 24 小時,而不是從午夜開始算。滾動窗口沒有可以鑽空子的重置時刻,也不需要約定時區:23:59 和 00:01 的一波訂單計入的是同一個限額。近 30 天的窗口也是同樣的道理。
哪些訂單會計入限額?
窗口內創建的正式訂單,滿足以下條件之一就會計入:
- 已支付,包括之後退過款的;或者
- 待支付,且收銀台鏈接仍然有效。
已過期和已關閉的訂單不計入。有一個例外,避免被放棄的訪問把你堵住:還沒有人開始付款的待支付訂單,只在創建後的 15 分鐘內佔用額度。這對收款鏈接很重要,因為收款鏈接每次被訪問都會生成一筆訂單;一個被很多人打開卻沒人付款的鏈接,不會佔滿你當天的額度。
payment_limit_exceeded 是什麼意思?
它表示這筆訂單會超出你的某個限額。它會出現在這些地方:
- 創建訂單時:
POST /v1/orders返回400 payment_limit_exceeded,訂單不會被創建。 - 創建金額超過單筆上限的正式收款鏈接時:同樣返回這個錯誤,所以你永遠不會發布一個沒人能付款的鏈接。
- 收款鏈接被訪問、而這筆訂單會超限時:買家會看到商家暫時無法收款的提示。
- 在收銀台上:買家開始付款時會再核對一次限額。如果這期間額度已經被其他訂單用完,買家會看到商家暫時無法收取這筆款項的提示,不會產生任何扣款。
收銀台上的這第二次核對,才是真正守住資金的那一道關:相隔一秒創建的兩筆訂單,不可能同時擠進最後那一點剩餘額度。
在接入中如何處理 payment_limit_exceeded
- 按錯誤碼分支,而不是按文案,見 支付接口錯誤處理。
- 給買家一個有用的提示,而不是一段報錯:這筆訂單暫時無法下單,請嘗試較小的金額或稍後再試。
- 拆分大額訂單,如果你的產品允許,讓每一部分都在單筆上限以內。
- 不要循環重試。 限額不會在幾秒內改變,重試只會增加負擔。
- 留意控制台。 如果你經常接近某個窗口的上限,請在買家開始看到這個錯誤之前申請提高限額。
如何提高收款限額
在控制台聯繫平台,説明你的業務量即可。個人商戶的限額可以提高,但永遠不能完全取消;平台為其設置了限額的其他商戶,也可以用同樣的方式申請提高。個人商戶新增的幣種,會自動獲得該幣種的默認限額。
收款限額不是唯一的限制
還有兩種限制很容易和收款限額混淆:
- API 調用頻率限制限制的是每分鐘的請求數,而不是金額,返回的是
429,而不是400(見 API 調用頻率限制)。 - 買家銀行卡的限額由發卡行設置,在收銀台上表現為銀行卡被拒,比如
card_velocity_exceeded(見 銀行卡支付被拒怎麼辦)。
總結
- 收款限額按幣種限制單筆金額,以及近 24 小時和近 30 天滾動窗口內的總額;
- 個人商戶總是有限額(USD 默認為 $1,000 / $5,000 / $30,000);其他商戶只有在平台設置時才有;沙箱永遠沒有;
- 已支付和仍可支付的待支付訂單會計入;還沒有人開始付款的訂單只佔用 15 分鐘;
- 超出限額時,創建訂單返回
400 payment_limit_exceeded,收銀台在扣款前還會再核對一次; - 友好地處理這個錯誤,能拆分就拆分大額訂單,並在需要之前申請提高限額。
在沙箱裏把它跑通
註冊商戶後即可申請測試密鑰,不需要等待資質審核。