Integracje: najczęstsze problemy

Ta strona opisuje problemy z bramkami płatności, programami do faktur, Discordem i webhookami, które twórcy zgłaszają najczęściej. Przy każdym znajdziesz przyczynę i kroki, które go rozwiązują.

Przelewy24 odrzuca połączenie albo prosi o adres IP mojego sklepu

Przelewy24 pozwala ograniczyć klucz API do jednego adresu IP. Serwery Zanfii nie mają stałego adresu IP, więc tak ograniczony klucz jest odrzucany, a okno połączenia pokazuje „Przelewy24 odrzuciło dane logowania. Sprawdź ID Sprzedawcy, ID POS, Klucz API i Klucz CRC. …”. Nie ma jednego adresu, który można podać w Przelewy24.

1. Zaloguj się do panelu Przelewy24 (panel.przelewy24.pl) i otwórz Moje dane → Dane API i konfiguracja.
2. W polu „adres IP” przy kluczu API wpisz znak %, kliknij plus i zapisz. Znak procenta oznacza „dowolny adres”.
3. Wróć do Integracje → Płatności (/integrations/payments), kliknij Połącz na karcie Przelewy24, wypełnij ponownie ID Sprzedawcy (Merchant ID), Klucz API i Klucz CRC i kliknij Zapisz.

Jeśli komunikat się powtarza, skopiuj wszystkie wartości jeszcze raz: pola z identyfikatorami przyjmują tylko cyfry, a ID Punktu sprzedaży (POS ID) może zostać puste, gdy masz jeden sklep. Pełna instrukcja: Połącz Przelewy24.

Klarna, BLIK albo Przelewy24 są nieaktywne, chociaż Stripe jest połączony

Te trzy metody Stripe włącza osobno dla każdego konta. Zanfia tylko odczytuje ich stan, więc metody, której Stripe nie aktywował, nie da się włączyć w edytorze koszyka. Edytor pokazuje wtedy: „Nieaktywna na Twoim koncie Stripe - włącz ją w ustawieniach bramek płatności.”

1. Otwórz Integracje → Płatności (/integrations/payments) i kliknij Zarządzaj na karcie Stripe.
2. Sprawdź sekcję Statusy metod płatności. Zielona kropka oznacza aktywną metodę, czerwona nieaktywną, a po najechaniu na nią zobaczysz Nieaktywna, Oczekuje na aktywację albo Odrzucona.
3. Kliknij Zarządzaj metodami płatności w swoim panelu Stripe i dokończ aktywację po stronie Stripe. Stripe może poprosić o akceptację dodatkowych warunków, a aktywacja może przez pewien czas mieć stan Oczekuje na aktywację.
4. Otwórz ponownie edytor koszyka. Gdy kropka jest zielona, metodę można pokazać w koszyku.

O tym, czy Stripe udostępni daną metodę Twojemu kontu, decyduje Stripe. Które inne bramki obsługują BLIK, przelewy online albo raty, opisuje artykuł Metody płatności według bramki.

W koszyku nie widać kafelka rat z PayU albo Tpay

Raty bankowe to osobny kafelek, Raty, który PayU albo Tpay udostępnia obok zwykłego kafelka bramki. Pokazuje się tylko wtedy, gdy spełnione są wszystkie warunki:

1. Raty są dostępne na Twoim koncie PayU albo Tpay. Ustalasz to z bramką, nie w Zanfii.
2. Cena jest jednorazowa albo typu płatność cykliczna, w PLN, z włączoną bramką PayU albo Tpay.
3. Kwota mieści się w zakresie, który bramka podaje dla rat. Przy cenie poniżej albo powyżej tego zakresu kafelka nie ma.
4. Kafelek jest włączony w koszyku. W koszykach utworzonych przed wprowadzeniem rat pozostaje ukryty, dopóki w zakładce Formularz i UX, w sekcji Metody płatności, nie przeniesiesz pozycji Raty z grupy Ukryte na tym koszyku.

To coś innego niż typ ceny Raty przez Stripe, który dzieli cenę na automatyczne obciążenia karty i wymaga Stripe. Zobacz Metody płatności według bramki.

Faktury przestały się wystawiać, chociaż program do faktur jest połączony

Gdy każde nowe zamówienie pokazuje Błąd wystawienia w kolumnie Faktura w Transakcjach (/orders), a do każdego dostajesz e-mail „⚠️ Wystąpił błąd podczas wystawienia faktury [produkt]”, klucz API albo token zapisany w Zanfii nie jest już przyjmowany przez program do faktur. Dostawcy co jakiś czas unieważniają klucze albo kończy się ich ważność. Płatności i dostępy działają bez zmian, a karta dostawcy nadal ma znacznik Połączono, więc problem widać dopiero w zamówieniach.

1. Zaloguj się do swojego programu do faktur i wygeneruj nowy klucz API albo token. Gdzie każdy dostawca go udostępnia, opisuje artykuł Połącz program do fakturowania.
2. W Zanfii otwórz Integracje → Faktury (/integrations/invoices) i kliknij Zarządzaj na karcie dostawcy.
3. Kliknij ikonę ołówka przy koncie. Okno Edytuj informuje: „Ze względów bezpieczeństwa nie pokazujemy zapisanego sekretu. Wklej go ponownie, aby zaktualizować połączenie.” Wklej nowy klucz i kliknij Zapisz.
4. Zobaczysz komunikat „Edycja konta zakończyła się pomyślnie”. Jeśli dostawca odrzuci klucz, komunikat brzmi „Przesłany klucz API nie jest poprawny!”: skopiuj klucz jeszcze raz i sprawdź, czy należy do tego samego konta.
5. Wystaw faktury, które w międzyczasie się nie udały. Nie wystawiają się one ponownie same: w Transakcjach kliknij ikonę koła zębatego przy każdym zamówieniu i wybierz Edytuj i wystaw ponownie albo użyj Ponów w panelu na górze.

