Limity i ograniczenia
Informacje o limitach API, limitach kwotowych per metoda płatności oraz ograniczeniach czasowych.
Rate limiting API
API dpay.pl stosuje ograniczenia liczby zapytań, aby zapewnić stabilność usługi:
- Domyślny limit: 120 zapytań na minutę. Limit liczony jest per serwis (Punkt Płatności) - na indywidualny wniosek może zostać podwyższony dla Twojego serwisu.
- Odpowiedzi zawierają nagłówki
X-RateLimit-Limit(obowiązujący limit) iX-RateLimit-Remaining(pozostała liczba zapytań w bieżącym oknie). - Po przekroczeniu limitu otrzymasz odpowiedź HTTP 429 z nagłówkami
Retry-After(liczba sekund do odblokowania) iX-RateLimit-Reset(znacznik czasu odblokowania).
W przypadku odpowiedzi 429 odczekaj czas wskazany w nagłówku Retry-After i ponów zapytanie. Zaimplementuj exponential backoff dla kolejnych prób.
Limity kwotowe
Standardowe metody płatności
| Metoda | Min. kwota | Max. kwota | Waluta rejestracji przez API |
|---|---|---|---|
| BLIK | 0.01 PLN | 999 999.99 PLN | PLN |
| Przelewy bankowe (PBL) | 0.01 PLN | 999 999.99 PLN | PLN |
| Karty płatnicze | 0.01 PLN | 999 999.99 PLN | PLN |
| Google Pay | 0.01 PLN | 999 999.99 PLN | PLN |
| Apple Pay | 0.01 PLN | 999 999.99 PLN | PLN |
MB WAY (transactionType: mb_way_direct) | 0.01 EUR | 999 999.99 EUR | EUR |
Bizum (transactionType: bizum_direct) | 0.01 EUR | 999 999.99 EUR | EUR |
| Banki czeskie (white-label) | 0.01 CZK | 999 999.99 CZK | CZK |
| Banki słowackie (white-label) | 0.01 EUR | 999 999.99 EUR | EUR |
Przy rejestracji transakcji przez API obowiązuje PLN dla większości metod; EUR
stosuje się dla MB WAY (transactionType: mb_way_direct), Bizum i banków słowackich,
a CZK dla banków czeskich. PLN dla MB WAY jest zabronione. Podanie innej kombinacji
zakończy się błędem rejestracji.
Niezależnie od tego serwis (Punkt Płatności) może mieć skonfigurowane waluty spośród:
PLN, EUR, CZK, USD, RON - currency_code musi należeć do walut serwisu.
Faktyczne limity transakcji mogą być niższe i zależą od konfiguracji Twojego konta w panelu dpay.pl. Skontaktuj się z obsługą, aby ustalić limity dopasowane do Twojego biznesu.
Płatności odroczone (BNPL)
Metody odroczone mają sztywne progi kwotowe narzucone przez dostawców. Bramka pokazuje daną metodę tylko wtedy, gdy kwota transakcji mieści się w przedziale i metoda jest włączona w konfiguracji serwisu. Poza przedziałem kafelek metody w ogóle nie pojawia się na liście - nie jest to błąd.
| Metoda | Wariant | Min. kwota | Max. kwota | Waluta |
|---|---|---|---|---|
| BLIK Płacę Później | 30 dni | 30.00 PLN | 2 000.00 PLN | PLN |
| Twisto | 30 dni | 0.01 PLN | 2 000.00 PLN | PLN |
| Twisto | 3 raty (3x) | 150.00 PLN | 4 000.00 PLN | PLN |
| PayPo | 30 dni | bez limitu kwotowego | bez limitu kwotowego | PLN |
Dodatkowe warunki wyświetlenia:
- BLIK Płacę Później wymaga aktywnego klasycznego BLIK w serwisie (ten sam identyfikator merchanta BLIK) i waluty PLN. Jeśli w panelu przełącznik BLIK BNPL jest włączony, a metoda nie wyświetla się na bramce, w pierwszej kolejności sprawdź kwotę transakcji.
- Twisto wyświetla tylko te warianty, które mieszczą się w przedziale. Dla kwoty poniżej 150 PLN dostępny będzie wyłącznie wariant 30 dni, o ile jest włączony.
- PayPo wymaga przekazania przy rejestracji transakcji adresu rozliczeniowego (
billing_address), adresu dostawy (shipping_address) oraz listy produktów (products), w której każda pozycja ma wypełnione polaid,name,priceidescription. Bez tych danych PayPo nie pojawi się na bramce. - Parametr
nobanks: 1przy rejestracji transakcji wyłącza również wszystkie metody odroczone.
Direct Carrier Billing (DCB)
DCB ma specyficzne limity wynikające z regulacji operatorów komórkowych:
| Operator | Limit dzienny | Limit miesięczny |
|---|---|---|
| Różni operatorzy | Zależny od operatora | Zależny od operatora |
Limity DCB są ustalane przez operatorów komórkowych i mogą różnić się w zależności od:
- Typu konta klienta (pre-paid vs post-paid)
- Historii transakcji klienta
- Polityki danego operatora
Przekroczenie limitu skutkuje odrzuceniem płatności przez operatora - zaproponuj klientowi alternatywną metodę płatności.
SMS Premium
Limity SMS Premium zależą od numeru premium i konfiguracji w panelu dpay.pl.
Ograniczenia czasowe
| Element | Czas ważności |
|---|---|
| Kod BLIK | ~2 minuty od wygenerowania |
| Sesja płatności (bramka) | Do 15 minut |
| Kod SMS Premium | Jednorazowy, bez limitu czasowego |
| Możliwość zwrotu | 180 dni od daty transakcji (BLIK: 13 miesięcy; przelewy PBL: bez limitu) |
| Ponawianie IPN | Do 10 prób (~17 godzin) |
Limity zwrotów
| Ograniczenie | Wartość |
|---|---|
| Maksymalny czas na zwrot | 180 dni od daty transakcji dla kart, MB WAY, PayPo i Twisto; 13 miesięcy dla BLIK; przelewy PBL bez limitu czasowego |
| Kwota zwrotu | Nie może przekroczyć kwoty transakcji |
| Zwroty częściowe | Suma zwrotów ≤ kwota pierwotna |
| Liczba zwrotów | PayPo i Twisto: tylko jeden zwrot (pełny albo częściowy); pozostałe metody: wiele zwrotów częściowych |
Szczegóły dotyczące zwrotów znajdziesz w sekcji Zwroty.
Rekomendacje
- Implementuj retry z backoff - nie wysyłaj zapytań w pętli bez opóźnień
- Cache'uj dane - unikaj wielokrotnego odpytywania API o te same informacje
- Monitoruj odpowiedzi 429 - jeśli regularnie je otrzymujesz, zoptymalizuj częstotliwość zapytań
- Informuj klientów o limitach DCB - wyświetlaj komunikat o przekroczeniu limitu i zaproponuj alternatywną metodę płatności