Podłączenie WayForPay w Kiero Store
WayForPay to operator płatności dla Kiero Store. Połączenie konfiguruje się w administracji sklepu, w sekcji Płatności (/admin/payments). Store obsługuje żądania płatnicze i powiadomienia operatora; OMS otrzymuje potwierdzone zamówienia oraz wyniki operacji. Klucz sprzedawcy i dane kart nie są przesyłane do OMS.
Zanim zaczniesz
Potrzebujesz dostępu właściciela lub administratora Store oraz własnego konta sprzedawcy WayForPay. Ta integracja Store wymaga UAH; sprawdź ceny katalogu w tej walucie. Przy innej walucie sklepu połączenie jest niedostępne. Wybór waluty nie przelicza cen towarów ani nie aktywuje konta sprzedawcy.
Utwórz sklep w panelu WayForPay i spełnij wymagania aktywacji operatora. Aktualne wymagania dla konta znajdziesz w oficjalnej instrukcji aktywacji. Prowizje, warunki wypłat i limity konta są niezależne od ustawień Kiero.
Gdzie znaleźć Merchant Login i Merchant Secret Key
- Zaloguj się do panelu WayForPay.
- Otwórz Налаштування магазину → Ваш магазин → Реквізити мерчанта (Ustawienia sklepu → Twój sklep → Dane sprzedawcy).
- Skopiuj Merchant Login do pola Identyfikator sprzedawcy (Merchant Login) w Store.
- Skopiuj Merchant Secret Key do pola klucza tajnego. To nie jest hasło do panelu.
Zobacz oficjalną instrukcję danych sprzedawcy. Nie wysyłaj klucza pomocy technicznej i nie umieszczaj go na zrzutach ekranu, publicznych stronach ani w komentarzach zamówień OMS.
Podłącz konto i włącz płatności
- W sekcji Płatności Store otwórz Połączenie z WayForPay.
- Wprowadź identyfikator sprzedawcy (Merchant Login) i Merchant Secret Key, następnie wybierz Połącz.
- Poczekaj na automatyczne sprawdzenie. Przycisk Odśwież stan połączenia pobiera aktualny wynik; zapisane połączenie nie wymaga ponownego wpisania klucza.
- Gdy połączenie będzie gotowe, sprawdź wyświetlone konto. Potwierdź przyjmowanie rzeczywistych płatności przez to konto i wybierz Włącz przyjmowanie płatności.
- Sprawdź, czy strona pokazuje aktywne WayForPay. Wcześniej nie zakładaj, że sklep przyjmuje rzeczywiste płatności.
Kiero ustala domenę i techniczne parametry powiadomień. Kreator nie wymaga ręcznego ustawiania webhooka ani zakupu testowego. Zapisanie konta zastępczego nie przełącza od razu działających płatności; zmiana następuje po weryfikacji i Twoim potwierdzeniu.
Co oznacza status
| Status | Co zrobić |
|---|---|
| Sprawdzanie konta | Poczekaj i odśwież stan. |
| Niepoprawne dane | Sprawdź Merchant Login i Merchant Secret Key właściwego sklepu. |
| Brak dostępu do API | Skontaktuj się z WayForPay, podając wyświetlony kod; kod 1117 wymaga sprawdzenia uprawnień API. |
| Ograniczone konto | Sprawdź aktywację i limity w WayForPay; jeśli kod 1118 pozostaje, skontaktuj się z operatorem. |
| Oczekiwanie na weryfikację usługi | Poczekaj na zakończenie weryfikacji technicznej Kiero; ponowne zapisanie klucza nie włącza płatności. |
| Połączenie gotowe | Sprawdź konto i potwierdź przyjmowanie płatności. |
| Aktywne | Połączenie jest włączone; transakcje nadal podlegają uprawnieniom i limitom operatora. |
Przy chwilowej niedostępności API odśwież stan później. Nie zastępuj wielokrotnie poprawnych danych, próbując usunąć chwilowy błąd.
Zamówienia, historia i zwroty
Po potwierdzonej płatności zamówienie i wynik operacji trafiają do OMS. Sam powrót kupującego do sklepu nie potwierdza sukcesu: system musi otrzymać zweryfikowany wynik operatora. W sekcji Płatności Store dostępna jest historia WayForPay dla skonfigurowanego konta.
W zaimplementowanym procesie zwrot wymaga zatwierdzonej decyzji o zwrocie w OMS oraz potwierdzenia właściciela w Store. Niepewny wynik zwrotu trzeba wyjaśnić przed kolejną próbą; nie ponawiaj go bez sprawdzenia. Zobacz zwroty.
Stan weryfikacji na 19 października 2026: konfiguracja, aktywacja i zabezpieczenia zwrotów są sprawdzone w kodzie i testach lokalnych. Dokumentacja projektu nie potwierdza jeszcze rzeczywistych płatności i zwrotów u operatora. Zapisanie danych lub pozytywny test techniczny nie usuwa tego ograniczenia.
Bezpieczeństwo i pomoc
Klucz sprzedawcy wprowadzaj wyłącznie w formularzu połączenia. Jeśli został ujawniony, wymień go przez WayForPay i zaktualizuj połączenie Store. Pomocy technicznej podaj status, identyfikator sprzedawcy i kod błędu bez kluczy ani danych kart.
Zobacz też integracje i Kiero Store.