Program partnerski Zevio

Program partnerski jest dla integratorów, agencji i resellerów, którzy onboardują i zarządzają organizacjami klientów w Zevio z poziomu dedykowanej organizacji partnerskiej. Ta strona opisuje pełny workflow partnera w panelu: portfel, oferty handlowe, zakładanie klientów i praca w kontekście organizacji klienta. Automatyzacja: Partner REST API.

Organizacja partnerska a organizacja klienta

Organizacja partnerska jest tworzona i konfigurowana przez administratorów Zevio. Nie przyjmuje płatności od klientów końcowych ani nie sprzedaje ofert na własnym koncie. Grupuje konta partnerów (e-maile zespołu) oraz organizacje, którymi zarządzasz dla klientów.

Każda organizacja klienta to zwykły workspace merchant w Zevio. Po Przełącz na organizację klient ma standardowy panel: Oferty, Subskrypcje i płatności, Klienci, Analityka, Plany, Deweloperzy, Ustawienia i reszta opisana w innych sekcjach dokumentacji. Limity planu (np. Grafik od Premium, Deweloperzy od Basic) dotyczą klienta, nie widoku partnera.

Jak konfigurowany jest dostęp

Administratorzy Zevio:

  • Tworzą organizację partnerską i dodają konta partnerów (e-maile użytkowników). Wszystkie konta w tej samej organizacji partnerskiej widzą ten sam portfel.
  • Powiązują z organizacją partnerską oferty handlowe (prowizja i marża partnerska).
  • Przypisują istniejące organizacje klientów do organizacji partnerskiej albo pozwalają zakładać nowe z panelu.

Organizacja klienta może należeć tylko do jednego partnera. Nie otworzysz organizacji spoza portfela; zapisany link do nieprzypisanej organizacji pokazuje stronę błędu.

Logowanie i przełączanie kontekstu

Użytkownicy z kontem partnera logują się do Zevio i w nagłówku wybierają Partner w przełączniku platformy. To widok partnera z narzędziami portfela.

  • W Partner → Organizacje użyj Szczegóły lub kliknij wiersz, aby otworzyć organizację.
  • Użyj Przełącz na organizację (lista lub strona szczegółów) albo wybierz klienta w przełączniku platformy, aby pracować w jego panelu.
  • Wybierz ponownie Partner w przełączniku, aby wrócić do zarządzania portfelem.

Po przełączeniu na organizację klienta masz dostęp jak administrator organizacji: pełne menu merchant i akcje, ale nie jesteś właścicielem organizacji. Właścicielem pozostaje e-mail podany przy tworzeniu lub istniejący właściciel przypisany przez Zevio.

Oferty handlowe, prowizja i marża partnerska

Warunki cenowe klientów pod partnerem określają oferty powiązane z organizacją partnerską (konfiguruje je Zevio). Każda oferta ustawia:

  • Prowizję - co klient płaci od udanych płatności (BLIK, BLIK cykliczny, karta).
  • Marżę partnerską - Twój udział od tych samych udanych płatności.

Na karcie Szczegóły oferty widać stawki: Prowizja BLIK, Prowizja BLIK cykliczny, Prowizja karta oraz - dla ofert z katalogu partnera - Marża partnerska BLIK, Marża partnerska BLIK cykliczny, Marża partnerska karta. Zmiana wybranej oferty aktualizuje podgląd przed zapisem.

Możesz przypisać tylko oferty powiązane z organizacją partnerską. Użyj Wybierz ofertę i Zapisz na stronie szczegółów albo automatyzacji w Partner REST API.

Gdy do organizacji partnerskiej nie ma jeszcze ofert, sekcja oferty pokazuje Brak ofert przypisanych do organizacji partnerskiej i nie zmienisz warunków handlowych, dopóki Zevio nie skonfiguruje ofert.

W Statystykach portfela jest Marża partnerska (suma dla klienta). W Płatnościach wewnątrz organizacji klienta udane płatności mogą na stronie szczegółów pokazywać Marżę partnera (kwota i stawka), gdy dotyczy. Zwroty aktualizują sumy spójnie.

Menu panelu partnera

W widoku Partner pasek boczny ogranicza się do portfela:

  • Organizacje - lista i szczegóły klientów, utworzenie organizacji, przełączenie na klienta.
  • Partner REST API - klucze API organizacji partnerskiej i interaktywna dokumentacja (osobno od Deweloperzy → REST API każdego klienta).

Sekcje merchant (Oferty, płatności, Analityka itd.) pojawiają się po Przełącz na organizację na klienta.

Lista organizacji

Partner → Organizacje otwiera tabelę portfela.

Kolumny i sortowanie

  • Nazwa (link do szczegółów; klik w wiersz otwiera szczegóły).
  • E-mail właściciela.
  • Plan (FREE, BASIC, PREMIUM, ENTERPRISE).
  • Środowisko (organizacja testowa Sandbox vs Production).
  • Utworzono (sortowalne).

Wyszukiwanie, filtry i paginacja

Pole wyszukiwania: nazwa, ID organizacji, NIP, miasto, kraj lub e-mail właściciela. Filtry: plan (Wszystkie lub konkretny plan). Tabela ma paginację z licznikiem (np. „12 organizacji łącznie”) i rozmiarem strony. Sortowanie po nazwie lub dacie utworzenia.

