Najczęściej zadawane pytania

GriffNode to bramka płatności kryptowalutowych bez powiernictwa. Firmy przyjmują przez nią Bitcoin, Ethereum, Litecoin, Dogecoin, Dash i 11 tokenów ERC-20, w tym USDT i USDC, prosto na własny portfel.

Dostajesz wtyczkę WooCommerce, linki płatnicze, hostowaną stronę płatności, REST API i panel ze wszystkimi płatnościami.

GriffNode to legalne, niepowiernicze oprogramowanie do przyjmowania płatności kryptowalutowych. Możesz to sprawdzić samodzielnie: płatności trafiają prosto z portfela klienta do twojego, ponieważ przechowujemy wyłącznie klucz publiczny twojego portfela (xPub). xPub nie pozwala wydać środków, więc nie możemy ruszyć twoich pieniędzy, a po naszej stronie nie ma salda, które dałoby się zamrozić lub z którym można by uciec.

Pobieramy jedną stałą miesięczną subskrypcję, płatną z góry. Nigdy nie poprosimy cię o wysłanie krypto w celu „aktywacji”, „weryfikacji” czy „odblokowania” środków i nigdy nie pobieramy prowizji od twojej sprzedaży. Ktokolwiek prosi cię o wpłatę lub „opłatę za wypłatę”, używając naszej nazwy lub jakiejkolwiek innej, prowadzi oszustwo.

Żadnych schematów inwestycyjnych, nigdy. Nie oferujemy inwestycji, tradingu ani gwarantowanych zysków, a nikt z GriffNode nigdy nie napisze do ciebie znienacka o „okazjach”. GriffNode prowadzi założyciel z imienia i nazwiska, Emil Dąbrowski ([email protected]), a nasz kod jest publicznie dostępny na GitHubie. Mamy też stronę na Trustpilocie.

Obecnie obsługujemy:

• Bitcoin (BTC) - pierwotna kryptowaluta
• Litecoin (LTC) - szybkie i tanie transakcje
• Dash (DASH) - cyfrowa gotówka skupiona na prywatności
• Dogecoin (DOGE) - popularna moneta napędzana przez społeczność
• Ethereum (ETH) - platforma smart kontraktów
• Tokeny ERC-20 - USDT, USDC, EURC, DAI, WBTC, WETH, SHIB, PEPE, LINK, UNI oraz LEO, wypłacane na twój adres Ethereum

Kolejne kryptowaluty dodajemy w oparciu o zapotrzebowanie sprzedawców i stabilność sieci.

GriffNode wyróżniają cztery rzeczy:

• Płatności trafiają prosto na twój portfel. Nigdy nie przechowujemy twoich pieniędzy.
• Stała miesięczna cena. Bez procentu od kwoty płatności i bez opłaty GriffNode za transakcję.
• Start w kilka minut. Rejestrujesz się, podłączasz portfel i przyjmujesz pierwszą płatność.
• Także dla deweloperów. REST API, 8 otwartych SDK i webhooki od planu Business.

Potwierdzonej płatności na blockchainie nie da się cofnąć przez chargeback operatora kart. Zwroty i obsługę klienta nadal prowadzisz sam.

Nie! Oferujemy rozwiązania dla każdego poziomu zaawansowania:

• Bez kodowania: korzystaj z naszego panelu, aby generować linki płatności i faktury
• WooCommerce i WordPress: zainstaluj wtyczkę WooCommerce lub wtyczkę WordPress prosto z katalogu wtyczek WordPress.org
• Inne platformy, w tym Shopify: przekieruj klientów na hostowaną stronę płatności i potwierdzaj zamówienia webhookiem
• Deweloperzy: integruj się przez nasze REST API z SDK dla JavaScript, Python, PHP, Go, Ruby, Java, C# i Rust

GriffNode jest dostępne dla sprzedawców na całym świecie, z pewnymi wyjątkami. Obecnie nie możemy obsługiwać sprzedawców w:

