Ten artykuł oferuje uniwersalny, krok-po-kroku proces integracji z dowolnym wspieranym bankiem lub bramą płatniczą w Fynode. Dzięki tej integracji będziesz mógł automatycznie dopasowywać płatności do zamówień, uruchamiać workflow i zmniejszyć liczbę błędów dzięki powiadomieniom o transakcjach i importowi transakcji.
- Zdecyduj, czy chcesz podłączyć zwykłe konto bankowe (np. Tatra Banka, FIO, VÚB...) czy online bramę płatności (GoPay, Stripe, Mollie, Besteron…).
- Dla banków przygotuj dostęp do swojego bankowości internetowej i ustaw opcję wysyłania powiadomień e-mailem o otrzymanych płatnościach.
- Dla bram płatniczych przygotuj dane uwierzytelniające (klucz API, sekret, Client ID, Client Secret, CID, identyfikator sklepu, ewentualnie e-mail/powiadomienie o ruchu).
- Upewnij się, że masz aktywne konto i włączone usługi API/powiadomienia zgodnie z dokumentacją banku/bramy lub wymaganiami dostawcy.
- W Fynode przejdź do sekcji Banka.
- Wybierz swój bank z listy.
- Fynode wygeneruje unikalny adres e-mail powiadomień w formacie
bmail-{HASH}@fynode.com.
- Wklej ten e-mail do swojego bankowości internetowej jako powiadomienie o płatnościach/przychodach.
- Zapisz ustawienia w banku, wykonaj testową transakcję i sprawdź, czy Fynode otrzymało powiadomienie i prawidłowo dopasowało płatność do zamówienia.
- W Fynode przejdź do sekcji Banka.
- Kliknij logo wybranej bramy płatniczej (np. Stripe, GoPay, Besteron...).
- Wprowadź wymagane dane w zależności od typu bramy (Secret key, klucz API, Client ID, Client Secret, CID...).
- Zapisz ustawienia.
- System automatycznie przetestuje połączenie i aktywne połączenie; w przypadku nieprawidłowych danych wyświetli komunikat o błędzie.
- Określ pole dopasowujące (według czego płatność będzie przypisywana do zamówienia – numer zamówienia, variabilny symbol, faktura...).
- Po aktywacji banku/bramy ustaw reguły parowania:
- Priorytet: 1. variabilny symbol, 2. numer faktury, 3. numer zamówienia (zalecana kolejność)
- Określ, które pola mają być prioryzowane w zależności od tego, jak je Twoja banka lub brama wysyła w powiadomieniu lub webhooku
- Dla unikalnych scenariuszy (np. marketplace z wieloma sklepami) możliwe jest indywidualne parowanie dla każdego kanału.
- Po uruchomieniu/dokonaniu notyfikacji/bramy wykonaj testową płatność lub zwrot i obserwuj, czy w Fynode pojawi się płatność i zostanie poprawnie dopasowana do odpowiadającego zamówienia.
- Sprawdź, czy workflow (np. automatyczna faktury, zmiana statusu zamówienia, powiadomienie klienta) działa zgodnie z ustawieniami.
- Nie przychodzą powiadomienia z banku: Sprawdź, czy podałeś prawidłowy e-mail powiadomień w bankowości i czy bank obsługuje usługę.
- Płatność nie jest parowana: Sprawdź, który atrybut otrzymała płatność (VS, zamówienie, faktura) i dostosuj priorytet pól parujących.
- Nieprawidłowe/nieaktualne dane uwierzytelniające: Sprawdź w interfejsie bramy/banku, czy wpisujesz aktualny klucz/secret; w razie potrzeby wygeneruj nowy.
- Wiele kont bankowych/bram: Dla każdego konta użyj osobnego połączenia w Fynode.
- Wrażliwe dane ( klucze API, secret keys ) nigdy nie udostępiaj poza Fynode ani zaufanymi aplikacjami.
- Po zmianie lub usunięciu danych w interfejsie banki/bramy natychmiast zaktualizuj je w Fynode.
Uniwersalny poradnik umożliwia podłączenie niemal dowolnego banku lub bramy płatniczej w Fynode, połączenie przepływów finansowych z zamówieniami bez ręcznej pracy i stworzenie skutecznego workflow dla fakturowania, wysyłki i raportowania.