Jak podłączyć bramkę płatności do sklepu internetowego?
Podłączenie bramki płatności do sklepu obejmuje dwa etapy: weryfikację formalną działalności oraz konfigurację techniczną. Najczęściej problemy pojawiają się nie przy instalacji wtyczki, lecz podczas KYC, czyli sprawdzania sprzedawcy i sklepu przez operatora.
Jak wybrać operatora płatności?
Najpierw sprawdź, czy operator obsługuje platformę, na której działa sklep, na przykład WooCommerce, Shopify, PrestaShop lub Magento. Przy popularnych CMS-ach standardem jest wtyczka, natomiast własny sklep zwykle wymaga integracji przez API. Znaczenie mają też dostępne metody płatności, prowizje, czas aktywacji oraz formalności związane z zawarciem umowy.
| Typ operatora | Złożoność integracji | Formalności | Dla kogo |
|---|---|---|---|
| Operator z gotową wtyczką | Niska lub średnia | Rejestracja, weryfikacja i akceptacja regulaminu operatora | Sklepy na popularnych platformach |
| Operator z integracją API | Średnia lub wysoka | Umowa, KYC i konfiguracja danych technicznych | Własne sklepy i rozwiązania wymagające dopasowania |
| Operator bankowy | Zależna od platformy | Relacja z bankiem, wniosek i weryfikacja działalności | Firmy korzystające z usług bankowych operatora |
Nie zakładaj, że najniższa prowizja oznacza najkorzystniejsze rozwiązanie. Sprawdź, czy dany system obsługuje BLIK, szybkie przelewy, karty, portfele elektroniczne oraz płatności odroczone, jeśli są potrzebne w Twoim sklepie. Przykładowo, Przelewy24, Autopay, Millennium PAY, Paynow i PayPal różnią się zakresem metod, sposobem rejestracji i wymaganiami dotyczącymi konta.
Jak podłączyć bramkę płatności do sklepu krok po kroku?
Uniwersalny proces wygląda podobnie niezależnie od wybranego operatora. Konkretne nazwy pól i dokumentów mogą się różnić, dlatego przy konfiguracji korzystaj z aktualnej dokumentacji dostawcy.
- Przygotuj sklep do weryfikacji – opublikuj produkty lub usługi, ceny z walutą, zasady dostawy i płatności, dane sprzedawcy oraz kontakt. Sklep powinien mieć dostępny regulamin, politykę prywatności i informacje o zwrotach oraz reklamacjach. Operator musi móc wejść na stronę i sprawdzić, co sprzedajesz.
- Załóż konto u operatora – podczas rejestracji podaj prawdziwą domenę sklepu, dane działalności i rachunek, na który mają trafiać środki. W przypadku działalności nierejestrowanej sprawdź, czy operator dopuszcza taką formę sprzedaży i jakie dokumenty zastępują dane firmy.
- Przejdź weryfikację KYC – operator może poprosić o dokument tożsamości, dane beneficjentów rzeczywistych, potwierdzenie rachunku lub dodatkowe informacje o ofercie. Sama rejestracja konta nie oznacza jeszcze aktywacji płatności. W niektórych systemach wymagany jest także przelew weryfikacyjny. Jego warunki zależą od operatora, a dla działalności nierejestrowanej mogą być inne niż dla firmy.
- Zainstaluj wtyczkę albo skonfiguruj API – w WooCommerce, Shopify i podobnych systemach pobierz moduł wskazany przez operatora, zainstaluj go i otwórz ustawienia metod płatności. Przy integracji API przygotuj dane uwierzytelniające, takie jak identyfikator sprzedawcy, klucz API, klucz CRC, Client ID lub Secret Key. Kopiuj je bez dodatkowych spacji i nie przesyłaj osobom nieuprawnionym.
- Rozdziel środowisko Sandbox i Live – Sandbox służy do testów, a Live lub Production do przyjmowania rzeczywistych płatności. Klucze z jednego środowiska nie działają w drugim. Najpierw wykonaj konfigurację testową, a przed startem zamień dane na produkcyjne i sprawdź, czy wybrany jest właściwy tryb.
- Wykonaj testy i poproś o aktywację – złóż zamówienie testowe, sprawdź powrót klienta do sklepu, zmianę statusu zamówienia i powiadomienie o płatności. Niektórzy operatorzy aktywują konto dopiero po sprawdzeniu publicznej strony sklepu i potwierdzeniu, że wymagane dokumenty są widoczne.
Wtyczka upraszcza instalację, ale nie zwalnia z dokładnego sprawdzenia konfiguracji. Własna integracja przez API wymaga także poprawnej obsługi odpowiedzi operatora, statusów transakcji, zwrotów i powiadomień serwerowych. Jeżeli nie tworzysz własnego modułu, nie musisz programować bramki od zera – wystarczy poprawnie skonfigurowany, oficjalny dodatek.
Dlaczego płatności nie działają od razu?
Brak płatności po instalacji wtyczki zwykle wynika z formalności albo drobnego błędu w konfiguracji. Sprawdź w pierwszej kolejności:
- konto operatora nie przeszło jeszcze weryfikacji albo nie zostało aktywowane do obsługi rzeczywistych transakcji
- klucze API, identyfikator sklepu lub klucz CRC zostały przepisane z błędem albo zawierają spację na początku lub końcu
- wtyczka działa w trybie Sandbox, a sklep został ustawiony na Live, albo użyto kluczy z niewłaściwego środowiska
- operator nie może otworzyć sklepu, ponieważ domena jest zabezpieczona hasłem, strona nie jest dostępna lub nie opublikowano produktów
- brakuje regulaminu, polityki prywatności, danych sprzedawcy, zasad dostawy albo informacji o zwrotach i reklamacjach
Jeśli problem dotyczy wyłącznie kart, sprawdź, czy ta metoda została osobno aktywowana i czy operator nie wymaga dodatkowej umowy. Gdy sklep korzysta z ograniczonego dostępu, przekaż operatorowi dane potrzebne do przeprowadzenia weryfikacji.
Czy sklep jest gotowy na uruchomienie płatności?
Przed przełączeniem bramki na produkcję wykonaj krótką kontrolę:
- złóż testowe zamówienie i sprawdź poprawną zmianę jego statusu
- otwórz okno płatności na telefonie i sprawdź jego responsywność
- potwierdź, że regulamin, polityka prywatności i dane kontaktowe są widoczne bez logowania
- sprawdź, czy ceny, dostawa, waluta i dostępne metody płatności odpowiadają ofercie sklepu
- upewnij się, że w konfiguracji produkcyjnej znajdują się klucze Live, a nie dane Sandbox
Najbezpieczniej uruchomić sprzedaż dopiero po pozytywnym teście i potwierdzeniu aktywacji przez operatora. Dzięki temu oddzielisz problemy formalne od technicznych i szybciej ustalisz, co wymaga poprawy.