• krajach objętych sankcjami międzynarodowymi (np. Korea Północna, Iran)
• regionach, w których kryptowaluty są wprost nielegalne

Zasady dotyczące sankcji opisujemy na naszej stronie zgodności.

Obsługujemy większość legalnych firm, w tym sklepy e-commerce, platformy SaaS, freelancerów, organizacje non-profit oraz usługodawców. Nie obsługujemy:

• nielegalnych towarów lub usług
• treści dla dorosłych ani hazardu (w większości jurysdykcji)
• niezarejestrowanych papierów wartościowych lub schematów inwestycyjnych
• prania pieniędzy lub finansowania terroryzmu

Pełne wytyczne dotyczące korzystania znajdziesz w naszym Regulaminie.

Nie obiecujemy procentu dostępności. Nasza strona statusu pokazuje bieżący stan usług, więc możesz to sprawdzić sam w każdej chwili.

Nasz panel jest w pełni responsywny i działa w przeglądarkach mobilnych. Obecnie nie mamy natywnych aplikacji na iOS/Android, ale nasz interfejs webowy zapewnia pełną funkcjonalność na urządzeniach mobilnych, w tym monitorowanie płatności, historię transakcji i ustawienia konta.

Tak. Starter jest darmowy: 30 transakcji miesięcznie, bez karty i bez opłaty za transakcję.

Symulowanego trybu testowego jeszcze nie ma. Testowe klucze API (sk_test_) istnieją, ale płatności nimi wykonane są prawdziwymi płatnościami w sieci, więc testuj małą kwotą. Zobacz przewodnik po trybie testowym.

Pisz na [email protected]. Zwykle odpowiadamy tego samego dnia, na każdym planie. Awarie płatności i API obsługujemy najpierw, na każdym planie. Wiadomości z planów Professional i Enterprise idą przed resztą kolejki, a Enterprise ma bezpośredni kontakt z założycielem.

Nasza Polityka prywatności opisuje, jakie dane przetwarzamy, po co, kto je otrzymuje i jak długo je przechowujemy. Nigdy nie sprzedajemy ani nie wynajmujemy danych osobowych.

Rozpoczęcie jest proste:

1. Wejdź na griffnode.com/signup
2. Podaj swój e-mail i utwórz bezpieczne hasło
3. Zweryfikuj swój adres e-mail
4. Uzupełnij profil i skonfiguruj portfel
5. Zacznij od razu przyjmować płatności!

Cały proces zajmuje mniej niż 5 minut.

Nie. 2FA jest opcjonalne i nigdy nie blokuje rejestracji ani konfiguracji, ale je polecamy. Gdy 2FA jest włączone, działania zmieniające to, dokąd trafiają pieniądze, na przykład zmiana portfela, wymagają świeżego kodu 2FA lub klucza dostępu (passkey).

Obsługujemy aplikacje uwierzytelniające (TOTP, na przykład Google Authenticator, Authy lub 1Password), kody odzyskiwania i klucze dostępu.

Nie przechowujemy ich! GriffNode domyślnie działa w trybie bezpośrednio do portfela:

• Podajesz adresy swoich portfeli kryptowalutowych (XPub)
• Płatności klientów trafiają bezpośrednio do twojego portfela
• Nigdy nie przechowujemy ani nie sprawujemy pieczy nad twoimi środkami
• Przez cały czas zachowujesz pełną kontrolę

Skorzystaj z linku „Nie pamiętasz hasła?” na stronie logowania. Otrzymasz bezpieczny link do resetowania na adres e-mail. Jeśli masz włączone 2FA, potrzebna będzie również aplikacja uwierzytelniająca lub kody zapasowe.

• Trzymaj klucz tajny (sk_live_) tylko na serwerze. Nigdy nie umieszczaj go w kodzie przeglądarki ani w repozytorium.
• W środowisku deweloperskim używaj klucza testowego (sk_test_), żeby klucz produkcyjny tam nie trafił.
• Zmieniaj klucze po zmianach w zespole albo gdy podejrzewasz wyciek.
• W planach Professional i Enterprise ogranicz klucze do adresów IP swoich serwerów.