Akcje

  • Utwórz organizację (góra po prawej) - wieloetapowy onboarding nowego klienta.
  • Szczegóły - strona organizacji.
  • Przełącz na organizację - panel klienta (Home i pełne menu merchant).

Pusty portfel: Brak przypisanych organizacji.

Szczegóły organizacji

Tytuł strony: Szczegóły organizacji. Akcje u góry: Wróć do listy, Przełącz na organizację.

Dane organizacji

Karta informacyjna: Nazwa, ID organizacji, E-mail właściciela, Plan, Środowisko, NIP, Miasto.

Statystyki

Karta Statystyki (nad szczegółami oferty): Płatności, Udane płatności, Przychód, Marża partnerska, Aktywne subskrypcje, Oferty QR, Członkowie, Ostatnia płatność (data i godzina lub „-”).

Szczegóły oferty

Karta Szczegóły oferty: rozwijane Wybierz ofertę, podgląd stawek, Zapisz po zmianie wyboru. Po zapisie: komunikat Oferta zaktualizowana.

Tworzenie organizacji klienta

Kliknij Utwórz organizację na stronie portfela. Wprowadzenie: Utwórz nową organizację. Wskazany e-mail właściciela staje się właścicielem organizacji, a Ty zarządzasz nią bez roli właściciela.

Formularz (dane organizacji)

  • E-mail właściciela (wymagany) - przyszły właściciel; rola owner lub zaproszenie oczekujące, jeśli nie ma konta Zevio.
  • NIP z opcjonalnym Pobierz dane firmy (Polska) lub checkbox Brak NIP.
  • Nazwa organizacji, Osoba kontaktowa, Telefon kontaktowy (wymagane).
  • Adres, kod pocztowy, miasto, kraj, strefa czasowa - gdy widoczne w formularzu.
  • Zgoda na rejestrację u dostawcy płatności (wymagany checkbox).

Po utworzeniu

Nowe organizacje startują w Sandbox. Krótko lądujesz w kontekście klienta na ekranie potwierdzenia. Mogą pojawić się karty aktywacji dostawców płatności (Tpay, Stripe, AutoPay) - jak przy standardowym onboardingu organizacji. Kliknij Zakończ, aby wrócić do Partner → Organizacje (widok partnera). Nowy klient pojawi się na liście portfela.

Przypisz ofertę handlową ze strony szczegółów, gdy oferty są dostępne. Dokończ onboarding Production w organizacji klienta, gdy ma przyjmować płatności na żywo (ustawienia organizacji, dostawcy płatności). Szczegóły: Środowiska.

Typowy workflow partnera

  • 1. Otwórz Partner → Organizacje i przejrzyj portfel (plan, środowisko, właściciel).
  • 2. Utwórz organizację albo poczekaj na przypisanie istniejącego klienta przez Zevio.
  • 3. Otwórz Szczegóły, przypisz właściwą ofertę; sprawdź Statystyki i Marżę partnerską.
  • 4. Przełącz na organizację - branding, dostawcy płatności, Oferty, Deweloperzy dla klienta.
  • 5. Właściciel klienta kończy zaproszenia i kroki produkcyjne; Ty monitorujesz statystyki ze szczegółów partnera lub z panelu klienta.
  • 6. Opcjonalnie automatyzuj listowanie, tworzenie i zmianę ofert przez Partner REST API.

Partner REST API (przegląd)

W Partner REST API zarządzasz kluczami API organizacji partnerskiej (utwórz, unieważnij, kopiuj) i przeglądasz interaktywną dokumentację operacji na portfelu: lista i podgląd organizacji, tworzenie organizacji, lista ofert do przypisania, zmiana oferty klienta.

Klucze partnera służą tylko portfelowi. Nie zastępują kluczy Deweloperzy klienta do płatności, webhooków ani ofert. Pełne parametry i przykłady: strona Partner REST API w tej sekcji.

Aby integrować płatności klienta: Przełącz na organizację, potem Deweloperzy (Quick Start, REST API, Webhooki, klucze API) w kontekście tej organizacji - albo niech właściciel klienta sam zarządza sekcją Deweloperzy.

Sandbox i Production

W kontekście klienta używaj przełącznika środowiska w nagłówku (Sandbox / Production) - dane i klucze są rozdzielone. Kolumna Środowisko na liście portfela pokazuje typ klienta. Nowi klienci z Utwórz organizację startują w Sandbox. Zobacz Środowiska i Przełączanie środowisk.

Czego partner nie może zrobić

  • Przeglądać ani zarządzać organizacjami nieprzypisanymi do organizacji partnerskiej.
  • Przypisywać ofert niepowiązanych z organizacją partnerską.
  • Przyjmować płatności końcowych klientów przez samą organizację partnerską (to nie jest konto merchant).
  • Używać kluczy partnera do operacji płatniczych klienta ani kluczy klienta do zarządzania portfelem.
  • Zostać formalnym właścicielem organizacji klienta przez panel partnera (właścicielem jest wskazany e-mail właściciela).
  • Ominąć funkcje planu klienta po przełączeniu - limity Premium/Basic nadal obowiązują w tej organizacji.
Program partnerski Zevio | Zevio