Deweloperzy - przegląd

Sekcja Deweloperzy służy do integracji Zevio z własną aplikacją: REST API (oferty, płatności, subskrypcje, klienci, harmonogram), webhooki (powiadomienia o zdarzeniach), klucze API (uwierzytelnianie żądań) oraz opcjonalnie integracja Stripe. Dostęp mają administratorzy i właściciele organizacji; od planu Basic (na Free zobaczysz Sekcja niedostępna i przycisk Zobacz plany).

W menu rozwiń Deweloperzy. Linki: REST API, Webhooki, Stripe, Klucze API. W panelu znajdziesz dokumentację operacji z opisami i przykładami oraz listę operacji i parametrów. Do wywołań z zewnątrz potrzebujesz klucza API (utworzonego w Klucze API) - klucz jest powiązany z jedną organizacją. Członek zespołu (MEMBER) nie widzi sekcji Deweloperzy.

Sekcje

• REST API - w panelu otwierasz dokumentację operacji: lista operacji (oferty, płatności, subskrypcje, klienci, checkout, harmonogram itd.), dla każdej opis i przykłady. Do wywołań z zewnątrz potrzebujesz klucza API z sekcji Klucze API oraz wybranej organizacji.
• Webhooki - lista adresów URL; przycisk Dodaj. Po dodaniu wpisujesz URL - na ten adres Zevio wysyła zdarzenia (np. płatność zakończona, subskrypcja anulowana, zwrot, sesja checkout). Tajny klucz (secret) jest pokazany tylko raz - skopiuj i przechowuj bezpiecznie. Możesz edytować lub usunąć URL i przeglądać historię dostarczeń (sukces/błąd, liczba prób).
• Stripe - integracja Zevio Pay w Stripe Payment Element (szczegóły: Integracja Stripe).
• Klucze API - lista kluczy (nazwa, data utworzenia, ostatnie użycie), przycisk Utwórz klucz. Wartość klucza pokazywana tylko raz - skopiuj i zapisz; później widać tylko np. ostatnie znaki. Klucz służy do uwierzytelniania wywołań z Twojej aplikacji. W razie wycieku usuń klucz w panelu i utwórz nowy.

Quick Start (panel)

Deweloperzy → Quick Start (/dashboard/developers/integration-guide) - interaktywny przewodnik z linkami do operacji REST. Dostęp: plan Enterprise lub rola OWNER/ADMIN. Statyczna wersja: Quick Start integracji w stopce docs.

Plany i dostęp

Sekcja Deweloperzy od planu Basic (Free: Sekcja niedostępna). Quick Start w panelu od Enterprise. Rola MEMBER nie widzi Deweloperów.

Struktura menu Deweloperzy

• Quick Start - interaktywny przewodnik (Enterprise lub ADMIN/OWNER).
• REST API - dokumentacja operacji + sekcja Klucze API (#api-keys).
• Webhooki - rejestracja endpointów i katalog zdarzeń.
• Stripe - Zevio Pay / Connect Express (osobno od kart w Tpay).
• Klucze API - skrót przekierowujący do REST API #api-keys.

Host API i wersjonowanie

Wywołania: https://{host}/api/v1/... gdzie host zależy od Sandbox/Production. Nagłówek Authorization: Bearer {api_key}. Klucz jest scoped do jednej organizacji - nie używaj klucza org A do operacji na org B.

Typowe integracje

• Sklep e-commerce - sesja checkout (iframe) + webhook payment.succeeded.
• CRM - metadane oferty + webhooki + REST customers.
• Subskrypcje SaaS - oferty recurring BLIK A + portal klienta.
• Partner - osobne Partner REST API (portfel), nie mylić z kluczem merchant.

Blokada planu Free

Plan Free → wejście w Deweloperzy pokazuje Sekcja niedostępna i CTA Zobacz plany. Od Basic: REST API i klucze. Od Premium: webhooki (API; UI webhooków może wymagać Enterprise - sprawdź aktualny panel).

Bezpieczeństwo

• Klucz pokazywany tylko raz przy tworzeniu - zapisz w vault.
• Rotacja: utwórz nowy, podmień w integracji, revoke stary.
• Webhook secret - weryfikuj podpis HMAC w każdym handlerze.
• Nigdy nie commituj kluczy do repo.