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.
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 |
|---|---|---|---|
| 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 | 999 999.99 | PLN, EUR, USD |
| Google Pay | 0.01 | 999 999.99 | PLN, EUR |
| Apple Pay | 0.01 | 999 999.99 | PLN, EUR |
| MB WAY | 0.01 EUR | 999 999.99 EUR | EUR |
| Bizum | 0.01 EUR | 999 999.99 EUR | EUR |
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.
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 błędem Limit exceeded - 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 |
| Ponawianie IPN | Do 10 prób (~17 godzin) |
Limity zwrotów
| Ograniczenie | Wartość |
|---|---|
| Maksymalny czas na zwrot | 180 dni od daty transakcji |
| Kwota zwrotu | Nie może przekroczyć kwoty transakcji |
| Zwroty częściowe | Suma zwrotów ≤ kwota pierwotna |
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