Przelewy24 to jeden z najpopularniejszych operatorów płatności w Polsce, oferujący szybkie przelewy bankowe, BLIK, karty i płatności odroczone w jednym miejscu. Integracja ShopGold z Przelewy24 musi działać niezawodnie – każda przerwa to utracone zamówienia. Konfigurujemy, naprawiamy i optymalizujemy tę integrację kompleksowo.
Moduł Przelewy24 w ShopGold komunikuje się z systemem operatora przez API REST. Proces płatności obejmuje: inicjalizację transakcji, przekierowanie klienta na stronę Przelewy24, realizację płatności i zwrotne powiadomienie (IPN) do sklepu o wyniku. Awaria na każdym z tych etapów wymaga innej interwencji.
Typowe błędy integracji Przelewy24
- Błąd autoryzacji – nieprawidłowy Merchant ID lub klucz CRC/API Key
- Brak powiadomienia IPN – zamówienie nie zmienia statusu po opłaceniu
- Błąd weryfikacji podpisu – ShopGold odrzuca powiadomienie od P24
- Przekroczenie limitu czasu transakcji – sesja wygasa przed powrotem klienta
- Błąd środowiska – moduł skonfigurowany na sandbox działa na produkcji lub odwrotnie
- Niezgodność kwoty – ShopGold i P24 różnią się o grosze przez zaokrąglenia
- Problemy z adresem URL powrotu po płatności
Konfiguracja integracji krok po kroku
Pełna konfiguracja integracji ShopGold z Przelewy24 obejmuje: rejestrację i weryfikację sklepu w panelu P24, pobranie Merchant ID i kluczy API (Klucz CRC oraz API Key), skonfigurowanie w panelu P24 adresu powiadomienia IPN (Adres do notyfikacji) i adresów URL powrotu, konfigurację modułu w panelu ShopGold z danymi uwierzytelniającymi, wybór środowiska (sandbox / produkcja), mapowanie statusów płatności na statusy zamówień oraz testowanie transakcji w środowisku testowym.
Diagnostyka problemów na żywo
W przypadku awarii na działającym sklepie analizujemy logi po stronie ShopGold i panel transakcji w systemie Przelewy24. Porównujemy ID transakcji, kwoty i statusy w obu systemach. Identyfikujemy transakcje osierocone (opłacone w P24, ale bez zmiany statusu w sklepie) i korygujemy je ręcznie, jednocześnie naprawiając mechanizm powiadomień.
