Stripe
Płatności online w sklepie i aplikacji: wybór przepływu, webhooki, idempotencja i subskrypcje.
IntegracjeUżywam od 2022 · Wyróżniony projekt: CAS Marketplace (w zespole Code & Pepper)
- Kategoria
- Integracje
- Używam od
- 2022
- Wyróżniony projekt
- CAS Marketplacew zespole Code & Pepper
W praktyce
Stripe wybieram do płatności online, gdy sklep lub aplikacja przyjmuje jednorazowe płatności albo subskrypcje i nie ma budować tego od zera. W zespole Code & Pepper pracowałem z nim w Gaia Lens, przy subskrypcjach, oraz w CAS Marketplace, przy płatnościach w marketplace.
Czym jest Stripe?
Stripe to usługa płatności online z publicznym API, którą podłączasz do sklepu albo aplikacji bez własnego procesora kart. Płatności jednorazowe i subskrypcje obsługuje strona płatności, formularz osadzony w Twojej aplikacji albo własny układ z komponentami Elements, a po stronie serwera tworzysz sesję płatności lub obiekt PaymentIntent.
O wyniku płatności aplikacja dowiaduje się z webhooków: Stripe wysyła zdarzenia na Twój adres HTTPS, na przykład gdy bank potwierdzi płatność albo klient zakwestionuje obciążenie, albo cykliczna płatność się powiedzie. Powtórzone żądania zabezpiecza się kluczem idempotentności, żeby nie wykonać operacji dwa razy.
Jak pracuję z Stripe
Zaczynam od tego, co się dzieje, gdy płatność się nie uda, a nie od przycisku "Zapłać". Dopiero potem projektuję formularz i komunikaty. Stripe obsługuje płatność, ale zamówienie, faktura i dostęp do produktu żyją w Twojej aplikacji i muszą zgadzać się ze stanem w Stripe.
Sposób płatności
Wybieram, czy wystarczy strona płatności Stripe, formularz osadzony, czy własny układ z Elements, i pytam, kto będzie to utrzymywał po wdrożeniu. Pełna strona płatności wymaga najmniej utrzymania, a Elements najwięcej.
Webhooki i powtórzenia
Stan zamówienia zmieniam na podstawie webhooków, a nie samego powrotu klienta na stronę, i zabezpieczam żądania kluczem idempotentności. Inaczej klient zapłaci, a zamówienie zostanie nieopłacone, albo odwrotnie. Powtórzone zdarzenie nie może zamknąć zamówienia dwa razy.
Płatność, która się nie udała
Sprawdzam, co widzi klient i co dzieje się z zamówieniem, gdy bank odrzuci kartę albo zażąda dodatkowego uwierzytelnienia. Kroki kompensujące przy nieudanej płatności opisuję we wpisie o Medusa.js.
Kiedy tak, a kiedy nie
Stripe pasuje tam, gdzie płatność ma być gotowym procesem, a nie osobnym projektem, który trzeba pisać i utrzymywać.
Sprawdza się, gdy
- Sklep własny albo marketplace, który przyjmuje płatności online od klientów w kilku metodach płatności.
- Aplikacja z subskrypcjami, w której płatności cykliczne mają prowadzić do faktur i statusów.
- Zespół, który woli gotowy proces płatności od własnego formularza karty.
- Projekt, w którym stan zamówienia ma wynikać ze zdarzeń, a nie z przekierowań.
Nie sprawdza się, gdy
- Sprzedaż, w której klienci płacą wyłącznie przelewem tradycyjnym albo przy odbiorze.
- Firma, która musi użyć operatora płatności narzuconego przez bank albo kontrahenta, i nie da się tego zmienić.
- Projekt bez osoby, która zajmie się zwrotami i sporami po stronie biznesowej.
Gdy ważny jest polski operator, na przykład Przelewy24, sprawdzam go obok Stripe i porównuję oba pod kątem metod płatności, które chcą Twoi klienci.
Często zadawane pytania
Planujesz sklep albo aplikację z płatnościami online?
Napisz, co sprzedajesz, jak klient ma płacić i gdzie dziś trafiają zamówienia. Powiem, czy wystarczy strona płatności Stripe, czy potrzebna jest własna logika zamówień i subskrypcji.