Jak skonfigurować płatności w sklepie internetowym?
Konfiguracja płatności w sklepie internetowym polega na połączeniu panelu sklepu z kontem u operatora płatności. Najczęściej nie wymaga programowania – wystarczy konto biznesowe, dedykowana wtyczka lub dane do integracji przez API, a następnie test w trybie Sandbox.
Jak wygląda konfiguracja płatności?
Proces przebiega według czterech etapów. Najpierw zakładasz i aktywujesz konto u operatora, potem łączysz go ze sklepem, wpisujesz dane uwierzytelniające i sprawdzasz działanie transakcji.
| Etap | Działanie | Cel |
|---|---|---|
| Rejestracja | Założenie konta biznesowego u operatora płatności | Uzyskanie dostępu do usług i danych integracyjnych |
| Integracja | Instalacja wtyczki albo przygotowanie połączenia przez API | Połączenie sklepu z bramką płatniczą |
| Konfiguracja | Wprowadzenie identyfikatorów, kluczy i ustawień metod płatności | Autoryzacja komunikacji między systemami |
| Testy | Wykonanie transakcji w trybie Sandbox | Sprawdzenie przekierowań i statusów zamówień |
Jak skonfigurować płatności krok po kroku?
1. Wybierz operatora i załóż konto
Wybierz operatora płatności, którego obsługuje Twoja platforma e-commerce. Może to być między innymi Tpay, Przelewy24 lub PayU. Podczas rejestracji podajesz dane firmy, akceptujesz warunki współpracy i przechodzisz proces weryfikacji wymagany przez operatora.
Po aktywacji konta otrzymasz dostęp do panelu, w którym znajdziesz dane potrzebne do integracji. W zależności od operatora mogą one mieć różne nazwy.
2. Wybierz wtyczkę albo integrację przez API
Wtyczka jest gotowym rozszerzeniem dla konkretnej platformy. Instalujesz ją w panelu sklepu, aktywujesz i uzupełniasz formularz konfiguracyjny. To zwykle najprostsza droga, jeśli operator udostępnia rozwiązanie dla używanego systemu.
API pozwala połączyć sklep z operatorem bez gotowej wtyczki. Daje większą elastyczność, ale wymaga pracy programistycznej zgodnej z dokumentacją techniczną operatora. Przy problemach z połączeniem mimo poprawnych danych warto skorzystać z pomocy developera lub wsparcia operatora.
3. Wprowadź dane integracyjne
W ustawieniach płatności w sklepie odszukaj zainstalowaną bramkę i wpisz dane pobrane z panelu operatora. Przykładowe pola to:
- ID sprzedawcy – indywidualny identyfikator konta u operatora
- Klucz API – dane używane do autoryzacji komunikacji między sklepem a operatorem
- Kod CRC – dodatkowy kod bezpieczeństwa wymagany przez wybranych operatorów
- Adres IP – pole wymagane tylko w niektórych integracjach
Podane nazwy są przykładami. Jeden operator może używać określeń „Klucz A” i „Klucz B”, a inny nazwy „API Key”, „CRC” lub „kod bezpieczeństwa”. Korzystaj z wartości przypisanych do Twojego konta, nie z przykładowych danych z dokumentacji.
Ustaw także nazwę widoczną dla kupującego, opis metody oraz ewentualną prowizję doliczaną do zamówienia. Po zapisaniu konfiguracji włącz metodę płatności.
Na końcu przypisz płatność do konkretnych metod dostawy. Bez tego bramka może nie pojawić się w koszyku albo będzie niedostępna dla wybranego sposobu dostawy. Sprawdź również, czy aktywowane są te metody, które chcesz udostępnić, na przykład BLIK, szybki przelew lub płatność kartą.
Jak przetestować płatności przed uruchomieniem?
Tryb Sandbox jest środowiskiem testowym, w którym możesz zasymulować płatność bez obciążania prawdziwego konta. Przed przełączeniem sklepu na produkcję wykonaj kilka scenariuszy:
- Włącz tryb Sandbox w konfiguracji operatora i sklepu.
- Złóż testowe zamówienie z każdą udostępnioną metodą płatności.
- Sprawdź, czy przekierowanie do operatora i powrót do sklepu działają prawidłowo.
- Zweryfikuj, czy zamówienie otrzymuje właściwy status po płatności oraz po jej odrzuceniu.
- Sprawdź, czy klient widzi poprawne komunikaty i otrzymuje wiadomość z właściwą treścią.
Testy pozwalają wykryć błędne klucze, nieprawidłowe adresy powrotu, brak powiązania z dostawą oraz problemy z aktualizacją statusu zamówienia. Po zakończeniu testów wyłącz tryb Sandbox i wprowadź dane produkcyjne zgodnie z instrukcją operatora.
Lista kontrolna przed uruchomieniem płatności
Przed udostępnieniem płatności klientom sprawdź następujące elementy:
- konto u operatora zostało aktywowane i zaakceptowane do obsługi transakcji
- wtyczka lub integracja API korzysta z właściwych danych konta
- płatności zostały przypisane do odpowiednich metod dostawy
- przekierowania po udanej i nieudanej płatności działają poprawnie
- status zamówienia zmienia się zgodnie z wynikiem transakcji
- tryb Sandbox został wyłączony na środowisku produkcyjnym
- przetestowano zwrot płatności, jeśli operator i sklep obsługują tę funkcję
- regulamin sklepu opisuje dostępne metody płatności i zasady zwrotów
Po przejściu tej listy możesz uruchomić płatności dla klientów. Jeżeli bramka nadal nie pojawia się w koszyku, najpierw sprawdź jej aktywność, przypisanie do dostawy, tryb pracy oraz zgodność danych z panelem operatora.



