Karty, portfele, BLIK i Przelewy24 u jednego dostawcy: jak zintegrować Stripe z Shopware 6 przez oficjalną wtyczkę lub API, łącznie z webhookami, kartami testowymi i uruchomieniem sklepu w Polsce.
Sprawne i bezpieczne przyjmowanie płatności to w sklepie internetowym kwestia bezdyskusyjna. Ten przewodnik prowadzi właścicieli sklepów i programistów do solidnej integracji Stripe z Shopware 6, także w sklepach sprzedających w Polsce. Dowiedzą się Państwo:
Jakich innych dostawców można podłączyć, pokazuje nasz przegląd integracji płatności w Shopware.
Stripe to platforma do przyjmowania płatności online: jednorazowych zakupów, subskrypcji lub wypłat dla sprzedawców na marketplace. Poza samymi płatnościami kartą Stripe oferuje:
Dla sklepów headless lub mocno dostosowanych procesów:
stripe/stripe-php przez Composer, tworzyć PaymentIntents, potwierdzać płatności i zarządzać subskrypcjami.payment_intent.succeeded, invoice.payment_failed czy charge.refunded i ustawiać status zamówienia w Shopware.Własną integrację przygotujemy jako wtyczkę lub aplikację Shopware, zob. tworzenie wtyczek do Shopware.
Jeśli zarządzają Państwo rozszerzeniami przez Composer, pakiet pobiera się przez konto Shopware, a następnie aktywuje:
bin/console plugin:refresh
bin/console plugin:install --activate StripeShopwarePayment
bin/console cache:clear
Dokładną nazwę techniczną pokazuje bin/console plugin:list.
pk_test_ i sk_test_).payment_intent.succeeded, payment_intent.payment_failed, charge.refunded, a przy subskrypcjach invoice.payment_succeeded.whsec_…) do konfiguracji wtyczki.Wiele wersji wtyczki tworzy endpoint automatycznie. Prosimy sprawdzić w panelu, czy istnieje i wskazuje na właściwy tryb.
Następnie należy aktywować metody płatności w sekcji Ustawienia → Sklep → Metody płatności i przypisać je do kanałów sprzedaży.
4242 4242 4242 4242, dowolna przyszła data ważności, dowolny kod CVC.Dzięki Payment Element Stripe wyświetla wszystkie aktywne metody płatności w jednym formularzu bezpośrednio w Państwa checkoucie. Podstawowa struktura we własnej integracji:
<form id="payment-form">
<div id="payment-element"></div>
<button id="submit">Zapłać teraz</button>
</form>
const stripe = Stripe('pk_test_TWOJ_KLUCZ');
// clientSecret pochodzi z PaymentIntent utworzonego przez Państwa serwer
const elements = stripe.elements({ clientSecret });
const paymentElement = elements.create('payment');
paymentElement.mount('#payment-element');
document.getElementById('payment-form').addEventListener('submit', async (e) => {
e.preventDefault();
const { error } = await stripe.confirmPayment({
elements,
confirmParams: { return_url: 'https://twoj-sklep.pl/checkout/finish' }
});
if (error) { console.error(error.message); }
});
Wtyczka Shopware wykonuje tę integrację samodzielnie; kod ma znaczenie tylko wtedy, gdy budują Państwo własny checkout.
4242 4242 4242 42424000 0000 0000 00024000 0000 0000 99954000 0025 0000 3155pk_live_, sk_live_) w konfiguracji wtyczki.Stripe wysyła powiadomienie przy każdym ważnym zdarzeniu. Najczęstsze z nich:
payment_intent.succeeded: oznaczyć zamówienie jako opłacone i wysłać potwierdzenie.payment_intent.payment_failed: poinformować klienta i zaproponować inną metodę płatności.charge.refunded: ustawić zamówienie na „zwrócone” i wysłać potwierdzenie.invoice.payment_succeeded: przedłużyć subskrypcję i wysłać potwierdzenie płatności.$payload = file_get_contents('php://input');
$signature = $_SERVER['HTTP_STRIPE_SIGNATURE'] ?? '';
try {
$event = \Stripe\Webhook::constructEvent($payload, $signature, $webhookSecret);
} catch (\Exception $e) {
http_response_code(400);
exit;
}
switch ($event->type) {
case 'payment_intent.succeeded':
$this->markOrderPaid($event->data->object->metadata->order_id);
break;
case 'payment_intent.payment_failed':
$this->notifyCustomer($event->data->object->metadata->order_id);
break;
}
http_response_code(200);
Zawsze należy weryfikować podpis, szybko odpowiadać kodem 200 i przetwarzać zdarzenie idempotentnie, ponieważ Stripe ponawia doręczenia. Jak Shopware sam obsługuje webhooki, opisujemy w artykule o webhookach w Shopware 6.
var/log/ pod kątem wyjątków.stripe listen --forward-to https://twoj-sklep.test/stripe/webhookPrzy Stripe Checkout lub Elements dane kart przetwarza Stripe, a nie Państwa serwer. Strony checkoutu należy udostępniać wyłącznie przez HTTPS i nigdy nie zapisywać w logach pełnych danych kart.
Prosimy włączyć standardowe reguły Radar, regularnie przeglądać oznaczone płatności i doprecyzowywać limity dla podejrzanych wzorców. Należy korzystać z 3-D Secure; w Europie, a więc także w Polsce, silne uwierzytelnianie klienta (SCA) i tak jest obowiązkowe.
Do każdego PaymentIntent warto dołączać jako metadane numer zamówienia, ID klienta i wartość koszyka. Dzięki temu płatności w Stripe i w księgowości można jednoznacznie uzgodnić.
Jak zmienić klucze API bez wyłączania sklepu?
Wtyczka przechowuje równolegle klucze testowe i produkcyjne; wystarczy wprowadzić nowe klucze i przełączyć tryb. Przy własnych integracjach zmianę należy wdrożyć w czasie niskiego ruchu.
Czy mogę oferować płatności odroczone lub ratalne?
Tak. W panelu Stripe w sekcji metod płatności można aktywować opcje „kup teraz, zapłać później”, takie jak Klarna, o ile są dostępne dla danego kraju i waluty, a następnie odblokować je we wtyczce.
Jak działają zwroty?
Pełne zwroty inicjuje się w zamówieniu w Shopware, a wtyczka wywołuje API Stripe. Zwroty częściowe wykonuje się w panelu Stripe lub przez API z podaniem kwoty.
Ile kosztuje Stripe w Polsce?
Według cennika Stripe dla kont z siedzibą w Polsce (stripe.com/pl/pricing, stan na listopad 2026) standardowa stawka dla kart z Europejskiego Obszaru Gospodarczego wynosi 1,5 % + 1,00 zł za transakcję, dla kart międzynarodowych 3,25 % + 1,00 zł, a przy konieczności przewalutowania dochodzi 2 %. BLIK kosztuje 1,6 % + 1,00 zł, Przelewy24 1,9 % + 1,00 zł. Aktualne warunki podaje dostawca na stripe.com.
Jakie metody płatności dobrze uzupełniają Stripe?
Na rynku polskim przede wszystkim PayPal, a także PayU jako alternatywny operator BLIK i szybkich przelewów. Amazon Pay nie obsługuje według Amazon waluty PLN ani firm z siedzibą wyłącznie w Polsce i ma znaczenie głównie przy sprzedaży zagranicznej w euro. Gdzie Państwa checkout traci klientów, pokaże nasza analiza sklepu.