Jeśli podejrzewasz nieautoryzowany dostęp:

1. Natychmiast zmień hasło
2. Unieważnij wszystkie klucze API i wygeneruj nowe
3. Sprawdź ostatnie transakcje pod kątem nieautoryzowanej aktywności
4. Włącz 2FA, jeśli nie jest jeszcze aktywne
5. Natychmiast skontaktuj się z [email protected]

Pomożemy zabezpieczyć twoje konto i zbadać wszelką podejrzaną aktywność.

Jeszcze nie w panelu. Napisz na [email protected] z obecnego adresu, a zmienimy go za ciebie.

W panelu wejdź w Bezpieczeństwo i wybierz Usuń konto. Upewnij się, że żadna płatność nie jest otwarta, i w razie potrzeby najpierw wyeksportuj historię transakcji. Usunięcie jest trwałe.

Faktury i dokumenty księgowe przechowujemy tak długo, jak wymaga prawo podatkowe. Wszystkie okresy przechowywania znajdziesz w Polityce prywatności.

Tak, w planach Professional i Enterprise. W Panel → API i integracje → Klucze API → Biała lista IP dodaj publiczny adres IP każdego serwera (IPv4 lub IPv6). Od dodania pierwszego adresu żądania z Twoimi kluczami z innych adresów IP są odrzucane z błędem 403.

Na ekranie logowania wybierz kod odzyskiwania zamiast 6-cyfrowego kodu i wpisz jeden z kodów odzyskiwania zapisanych przy włączaniu 2FA. Każdy kod działa raz.

Nie masz też kodów? Napisz na [email protected] z adresu e-mail przypisanego do konta.

Powtarzane nieudane logowania są spowalniane, żeby utrudnić zgadywanie haseł. Odczekaj kilka minut albo zresetuj hasło przez Nie pamiętasz hasła na stronie logowania.

Tak. Sekcja Bezpieczeństwo w panelu prowadzi dziennik aktywności konta, na przykład logowań i zmian zabezpieczeń.

Stała opłata miesięczna, nigdy procent od sprzedaży:

• Starter: za darmo, 30 transakcji miesięcznie
• Business: 199 zł miesięcznie, 300 transakcji miesięcznie
• Professional: 499 zł miesięcznie, 1000 transakcji miesięcznie
• Enterprise: wycena indywidualna dla większych wolumenów

GriffNode nie pobiera opłaty za transakcję ani procentu od kwoty płatności. Po osiągnięciu miesięcznego limitu planu nowe płatności są wstrzymane do następnego miesiąca albo do zmiany planu. Nigdy nie naliczamy opłat za nadwyżkę. Opłaty sieci blockchain są osobne i płaci je nadawca. Bez kosztów konfiguracji i bez opłat za rezygnację. Szczegóły znajdziesz na naszej stronie cennika.

Czasy potwierdzenia różnią się w zależności od kryptowaluty:

• Bitcoin (BTC): ~10 minut (1 potwierdzenie) do 60 minut (6 potwierdzeń)
• Litecoin (LTC): ~2,5 minuty (1 potwierdzenie)
• Ethereum (ETH): ~15 sekund do 5 minut
• Dash (DASH): ~2,5 minuty (InstantSend: 1-2 sekundy)
• Dogecoin (DOGE): ~1 minuta

GriffNode czeka na ustaloną liczbę potwierdzeń dla każdej monety, zanim oznaczy płatność jako zakończoną.

Potwierdzone płatności na blockchainie są co do zasady nieodwracalne i nie przechodzą przez procedurę chargeback operatorów kart.

Nadal możesz zwrócić klientowi pieniądze, wysyłając osobną płatność ze swojego portfela na adres, który ci poda. GriffNode nigdy nie przechowuje twoich środków, więc nie możemy wysłać zwrotu za ciebie.

