Płatności

Stripe widoczny
w Medusie

Panel Stripe w panelu Medusy: obrót, opłaty i netto po metodach płatności, każda płatność obok swojego zamówienia, spory z terminami na odpowiedź, zwroty, saldo i wypłaty. Do tego kontrole zdrowia całej konfiguracji z poprawką do każdego problemu. Płatności dalej bierze oficjalny dostawca – ta wtyczka tylko czyta.

Zobacz w panelu demo

Stripe: Strona integracji w panelu Medusy, tryb demo z danymi pokazowymi. — Strona integracji w panelu Medusy, tryb demo z danymi pokazowymi.

Co dokładnie
robi ta integracja

Panel na 7 albo 30 dni

Obrót, opłaty Stripe i netto, skuteczność płatności, zwroty i otwarte spory, a pod spodem tabela po metodach: karty, BLIK, Przelewy24, Apple Pay i Google Pay.
Płatności obok zamówień

Każda płatność z metodą, statusem, powodem odmowy, ryzykiem Radar, opłatą i netto, z linkiem do zamówienia w Medusie i do panelu Stripe. Płatność, która nie stała się zamówieniem, świeci na czerwono.
Kontrole zdrowia z poprawką

Dostawca zarejestrowany, klucz, konto, metody płatności, webhook z dostawami z ostatniej doby, domeny Apple Pay i Google Pay, tryb przechwytywania – każdy sprawdzony, z werdyktem i instrukcją naprawy.
Spory z terminami

Otwarte spory z dniem na dowody, liczbą dni do końca i pilnością, połączone z zamówieniem i z panelem Stripe, gdzie się na nie odpowiada.
Widżet na zamówieniu

PaymentIntent za płatnością zamówienia: status, metoda, kwota, opłata i netto, kurs wymiany, ryzyko Radar, zwroty i spory. Po przechwyceniu albo zwrocie w Medusie wtyczka czyta Stripe jeszcze raz.
Tylko odczyt, z konstrukcji

Klient Stripe ma jedną metodę: GET na krótkiej liście ścieżek. Żadna ścieżka kodu nie może przechwycić, zwrócić ani wypłacić – te akcje zostają w akcjach zamówienia Medusy.

Jak pilnuje
Twoich danych

Klucz tylko do odczytu

Zalecany klucz z ograniczeniami (rk_live_…, Read albo None per zasób). Wtyczka używa go wyłącznie w nagłówku Authorization, maskuje w logach i panelu, a admin widzi tylko jego rodzaj i cztery ostatnie znaki.
Delikatna dla limitów Stripe

Czyta tylko, gdy ktoś otworzy stronę albo naciśnie Odśwież, nigdy w tle. Odczyt jest cache'owany, dziesięciu adminów naraz to jedno zapytanie, a cały odczyt ma budżet 25 sekund.
Pieniądze w liczbach całkowitych

Kwoty zostają w groszach, jak przysyła je Stripe; sumy to sumy całkowite per waluta, bez liczb zmiennoprzecinkowych, a dwóch walut nigdy się nie dodaje.
Bez klucza strona się nie wysypie

Brak klucza pokazuje konfigurację, zły klucz – niezaliczoną kontrolę. Wtyczka nigdy nie łamie startu sklepu.

Instalacja
w trzech krokach

Pełna lista opcji, zdarzeń i tras API jest w README paczki na GitHubie.

Wklej do Claude Code, Cursora albo innego asystenta AI w swoim projekcie Medusy: zainstaluje i skonfiguruje integrację, z zapisami wyłączonymi.

README

1
Zainstaluj paczkę z npm.
npm install @koda-plus/medusa-plugin-stripe

Dopisz wtyczkę do medusa-config.ts.

                        plugins: [
  {
    resolve: "@koda-plus/medusa-plugin-stripe",
    options: {
      apiKey: process.env.STRIPE_READ_KEY, // rk_live_..., Read or None per resource
      // demo: process.env.STRIPE_DEMO === "true", // sample data, no requests to Stripe
      // providerId: "stripe",                // the id of the official provider entry
      // backendUrl: "https://api.example.pl", // when the admin runs on another address
      // storefrontDomains: ["example.pl", "www.example.pl"],
      // cacheSeconds: 300,
    },
  },
]