Edycja zachowuje to samo konto, więc pozostaje ono domyślne i wybrane w Twoich koszykach. Nie usuwaj konta, żeby połączyć je od nowa: usunięcie konta domyślnego zostawia koszyki bez konta, z którego mogą wystawiać faktury. Pojedyncze nieudane faktury mają inne przyczyny: Subskrypcje i faktury: najczęstsze problemy.

Mam dwie firmy na jednym koncie Fakturowni. Jak wybrać, która wystawia faktury?

Fakturownia wybiera sprzedawcę według działu. Połączenie w Zanfii ma na to osobne pole; gdy jest puste, sprzedawcę wybiera Fakturownia po swojej stronie.

1. Otwórz Integracje → Faktury (/integrations/invoices), kliknij Zarządzaj na karcie Fakturowni i kliknij ikonę ołówka przy koncie.
2. W polu Id oddziału wpisz liczbowe ID działu: „Liczbowe ID działu z Fakturowni (nie nazwa). Znajdziesz je w Fakturownia → Ustawienia → Dane firmy, edytując dział.”
3. Kliknij Zapisz.

Żeby wystawiać faktury z obu firm, kliknij Dodaj konto w tym samym oknie Zarządzaj i połącz Fakturownię drugi raz, z drugim ID działu i własną wartością w polu Nazwa konta. Potem jedno konto oznacz jako domyślne przyciskiem Ustaw jako domyślny system fakturowy, a drugie wybierz jako Konto fakturowania w sekcji Fakturowanie tych koszyków, które mają z niego korzystać.

Weryfikacja Discorda nie przechodzi przy łączeniu serwera

Ostatni krok okna połączenia sprawdza, czy bot Zanfia widzi serwer o podanym ID. Komunikat „Podany serwer id nie jest poprawnie zintegrowany z botem Zanfia” oznacza, że go nie widzi.

1. Sprawdź ID. W Discordzie włącz Tryb dewelopera (Ustawienia użytkownika → Zaawansowane), kliknij prawym przyciskiem ikonę serwera na lewym pasku, nie kanał, i wybierz „Kopiuj ID serwera”.
2. Sprawdź bota. Musi być dodany przyciskiem Dodaj bota z okna połączenia i widoczny na liście członków serwera.
3. Kliknij Zacznij od początku i przejdź trzy kroki jeszcze raz, z poprawionym ID.

Jeśli okno Zarządzaj pokaże później ostrzeżenie Rola naszego bota jest zbyt niska, otwórz ustawienia serwera w Discordzie, przesuń rolę bota ponad role, które ma nadawać, i użyj ikony odświeżania przy serwerze. Konfiguracja: Połącz Discord, Circle lub GitHub.

Kupujący zapłacił, ale nie trafił na mój serwer Discord

Samo połączenie serwera nikogo nie dodaje. Robi to automatyzacja z krokiem Akcja Discord i tylko dla klientów, którzy połączyli własne konto Discord.

1. Sprawdź automatyzację. W Automatyzacjach (/workflows) musi istnieć opublikowana automatyzacja z wyzwalaczem Nowy zakup dla tego produktu, zawierająca krok Akcja Discord.
2. Sprawdź, czy klient połączył Discorda. Po zakupie klient dostaje e-mail „🔗 Dodaj integrację z Discordem, aby otrzymać dostęp. [produkt]” i musi otworzyć link z tej wiadomości. Do tego czasu krok automatyzacji ma status Oczekuje na połączenie Discorda.
3. Wyślij link jeszcze raz. Otwórz klienta w Klienci (/customers) i przejdź do zakładki Profil. Wiersz Discord pokazuje stan, na przykład Nie połączono albo Link do połączenia wysłany - klient nie dokończył. Kliknij ikonę koła zębatego obok i użyj Wyślij ponownie zaproszenie, Wyślij e-mail.
4. Dodaj klienta ponownie po odrzuconej próbie. W tym samym oknie Discord użyj Dodaj ponownie na serwer Discord. Wynik pojawi się w zakładce Aktywność klienta.

Rola, która nie zostaje nadana, chociaż klient jest już na serwerze, zwykle oznacza, że rola bota jest niżej niż ta rola; zobacz poprzednie pytanie.

Które ID to priceId w webhooku i gdzie je znajdę?

data.priceId w wiadomości webhooka to ID ceny w Zanfii, tej z zakładki Ceny koszyka. Nie jest to ID obiektu ceny u operatora płatności.

1. Otwórz koszyk w Oferty → Koszyki (/checkouts) i przejdź do zakładki Ceny.
2. Otwórz menu z trzema kropkami przy cenie i wybierz Kopiuj ID ceny. Pojawi się potwierdzenie ID ceny skopiowane do schowka.
3. Porównaj tę wartość z data.priceId w swoim endpoincie.

To samo menu ma pozycję Kopiuj bezpośredni link, która kopiuje adres koszyka z wybraną tą ceną. Format wiadomości i listę zdarzeń opisuje artykuł Webhooki.

Jeśli Twojego problemu nie ma na tej liście, zobacz Pomoc i kontakt z zespołem Zanfii.