Jak przyjmować płatności krypto na WooCommerce (bez KYC)
Przewodniki · GriffNode Team · · 9 min read

Jak przyjmować płatności krypto na WooCommerce (bez KYC)

Dodaj Bitcoin i płatności krypto do sklepu WooCommerce, bez KYC i bez chargebacków: środki trafiają prosto do twojego własnego portfela. Przewodnik po konfiguracji krok po kroku.

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ć

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.

  1. W panelu GriffNode utwórz hostowaną stronę płatności lub link do płatności na kwotę, którą chcesz pobrać.
  2. 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.
  3. 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.
  4. 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

  1. Załóż konto GriffNode i podłącz xPub swojego portfela w sekcji Wallets.
  2. Wygeneruj klucz API w swoim panelu.
  3. 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.
  4. 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.
  5. 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ść.

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

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.

MetodaOpłata za transakcjęPowiernictwoChargebacki
Karta / PayPal2,4-2,9% + 0,30 USDPrzetrzymywane / opóźnienie wypłatyTak
BitPay / Coinbase Commerce~1%PowierniczeNie
NOWPayments0,5-1%TrasowaneNie
GriffNode0% (stały plan miesięczny)Twój własny portfelNie

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.

RokMediana opłaty BitcoinStawkaMediana base fee Ethereum
2017 (najdroższy rok za miejsce w bloku)41 174 sat134 sat/vBprzed EIP-1559
20212 712 sat10 sat/vB81,04 gwei
20241 733 sat10 sat/vB10,30 gwei
2025356 sat2 sat/vB0,55 gwei
2026163 sat1 sat/vB0,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.

Free checklist

Is your processor about to freeze you?

Get the 7 warning signs — plus the plain-English way to get paid in crypto that can't be frozen. No spam, unsubscribe anytime.

Ready to accept crypto payments?

Set up in minutes. No KYC required. Non-custodial — funds go directly to your wallet.

Get started free →