Odpowiadasz za obsługę klienta, zwroty, dostawę, ochronę konsumentów i inne obowiązki prawne.

Minimum: Aby płatności pokrywały opłaty sieciowe blockchaina, zalecamy:

• Bitcoin: równowartość $5 USD
• Ethereum: równowartość $2 USD
• Pozostałe monety: równowartość $1 USD

Maksimum: Brak górnego limitu wielkości transakcji. Przetwarzaj płatności na dowolne kwoty.

Tak! Udostępniamy kompleksowe REST API z:

• pełnym zarządzaniem cyklem życia płatności
• powiadomieniami webhook od planu Business
• generowaniem i monitorowaniem adresów
• historią transakcji i raportowaniem
• ograniczaniem liczby żądań i funkcjami bezpieczeństwa

Szczegółowe przewodniki integracji znajdziesz w naszej dokumentacji API.

Publikujemy wtyczkę do WooCommerce i wtyczkę do WordPressa, obie są w oficjalnym katalogu WordPress.org: w panelu przejdź do Wtyczki, Dodaj nową, wyszukaj GriffNode i kliknij Zainstaluj teraz przy tej, której potrzebujesz. Możesz też wgrać plik zip każdej z nich ze strony wydań na GitHubie. Nie mamy aplikacji do Shopify, a GriffNode nie jest na liście dostawców płatności Shopify, więc na Shopify, i na każdej innej platformie, przekierowujesz klientów na hostowaną stronę płatności i potwierdzasz zamówienie webhookiem. Przewodniki konfiguracji znajdziesz w naszej dokumentacji integracji.

Jeszcze nie. Testowe klucze API (sk_test_) chronią klucz produkcyjny w środowisku deweloperskim, ale płatności nimi wykonane są prawdziwe: używają prawdziwych adresów z twojego portfela i prawdziwych monet.

Najtańszy test to mała prawdziwa płatność, kilka złotych w taniej sieci, na przykład LTC albo DOGE, która trafia na twój portfel. Symulowany tryb testowy jest w przygotowaniu. Zobacz przewodnik po trybie testowym.

Najczęstsze przyczyny:

• Wciąż oczekuje na potwierdzenia: sprawdź w eksploratorze blockchaina przy użyciu ID transakcji
• Wysłano błędną kwotę: upewnij się, że wysłano dokładnie wyświetlaną kwotę (z opłatami)
• Okno płatności wygasło: wygeneruj nowe żądanie płatności
• Błędna waluta: wysłano BTC zamiast LTC itp.

Identyfikatory transakcji można śledzić w przewodniku rozwiązywania problemów.

Płatność niższa o najwyżej 2% od żądanej kwoty liczy się jako opłacona. Poniżej tego progu jest oznaczana w panelu jako Częściowa, a od planu Business twój webhook dostaje payment.partial.

Możesz poprosić klienta o dopłatę, przyjąć częściową kwotę i dopasować zamówienie albo zwrócić ją ze swojego portfela.

Nadpłaty są automatycznie akceptowane i oznaczane w panelu jako „Nadpłacone”. Możesz:

• zatrzymać nadpłatę jako napiwek/darowiznę
• zaliczyć ją jako kredyt sklepowy na przyszłe zakupy
• zwrócić klientowi nadwyżkę

Pełna kwota trafia do twojego portfela; sposób jej obsługi zależy od ciebie.

Nie, nie jest stracona. Typowe przyczyny opóźnień:

• Niska opłata sieciowa: transakcja czeka w mempool na górników
• Przeciążenie sieci: wysoka aktywność w blockchainie powoduje opóźnienia
• Niepotwierdzona transakcja nadrzędna: poprzednia transakcja musi najpierw zostać potwierdzona

Większość transakcji potwierdza się w ciągu kilku godzin. Transakcja, która nigdy się nie potwierdzi, w końcu wypada z sieci, a monety przez cały czas zostają w portfelu nadawcy.

