Integracja Stripe

Integracja Stripe dodaje Zevio Pay jako niestandardową metodę płatności w Stripe Payment Element na Twojej stronie. Klient wybiera Zevio Pay → przekierowanie do checkout Zevio (BLIK/karta) → po sukcesie płatność jest raportowana do Stripe Payment Records API. Sekcja Deweloperzy → Stripe (/dashboard/developers/stripe) wymaga planu z dostępem do Deweloperów i roli OWNER/ADMIN. Nie działa ze Stripe Checkout Sessions (hostowany checkout) - tylko Payment Element.

Lista integracji

Strona pokazuje utworzone integracje ze statusem (PENDING, ACTIVE). Przy braku integracji - przycisk Utwórz integrację. Po utworzeniu widzisz szczegóły: ID integracji, endpoint API, endpoint webhook, sekret webhook (skopiuj od razu - pokazywany jednorazowo).

Utwórz integrację - pola formularza

Modal Utwórz integrację (kolejność pól):

  • ID konta Stripe (wymagane) - format acct_xxx. ID konta z Stripe Dashboard.
  • Klucz tajny Stripe (wymagane) - format sk_live_xxx lub sk_test_xxx. Pole hasła; po zapisie nie da się odczytać ponownie z panelu.

Po zapisie integracja ma status PENDING - musisz skonfigurować niestandardową metodę płatności w Stripe i Podepnij płatność w panelu Zevio.

Krok w Stripe: niestandardowa metoda płatności

  • Stripe Dashboard → Ustawienia → Płatności → Niestandardowe metody płatności.
  • Utwórz typ (np. nazwa Zevio Pay) z logo Zevio.
  • Skopiuj ID typu niestandardowej metody płatności (cpmt_xxx).

Podepnij płatność - pole formularza

Przy integracji ze statusem PENDING: Podepnij płatność → pole ID typu niestandardowej metody płatności (cpmt_xxx, wymagane). Po sukcesie status zmienia się na ACTIVE - możesz przyjmować płatności przez Payment Element.

Endpoint API i webhooki

W szczegółach integracji skopiuj Endpoint API - używasz go z frontendu, gdy klient wybierze Zevio Pay (inicjacja płatności). Endpoint webhook i Sekret webhook służą do weryfikacji zdarzeń od Zevio (zmiana statusu płatności). Opcjonalnie w Stripe Dashboard dodaj webhook Stripe na ten sam endpoint Zevio dla zdarzeń payment_intent.succeeded, payment_intent.payment_failed, checkout.session.completed.

Metody płatności w żądaniu API

BLIK lub CARD oraz opcje cykliczne (frequency, blikModel A/M/O) przekazujesz w body każdego żądania inicjacji - nie są zapisywane na stałe w integracji. Szczegóły pól: dokumentacja REST API w panelu (Deweloperzy → REST API).

Usuwanie integracji

Usuń integrację - trwałe usunięcie; aktywne Payment Element przestanie inicjować nowe płatności przez tę integrację.

Integracja Stripe | Zevio