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_xxxlubsk_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ę.