Niestety transakcje kryptowalutowe są nieodwracalne. Jeśli wysłano na:

• Nieprawidłowy adres: transakcja się nie powiedzie, a środki pozostaną w portfelu nadawcy
• Błędny, ale prawidłowy adres: środki przepadają, chyba że odbiorca zgodzi się je zwrócić
• twój stary adres: jeśli wciąż jest w twoim portfelu, otrzymasz środki

Zawsze dokładnie sprawdzaj adresy przed wysłaniem!

Kroki rozwiązywania problemów:

1. Wyślij zdarzenie testowe z Panel → Webhooki
2. Upewnij się, że twój endpoint jest publicznie dostępny (nie localhost na produkcji)
3. Zadbaj, aby twój serwer zwracał status 2xx w ciągu 10 sekund
4. Sprawdź, czy zapora nie blokuje naszych adresów IP
5. Zweryfikuj podpis webhooka w swoim kodzie

Szczegóły konfiguracji znajdziesz w dokumentacji webhooków.

Typowe problemy z uwierzytelnianiem:

• 401: nieprawidłowy lub brakujący klucz API w nagłówku Authorization
• 403: prawidłowy klucz, ale niewystarczające uprawnienia lub IP poza białą listą

Poprawny format nagłówka: Authorization: Bearer YOUR_API_KEY

Sprawdź status klucza API w Panel → Klucze API.

Każdy klucz API ma limit na minutę i na godzinę, zależny od planu:

• Starter: 30 żądań na minutę, 500 na godzinę
• Business: 100 na minutę, 2000 na godzinę
• Professional: 300 na minutę, 5000 na godzinę
• Enterprise: 1000 na minutę, 20 000 na godzinę

Odrzucone żądanie zwraca 429 z nagłówkiem Retry-After: odczekaj tyle sekund przed ponowieniem i obserwuj X-RateLimit-Remaining. Wiele otwartych płatności sprawdzisz jednym żądaniem GET /transactions/list?ids=. Zobacz dokumentację API.

Może się to zdarzyć, jeśli klient odświeży stronę płatności lub kliknie „Zapłać” kilka razy. Aby temu zapobiec:

• Używaj unikalnego order_id dla każdej transakcji
• Sprawdzaj istniejące płatności przed utworzeniem nowych
• Przy tworzeniu płatności wysyłaj nagłówek X-Idempotency-Key

Jeśli klient zapłacił dwa razy, zwróć jedną płatność ze swojego portfela.

Każda płatność jest otwarta przez 60 minut, a kurs jest zablokowany przez cały ten czas. Po wygaśnięciu utwórz nowe żądanie płatności.

Środki wysłane do 6 godzin po zamknięciu okna są nadal wykrywane: płatność ma status „Wpłata po czasie” i wysyłamy ci e-mail, a ty wybierasz „Oznacz jako opłaconą” (sklep dostaje payment.completed) albo „Odrzuć” po zwrocie środków klientowi z portfela. Środki wysłane później i tak trafiają do twojego portfela (nigdy ich nie przechowujemy), ale nie są przypisywane do zamówienia: sprawdź portfel i rozlicz je samodzielnie.

Płatności z kluczem testowym (sk_test_) są dziś prawdziwymi płatnościami w sieci, a nie w testnecie. Sprawdź je więc jak każdą płatność produkcyjną:

• Klient wysłał dokładnie pokazaną kwotę, we właściwej monecie
• 60-minutowe okno płatności jeszcze nie minęło
• Transakcja ma wystarczająco potwierdzeń w eksploratorze bloków

Symulowany tryb testowy jest w przygotowaniu. Zobacz przewodnik po trybie testowym.

Typowe problemy z wtyczką:

• Klucze API nieskonfigurowane lub nieprawidłowe
• Wtyczka nieaktywowana w ustawieniach płatności
• Niewspierana waluta (ceny muszą być w USD, EUR, GBP lub PLN)
• Wtyczka wymaga aktualizacji do najnowszej wersji
• Konflikt z innymi wtyczkami bramek płatności

