Co otrzymujesz w ramach jednego połączenia
Zamiast integrować odrębny system operatora opłat drogowych dla każdego kraju, wystarczy jedna integracja, by uzyskać dostęp do oficjalnych produktów winietowych dla samochodów osobowych, dostawczych i motocykli w Austrii, Szwajcarii, Słowenii, na Węgrzech, w Słowacji, Czechach, Rumunii, Bułgarii i Mołdawii, a także do alpejskich opłat odcinkowych w Austrii (Brenner, Tauern, Katschberg, Karawanki, Arlberg, Gleinalm i Bosruck), które znajdują się poza zwykłą winietą.
Każdy produkt pochodzi bezpośrednio od krajowego dostawcy, a nie od cichej marży doliczanej przez pośrednika: katalog zwraca cenę urzędową oraz Twoją opłatę jako osobne pola, więc to, co pokazujesz klientowi, i to, co zatrzymujesz, nigdy nie jest tajemnicą.
Trzy sposoby integracji
Wybierz sposób integracji odpowiadający temu, ile kontroli potrzebujesz i ile czasu programistów możesz na to przeznaczyć.
- REST API: pełna kontrola nad katalogiem, checkoutem i cyklem życia zamówienia we własnym produkcie i walucie. Odpowiednie dla zespołów programistycznych budujących własny checkout, przebieg rezerwacji lub automatyzację backendową.
- Checkout w iframe lub jako osadzalny widżet: hostowany checkout wstawiany na Twoją stronę lub do aplikacji, z przekierowaniem z powrotem do Ciebie po sukcesie lub błędzie. Odpowiedni dla zespołów, które chcą szybko uzyskać działający przebieg zakupu bez samodzielnej obsługi logiki płatności.
- Panel partnera: pulpit do ręcznego tworzenia i zarządzania zamówieniami, bez konieczności programowania. Odpowiedni dla agentów i brokerów sprzedających sprawa po sprawie, a jednocześnie miejsce, w którym każdy partner testuje i monitoruje zamówienia, niezależnie od wybranej integracji.
Co faktycznie robi API
Obejmuje cały cykl życia zamówienia, a nie tylko listę produktów: umożliwia zapytanie o aktualny katalog według kraju, typu produktu, typu pojazdu i waluty, sprawdzenie przed wyświetleniem checkoutu, czy dany kraj lub okres są dostępne, walidację pojazdu przed płatnością oraz walidację całego zamówienia przed jego zatwierdzeniem.
Zamówienia złożone przez API oraz zamówienia utworzone już wcześniej w Twoim własnym systemie mogą być odzwierciedlone w Vignette ID, te drugie jako zamówienia zewnętrzne, dzięki czemu Twoje rejestry i strona dostawcy pozostają zsynchronizowane. Zamówienia można modyfikować, zamówienia oczekujące lub odroczone można anulować, a jeden przebieg może łączyć różne kraje i typy pojazdów.
Ceny i Twoja prowizja
Endpoint z produktami zwraca dla każdej pozycji trzy wartości: cenę urzędową ustaloną przez krajowego dostawcę, Twoją opłatę partnerską oraz cenę całkowitą płaconą przez klienta końcowego, która już uwzględnia Twoją opłatę. Taki podział pokazuje Twoją marżę w rozbiciu na produkt, kraj i typ pojazdu, zamiast zmuszać Cię do wyliczania jej z jednej, zsumowanej kwoty.
Ceny można pobierać we własnej walucie, w tym w EUR, UAH, USD, PLN i HUF, a także w innych.
Zasady prowizji, warunki podziału przychodów oraz ewentualny depozyt są określane w umowie o współpracy sporządzanej dla Twojego konta po rejestracji; te wartości zależą od Twojego modelu płatności i wolumenu, dlatego znajdują się w tej umowie, a nie w materiałach marketingowych.
Pierwsze kroki
Zarejestruj się przez formularz partnera, aby otrzymać osobne klucze API dla środowiska sandbox i produkcyjnego. Zaloguj się do panelu partnera, aby zaprosić programistów, skonfigurować webhook oraz adresy URL przekierowań, a także skorzystać z kalkulatora przychodów, który przygotowuje projekt umowy o współpracy na podstawie wybranego przez Ciebie modelu płatności.
Buduj i testuj wszystko najpierw wyłącznie w środowisku sandbox: twórz zamówienia, wyzwalaj zdarzenia webhook oraz testuj anulowania i modyfikacje bez dotykania rzeczywistych płatności ani rzeczywistych systemów rządowych. Dane produkcyjne aktywują się po podpisaniu umowy. Dostępna jest też rozmowa integracyjna z zespołem, jeśli chcesz najpierw omówić konfigurację API lub iframe.
Szczegóły operacyjne, które warto znać przed integracją
Endpoint katalogu produktów ma limit zapytań na partnera na minutę, z większym zapasem w miarę wzrostu wolumenu; warto buforować dane katalogu zamiast odpytywać go przy każdym checkoutcie i preferować webhooki zamiast wielokrotnego sprawdzania statusu zamówienia.
Niektóre produkty mają warunki, które checkout musi obsłużyć: w niektórych krajach data rozpoczęcia jest możliwa dopiero od jutra, a nie od dziś, a niektóre wymagają numeru VIN lub dodatkowych danych kierowcy, zanim zamówienie będzie mogło zostać utworzone. Walidacja pojazdu i sprawdzenie ograniczeń produktu przed checkoutem pozwala uniknąć nieudanych zamówień w momencie płatności.
Zamówienia przechodzą przez określony cykl życia, od utworzenia do aktywnej, gotowej do użycia winiety, z odrębnymi stanami dla zamówień oczekujących na odpowiedź dostawcy, zamówień odroczonych do przyszłej daty rozpoczęcia oraz zamówień zakończonych anulowaniem lub zwrotem. Skonfiguruj webhook, aby Twój system aktualizował się automatycznie przy każdej zmianie statusu.
Dla kogo jest to rozwiązanie
Biura podróży i touroperatorzy dodający opłaty drogowe do istniejącego przebiegu rezerwacji. Brokerzy ubezpieczeniowi łączący winietę z polisą. Aplikacje flotowe i mobilnościowe obejmujące pojazdy przekraczające granice wielu krajów. Wypożyczalnie samochodów obejmujące klienta na okres wynajmu. Deweloperzy i integratorzy systemów, którzy oczekują udokumentowanego API i środowiska sandbox zamiast procesu ręcznego.
