Możesz dodać płatność krypto do WooCommerce już dziś bez żadnej wtyczki: podłącz xPub swojego portfela do bramki bez powiernictwa, a następnie dodaj hostowaną opcję „Zapłać kryptowalutą” albo wepnij API i webhooki w proces płatności. Płatności rozliczają się ostatecznie i trafiają prosto do portfela, który kontrolujesz: bez KYC, bez chargebacków, z opłatą 0% od transakcji. Oto pełna konfiguracja.
Dlaczego sklepy WooCommerce dodają krypto
WooCommerce daje ci kontrolę nad sklepem, ale twoja bramka płatności wciąż może zamrozić wypłaty albo wrzucić klientowi chargeback wiele tygodni po wysłaniu towaru. Dodanie krypto naprawia jedno i drugie: płatności rozliczają się ostatecznie i trafiają prosto do portfela, który kontrolujesz. Bez blokad, bez cofnięć, bez banów za „wysokie ryzyko”. Ten przewodnik pokazuje, jak to skonfigurować.
Czego będziesz potrzebować
- Sklepu WooCommerce (dowolny host).
- Portfela, który daje ci rozszerzony klucz publiczny (xPub): większość nowoczesnych portfeli Bitcoin to potrafi. Jeśli to dla ciebie nowość, przeczytaj czym jest klucz xPub i jak jeden klucz generuje nieograniczoną liczbę adresów.
- Darmowego konta GriffNode (e-mail + hasło, bez KYC).
Jak to działa pod maską
GriffNode działa bez powiernictwa. xPub wklejasz raz; dla każdego zamówienia wyprowadzamy z niego świeży adres odbiorczy, tak aby klient płacił bezpośrednio do twojego portfela. Nigdy nie przechowujemy ani nie dotykamy środków: nie możemy ich wydać ani zamrozić. Sklep dostaje śledzenie potwierdzeń w czasie rzeczywistym (od 0/3 do 3/3 potwierdzeń) oraz webhook, gdy płatność jest kompletna. Ponieważ dla każdego zamówienia generowany jest nowy adres, płatności łatwo uzgadniać, a twoi klienci nigdy nie współdzielą adresu.
Dwa sposoby na dodanie krypto do WooCommerce
Nie ma oficjalnej wtyczki WooCommerce do zainstalowania, i nie jest ci potrzebna. Wybierz ścieżkę pasującą do twojego sklepu i twojej swobody w kodzie. Strona integracji z WooCommerce podsumowuje je wszystkie.
Ścieżka 1: hostowana płatność / linki do płatności (bez kodu)
To najszybszy sposób, aby wystartować, i działa na każdym hoście WooCommerce, bez tykania choćby jednej linijki PHP.
- W panelu GriffNode utwórz hostowaną stronę płatności lub link do płatności na kwotę, którą chcesz pobrać.
- Dodaj to do sklepu jako opcję „Zapłać kryptowalutą”: przycisk w koszyku lub na stronie z podziękowaniem, link w e-mailu z potwierdzeniem zamówienia albo ręczną fakturę wysyłaną po złożeniu zamówienia.
- Klient trafia na hostowaną stronę GriffNode, która pokazuje dokładną kwotę krypto, kod QR BIP-21 do płatności jednym dotknięciem z dowolnej aplikacji portfela oraz status potwierdzeń na żywo.
- Obserwujesz, jak płatność się potwierdza w panelu, i realizujesz zamówienie.
Ta ścieżka jest idealna dla mniejszych sklepów, firm usługowych, produktów cyfrowych do pobrania oraz każdego, kto chce mieć krypto na żywo już dziś po południu, a nie po całym sprincie. To to samo podejście, które opisujemy dla przyjmowania krypto na WordPress ogólnie, i czysto przekłada się na WooCommerce.
Ścieżka 2: REST API + webhooki (w pełni automatyczna)
Jeśli chcesz, aby krypto zachowywało się jak natywna bramka WooCommerce, czyli zamówienie tworzone przy kasie i automatycznie oznaczane jako zrealizowane w chwili potwierdzenia, użyj REST API i webhooków. GriffNode dostarcza SDK dla JavaScript, Python i PHP, a ponieważ WooCommerce to PHP, możesz wpiąć to bezpośrednio w swój motyw lub małą własną wtyczkę.
Przepływ jest taki: twój sklep wywołuje API, aby utworzyć płatność, gdy klient przechodzi do kasy, przekierowuje go na zwrócony adres URL płatności, a następnie nasłuchuje webhooka payment.confirmed, aby zrealizować zamówienie WooCommerce. Są trzy zdarzenia webhooków, payment.created, payment.confirmed i payment.expired, obejmujące pełny cykl życia. Pełny model webhooków opisuje przewodnik po webhookach płatności krypto.
Konfiguracja WooCommerce krok po kroku
- Załóż konto GriffNode i podłącz xPub swojego portfela w sekcji Wallets.
- Wygeneruj klucz API w swoim panelu.
- Dodaj płatność krypto do WooCommerce przy użyciu Ścieżki 1 (hostowana płatność / link do płatności) lub Ścieżki 2 (REST API + webhooki) z powyższych.
- Przetestuj małe prawdziwe zamówienie od początku do końca: zeskanuj kod QR BIP-21, zapłać i obserwuj, jak potwierdza się w panelu.
- Przejdź na produkcję. Klienci mogą teraz płacić w BTC, ETH, LTC, DOGE, DASH oraz stablecoinach USDT, USDC i DAI.
Konkretny przykład API
Oto ścieżka dewelopera od początku do końca. Najpierw utwórz płatność, gdy klient składa zamówienie. Ścieżki endpointów poniżej są poglądowe: sprawdź aktualne kształty w dokumentacji API na docs.griffnode.com.
// Create a crypto payment for a WooCommerce order
$response = wp_remote_post( 'https://api.griffnode.com/v1/payments', array(
'headers' => array(
'Authorization' => 'Bearer ' . GRIFFNODE_API_KEY,
'Content-Type' => 'application/json',
),
'body' => wp_json_encode( array(
'amount' => $order->get_total(), // e.g. 49.00
'currency' => 'USD', // priced in USD, paid in crypto
'coin' => 'USDT', // let the customer pick, or default
'order_id' => $order->get_id(),
'webhook_url' => 'https://yourstore.com/?wc-api=griffnode',
) ),
) );
$payment = json_decode( wp_remote_retrieve_body( $response ), true );
// Redirect the customer to the hosted checkout for this payment
wp_redirect( $payment['checkout_url'] );
exit;
Następnie obsłuż webhook payment.confirmed, aby automatycznie zrealizować zamówienie. Zawsze weryfikuj podpis webhooka, zanim zaufasz ładunkowi.
// WooCommerce webhook endpoint: ?wc-api=griffnode
add_action( 'woocommerce_api_griffnode', function () {
$payload = file_get_contents( 'php://input' );
$event = json_decode( $payload, true );
// Verify the signature header against your webhook secret first.
// (see docs.griffnode.com for the exact scheme)
if ( $event['type'] === 'payment.confirmed' ) {
$order = wc_get_order( $event['data']['order_id'] );
if ( $order ) {
$order->payment_complete( $event['data']['payment_id'] );
$order->add_order_note( 'Crypto payment confirmed on-chain.' );
}
}
status_header( 200 );
exit;
} );
To cała pętla: utwórz płatność, wyślij klienta na hostowaną stronę płatności i pozwól, aby potwierdzony webhook przełączył zamówienie WooCommerce na zrealizowane. Nic powierniczego nie siedzi pośrodku: środki przeszły prosto do twojego portfela.
Które monety i stablecoiny włączyć
GriffNode obsługuje Bitcoin, Ethereum, Litecoin, Dogecoin i Dash, a także stablecoiny ERC-20 USDT, USDC i DAI. To, które włączysz, zależy od tego, jak dużo ruchu ceny chcesz na sobie nieść.
- Stablecoiny (USDT, USDC, DAI) podążają za dolarem amerykańskim, więc zamówienie za 49 USD pozostaje warte około 49 USD od kasy do rozliczenia. Jeśli wolisz nie myśleć o zmienności, postaw na stablecoiny: zobacz jak przyjmować płatności stablecoinami. Zwróć uwagę, że przekazanie płatności tokenem wiąże się z niewielką opłatą sieciową 1 USD w monecie natywnej, ponieważ transfery ERC-20 potrzebują ETH na gas.
- Bitcoin i pozostałe monety natywne to to, co wielu klientów zżytych z krypto faktycznie trzyma i woli wydawać. Ich włączenie poszerza zasięg twojej publiczności; po prostu godzisz się z tym, że wartość w walucie fiat może dryfować między wyceną a potwierdzeniem.
Częsty układ to stablecoiny dla faktur wrażliwych na cenę oraz BTC/LTC/DOGE dla płatności konsumenckich, ale możesz włączyć cokolwiek pasuje do twojego katalogu.
Obsługa zamówień i realizacji
- Każda płatność ma krótkie 15-minutowe okno ważności, więc kwota krypto pozostaje zgodna z wycenionym kursem. Jeśli okno minie, dostajesz zdarzenie
payment.expired, a klient po prostu zaczyna nową. - Użyj webhooka, aby automatycznie uruchamiać realizację po potwierdzeniu: bez ręcznego sprawdzania.
- Sprzedajesz dobra cyfrowe? Ostateczność on-chain oznacza zero chargebacków: zobacz krypto dla produktów cyfrowych.
Zwroty na szynie bez chargebacków
Ponieważ płatności krypto są ostateczne i nie ma pośrodku sieci kartowej, zwroty nie są automatycznymi cofnięciami: to nowa płatność, którą odsyłasz. To zaleta, nie luka: nikt nie może po cichu wyszarpać środków z twojego portfela wiele tygodni później, a żaden procesor nie może zamrozić wypłaty, bo kategoria wygląda na „wysokie ryzyko”. Kiedy faktycznie musisz zwrócić pieniądze klientowi, odsyłasz krypto na adres, który poda, na twoich warunkach i w twoim czasie. Szerszy obraz tego, dlaczego usuwa to całą klasę strat na oszustwach, znajdziesz w artykule jak płatności krypto eliminują chargebacki.
Ile to kosztuje?
GriffNode to stały cennik miesięczny bez procentu od transakcji. Poziom Starter jest darmowy (30 transakcji miesięcznie), Business kosztuje 49 USD miesięcznie (300 transakcji), a Professional 129 USD miesięcznie (1000 transakcji), z niewielką dopłatą za transakcję w centach powyżej planu. To ma znaczenie przy skali: opłata kartowa 2,9% od zamówienia za 200 USD to 5,80 USD za każdym razem, podczas gdy stały plan nie rośnie wraz z wielkością koszyka. Oto jak wypadają na tle siebie popularne opcje płatności WooCommerce, a pełniejsze rozłożenie na czynniki pierwsze znajdziesz w artykule opłaty bramek płatności krypto.
| Metoda | Opłata za transakcję | Powiernictwo | Chargebacki |
|---|---|---|---|
| Karta / PayPal | 2,4-2,9% + 0,30 USD | Przetrzymywane / opóźnienie wypłaty | Tak |
| BitPay / Coinbase Commerce | ~1% | Powiernicze | Nie |
| NOWPayments | 0,5-1% | Trasowane | Nie |
| GriffNode | 0% (stały plan miesięczny) | Twój własny portfel | Nie |
Ile płatność krypto naprawdę kosztuje w sieci
Opłata bramki to jedna liczba. Druga to opłata sieciowa, którą klient płaci za przesłanie monet, a niemal każdy poradnik na ten temat wciąż podaje liczby z czasów ostatniego szczytu zatorów. Utrzymujemy własne pełne węzły Bitcoina i Ethereum, więc zamiast szacować, zmierzyliśmy każdy blok Bitcoina od 2009 roku i każdy blok Ethereum od forka London.
| Rok | Mediana opłaty Bitcoin | Stawka | Mediana base fee Ethereum |
|---|---|---|---|
| 2017 (najdroższy rok za miejsce w bloku) | 41 174 sat | 134 sat/vB | przed EIP-1559 |
| 2021 | 2 712 sat | 10 sat/vB | 81,04 gwei |
| 2024 | 1 733 sat | 10 sat/vB | 10,30 gwei |
| 2025 | 356 sat | 2 sat/vB | 0,55 gwei |
| 2026 | 163 sat | 1 sat/vB | 0,114 gwei |
163 satoshi to 0,00000163 BTC. Przy kursie Bitcoina 100 000 dolarów daje to około 16 centów, a base fee Ethereum stawia podłogę dla zwykłego przelewu na 0,00000239 ETH. Zestaw to z 2,9 procent plus 30 centów, co przy zamówieniu za 100 dolarów oznacza 3,20 dolara zabierane z każdej sprzedaży, zanim doliczysz ryzyko chargebacku.
Drugą liczbą, o którą pytają sprzedawcy, jest szybkość, a reguły kciuka mylą się w obie strony. Z pomiaru 30 dni bloków mediana czasu do jednego potwierdzenia Bitcoina wyniosła 427 sekund, czyli około 7 minut zamiast typowych 10. Ale 90. percentyl to 1370 sekund, prawie 23 minuty w wolnym ogonie, i to jest liczba, która naprawdę liczy się przy kasie.
Oba zbiory danych są opublikowane w całości, z metodologią i surowym CSV, na licencji CC BY 4.0 (strony z danymi są po angielsku): zmierzone opłaty transakcyjne rok po roku oraz zmierzone czasy potwierdzeń.
Najczęściej zadawane pytania
Czy potrzebuję wtyczki WooCommerce?
Nie. Nie ma oficjalnej wtyczki do zainstalowania i nie jest ci potrzebna. Wystartuj już dziś z hostowaną stroną płatności lub linkiem do płatności bez kodu albo wepnij REST API i webhooki w swój sklep, aby uzyskać w pełni natywny, automatyczny przepływ.
Jak szybko potwierdzają się płatności?
Dostajesz status w czasie rzeczywistym od pierwszego wykrycia (0/3) po pełne potwierdzenie (3/3), a webhook odpala się w chwili potwierdzenia. Szybkość zależy od monety i warunków w sieci; stablecoiny i szybsze łańcuchy zwykle potwierdzają się w kilka minut.
Jakie opłaty pobiera GriffNode?
Stała opłata miesięczna i 0% od transakcji. Starter jest darmowy (30 tx/mies.), Business kosztuje 49 USD/mies. (300 tx/mies.), a Professional 129 USD/mies. (1000 tx/mies.), z dopłatą na poziomie centów powyżej planu. Przekazanie tokena wiąże się z niewielką opłatą sieciową 1 USD w monecie natywnej na gas. Pełne szczegóły są na stronie cennika.
Czy to naprawdę bez KYC?
Tak. Ponieważ środki nigdy nas nie dotykają, nie ma powierniczego obowiązku weryfikacji tożsamości. Zaczynasz wyłącznie od adresu e-mail i hasła.
Co się dzieje, jeśli cena zmieni się w trakcie płatności?
Każda płatność blokuje kwotę krypto na 15-minutowe okno, więc klient, który zapłaci w tym oknie, płaci to, co wyceniono. Jeśli okno minie, płatność wygasa, a on po prostu zaczyna nową po bieżącym kursie. Wycena zamówień w stablecoinie całkowicie usuwa kwestię zmienności.
Gdzie trafiają pieniądze?
Bezpośrednio do twojego własnego portfela, za każdym razem. GriffNode nigdy ich nie przechowuje i nie może ich zamrozić ani wydać.
Jakimi monetami mogą płacić klienci WooCommerce?
Bitcoin, Ethereum, Litecoin, Dogecoin i Dash, a także stablecoiny USDT, USDC i DAI dla płatności o stabilnej cenie.
Czy płatności krypto na WooCommerce są odwracalne?
Nie. Rozliczenie on-chain jest ostateczne, więc nie ma chargebacków: to ogromna zaleta dla dóbr cyfrowych i kategorii wysokiego ryzyka.
Podsumowanie
Płatność krypto na WooCommerce zajmuje kilka minut i daje ci płatności, których nie da się zamrozić ani cofnąć. Załóż darmowe konto i dodaj do swojego sklepu odporną na zamrożenie szynę płatności. Prowadzisz drugi sklep? To samo podejście działa dla przyjmowania krypto na Shopify, a zanim to włączysz, możesz zgłębić temat w artykule jak płatności krypto eliminują chargebacki.