Sprawdź logi wtyczki oraz przewodniki dla konkretnych platform w dokumentacji integracji.

Panel pokazuje wyłącznie oczekujące płatności, a nie całkowite saldo portfela. Aby zobaczyć rzeczywiste saldo portfela:

• Skorzystaj z eksploratora blockchaina, podając adres swojego portfela
• Sprawdź bezpośrednio w aplikacji portfela
• Pamiętaj: GriffNode nie przechowuje środków, trafiają one prosto do twojego portfela

Panel śledzi wyłącznie płatności utworzone przez GriffNode: API, nasze wtyczki i linki płatnicze.

Błędy SSL zwykle wskazują na:

• Nieaktualny pakiet certyfikatów SSL na twoim serwerze
• Zaporę blokującą połączenia HTTPS
• Użycie HTTP zamiast HTTPS w bazowym adresie URL API
• Certyfikaty samopodpisane w środowisku deweloperskim (wyłączaj weryfikację SSL tylko do testów)

Upewnij się, że biblioteka klienta HTTP ma aktualne certyfikaty CA.

Kursy wymiany są blokowane w momencie utworzenia płatności i utrzymywane przez czas trwania okna płatności (60 minut). Chroni to przed zmiennością kursu. Kurs pokazany w twoim panelu to kurs z chwili utworzenia płatności, a nie bieżący kurs rynkowy.

Aby ograniczyć rozbieżności, zachęcaj klientów do szybkiego finalizowania płatności.

Rozszerzony klucz publiczny (xPub, ypub lub zpub) pozwala nam wyprowadzić nowy adres odbiorczy dla każdej płatności i obserwować przychodzące środki.

Rozszerzony klucz publiczny nie pozwala wydać twoich środków. Można jednak z niego wyprowadzić publiczne adresy i zobaczyć powiązaną historię transakcji. Traktuj go jak informację poufną. Nigdy nie udostępniaj klucza prywatnego ani frazy odzyskiwania portfela.

Jak go wyeksportować, opisuje przewodnik po konfiguracji portfela.

Niezalecane. Choć technicznie jest to możliwe, ponowne używanie adresów:

• obniża prywatność (wszystkie transakcje są publicznie powiązane)
• utrudnia śledzenie płatności
• zwiększa ryzyko pomyłek przy płatnościach

GriffNode automatycznie generuje unikalne adresy dla każdej płatności, korzystając z portfeli HD. Zawsze używaj adresu wskazanego dla danej transakcji.

W panelu otwórz Portfele i dodaj nowy xPub. Jeśli masz włączone 2FA, najpierw poprosimy o świeży kod lub klucz dostępu.

Płatności utworzone przed zmianą zachowują adres ze starego portfela, więc zachowaj stary portfel, dopóki nie zostaną opłacone lub nie wygasną. Nowe płatności trafiają na nowy portfel.

Podaj rozszerzony klucz publiczny, który eksportuje twój portfel. Dla Bitcoina przyjmujemy klucze xpub, ypub i zpub. Adresy Native SegWit (zaczynające się od bc1q) mają najniższe opłaty, więc używaj ich, jeśli twój portfel na to pozwala.

Taproot (bc1p) i klucze multisig nie są jeszcze obsługiwane.

Tak! Dla każdej obsługiwanej kryptowaluty konfigurujesz osobny portfel:

• Bitcoin → XPub twojego portfela Bitcoin
• Ethereum → XPub twojego portfela Ethereum (tokeny ERC-20 trafiają na ten sam portfel)
• Litecoin → XPub twojego portfela Litecoin
• I tak dalej...

Każda kryptowaluta wymaga własnego portfela. Nie możesz na przykład użyć portfela Bitcoin do odbierania Ethereum.

