跳轉到主要內容

收款限額詳解:單筆、近 24 小時和近 30 天限額,以及 payment_limit_exceeded 是什麼意思

商戶收款限額如何運作:單筆、近 24 小時和近 30 天的滾動限額、哪些訂單會計入、payment_limit_exceeded 錯誤的含義,以及如何提高限額。

發佈於 約 4 分鐘閲讀

手繪插畫:三個分別標着單筆、24h、30d 的儀表盤,指針接近上限,旁邊是一張 400 payment_limit_exceeded 卡片,還有一個雙手抱臂的人
本文目錄
  1. 哪些商戶有收款限額?
  2. 三種限額
  3. 為什麼用滾動窗口,而不是每日限額?
  4. 哪些訂單會計入限額?
  5. payment_limit_exceeded 是什麼意思?
  6. 在接入中如何處理 payment_limit_exceeded
  7. 如何提高收款限額
  8. 收款限額不是唯一的限制
  9. 總結

收款限額規定了一個商戶賬戶能收多少錢:每筆多少,以及一段時間內一共多少。支付服務商設置限額是為了控制風險,最常見於新商戶和個人商戶;當一筆訂單會超出某個限額時,請求會被拒絕,並返回類似 payment_limit_exceeded 的錯誤。了解你的限額是如何計算的,就能在買家看到錯誤之前,判斷一筆訂單能不能通過。

這篇文章説明 KukoPay 的收款限額如何運作:三種限額、為什麼採用滾動窗口而不是按天計算、哪些訂單會計入、payment_limit_exceeded 對你的代碼和買家意味着什麼,以及如何提高限額。

哪些商戶有收款限額?

  • 個人商戶(沒有營業執照、以個人身份通過審核的商戶)總是有收款限額,初始為下文的默認值。限額可以提高,但不能取消,見 個人可以做跨境收款嗎。
  • 企業和個體工商戶默認沒有收款限額;平台可能出於風控需要為其設置。
  • 沙箱永遠不受限額約束,對所有商戶都是如此。

賬戶審核通過後,你可以在控制台的 費率與限額 頁面查看自己的限額,以及每個窗口已經佔用了多少。

三種限額

每個幣種都有三種限額,單位為該幣種的最小貨幣單位:

幣種單筆上限近 24 小時近 30 天
USD$1,000$5,000$30,000
HKDHK$8,000HK$40,000HK$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,收銀台在扣款前還會再核對一次;
  • 友好地處理這個錯誤,能拆分就拆分大額訂單,並在需要之前申請提高限額。

在沙箱裏把它跑通

註冊商戶後即可申請測試密鑰,不需要等待資質審核。