Oczywiście! Portfele sprzętowe są zdecydowanie zalecane ze względów bezpieczeństwa. Po prostu wyeksportuj XPub ze swojego portfela sprzętowego i przekaż go do GriffNode. Twoje klucze prywatne nigdy nie opuszczają urządzenia sprzętowego.

Powinien działać każdy portfel, który eksportuje rozszerzony klucz publiczny. Przetestowaliśmy Ledgera dla Bitcoina i Litecoina.

Jeśli używasz portfeli HD (XPub), wszystkie wygenerowane adresy należą do twojego portfela - nie musisz ich „zbierać” (sweep). Aplikacja portfela automatycznie zarządza wszystkimi adresami.

Jeśli używasz pojedynczych adresów, skorzystaj z funkcji „sweep” lub „konsolidacja” w portfelu, aby przenieść środki na jeden adres (uwaga: za każdą konsolidację zapłacisz opłaty sieciowe).

Standardowe ścieżki derywacji:

• BIP44 (Legacy): m/44'/0'/0' - dla adresów zaczynających się od „1”
• BIP49 (SegWit): m/49'/0'/0' - dla adresów zaczynających się od „3”
• BIP84 (Native SegWit): m/84'/0'/0' - dla adresów zaczynających się od „bc1”

Większość portfeli domyślnie używa BIP84. Ścieżka derywacji musi odpowiadać typowi XPub twojego portfela.

Nie! Nigdy! GriffNode działa w trybie tylko do obserwacji (watch-only). Potrzebujemy wyłącznie twojego XPub (klucza publicznego), aby generować adresy i monitorować przychodzące płatności. Twoje klucze prywatne pozostają wyłącznie pod twoją kontrolą.

Nie możemy wydawać twoich środków, możemy jedynie obserwować przychodzące płatności. Rozszerzony klucz publiczny nie pozwala wydać twoich środków. Można jednak z niego wyprowadzić publiczne adresy i zobaczyć powiązaną historię transakcji. Traktuj go jak informację poufną. Nigdy nie udostępniaj klucza prywatnego ani frazy odzyskiwania portfela.

Niezalecane. Portfele giełdowe mają ograniczenia:

• Adresy często się zmieniają lub wygasają
• Nie można wyeksportować XPub (trzeba używać pojedynczego adresu)
• Giełda może oznaczyć/zamrozić konta otrzymujące płatności od sprzedawców
• Nie kontrolujesz kluczy prywatnych

Zamiast tego użyj portfela programowego lub sprzętowego, który eksportuje xPub.

Przed zapisaniem adresu portfela:

1. Wyślij na adres niewielką transakcję testową
2. Sprawdź, czy pojawiła się w twoim portfelu
3. Dopiero wtedy skonfiguruj go w GriffNode
4. Dokładnie sprawdź adres znak po znaku

Nasz system waliduje format adresu, ale nie może zweryfikować, czy jesteś jego właścicielem. Zawsze testuj najpierw!

Portfele stosują „limit luki” (gap limit, zwykle 20) - przestają skanować adresy po znalezieniu 20 kolejnych nieużywanych adresów. Jeśli wygenerujesz wiele adresów, które nie otrzymują płatności, część z nich może znaleźć się poza tą luką.

Rozwiązanie: Zwiększ limit luki w swoim portfelu lub zadbaj, aby adresy były używane w kolejności sekwencyjnej. Większość nowoczesnych portfeli obsługuje to automatycznie.

Webhooki są w planie Business (1 endpoint) i Professional (do 3). Starter nie ma webhooków: nasze wtyczki sprawdzają status płatności przez API.

1. W panelu otwórz Webhooki i dodaj endpoint
2. Podaj publiczny adres HTTPS
3. Zapisz sekret webhooka i weryfikuj podpis każdego żądania
4. Użyj zdarzenia testowego, żeby sprawdzić obsługę

Szczegóły znajdziesz w dokumentacji webhooków.

Każdy webhook zawiera nagłówek X-GriffNode-Signature. Aby zweryfikować:

1. Pobierz surową treść żądania (przed sparsowaniem JSON)
2. Oblicz HMAC-SHA256 przy użyciu swojego sekretu webhooka
3. Porównaj obliczony podpis z wartością nagłówka
4. Odrzuć webhook, jeśli podpisy się nie zgadzają

Przykładowy kod znajdziesz w naszym przewodniku po webhookach.

Jeśli twój endpoint nie zwróci statusu 2xx w ciągu 10 sekund, ponawiamy automatycznie, w coraz większych odstępach: po około 10 sekundach, 1 minucie, 5 i 30 minutach, potem po 1, 2, 4 i 8 godzinach, do 24 godzin od zdarzenia.

Jeśli wszystkie próby zawiodą, wyślemy ci e-mail. Aktualny stan płatności zawsze sprawdzisz przez GET /v1/transactions/{transaction_id}.

Skorzystaj z usługi tunelowania, aby udostępnić localhost:

• ngrok: ngrok http 3000 - uzyskaj publiczny adres URL HTTPS
• localtunnel: lt --port 3000
• Cloudflare Tunnel: dla trwałych adresów deweloperskich

Potem użyj zdarzenia testowego w panelu, żeby wysłać żądanie na publiczny adres.

• payment.created: płatność utworzona, czeka na zapłatę
• payment.pending: płatność widoczna w sieci, czeka na potwierdzenia
• payment.completed: potwierdzona i w pełni opłacona
• payment.overpaid: w pełni opłacona, wpłynęło więcej niż trzeba
• payment.partial: wpłynęło mniej niż żądana kwota
• payment.expired: 60-minutowe okno minęło bez płatności
• payment.failed: awaria systemu przerwała normalne zakończenie płatności
• payment.paid_late: monety dotarły do 6 godzin po oknie; decydujesz w panelu
• payment.needs_review: tylko ETH i ERC-20, płatności nie da się ocenić automatycznie; sprawdź portfel

Wszystkie pola znajdziesz w dokumentacji webhooków.

Każde zdarzenie ma stałe id, takie samo przy każdej ponownej próbie:

1. Zapisuj każde przetworzone id w swojej bazie danych
2. Przed przetworzeniem sprawdź, czy id już istnieje
3. Jeśli istnieje, od razu zwróć 200 (już przetworzone)
4. Jeśli jest nowe, przetwórz zdarzenie i zapisz id

Zapobiega to podwójnej realizacji zamówień przy ponawianiu webhooków.

Zastosuj przetwarzanie asynchroniczne:

1. Od razu zwróć do GriffNode status 2xx
2. Umieść webhook w kolejce do przetwarzania w tle
3. Realizuj zamówienie asynchronicznie

Nie wykonuj ciężkich operacji (wysyłanie e-maili, aktualizacja magazynu) w obsłudze webhooka. Zamiast tego umieść je w kolejce.

• Zdarzenie testowe w Panel → Webhooki, żeby sprawdzić obsługę
• Webhook.site lub RequestBin, żeby obejrzeć surową treść
• Logi twojego serwera, żeby znaleźć błędy

Typowe przyczyny: błędy SSL, weryfikacja podpisu na sparsowanym JSON zamiast surowej treści i obsługa dłuższa niż 10 sekund.

Tak. W ustawieniach panelu, w preferencjach e-mail, wybierasz, jakie wiadomości dostajesz:

• Otrzymano płatność: e-mail w chwili potwierdzenia płatności klienta
• Powiadomienia o fakturach
• Alerty bezpieczeństwa, na przykład logowania i podejrzana aktywność
• Raporty tygodniowe (Professional)
• Oferty i nowości

W planie Professional dodasz do 3 endpointów webhooków, a Enterprise nie ma limitu. Business ma 1 endpoint, który dostaje wszystkie zdarzenia. Starter nie ma webhooków.

Każdy endpoint ma własny sekret do weryfikacji podpisu. Osobne endpointy przydają się dla różnych usług albo dla środowiska testowego i produkcyjnego.