Co získáte jedním propojením
Místo napojování samostatného mýtného úřadu pro každou zemi se připojíte jednou a získáte přístup k oficiálním produktům dálničních známek pro osobní auta, dodávky a motocykly napříč Rakouskem, Švýcarskem, Slovinskem, Maďarskem, Slovenskem, Českem, Rumunskem, Bulharskem a Moldavskem, a navíc k rakouskému alpskému sekčnímu mýtnému (Brenner, Tauern, Katschberg, Karawanken, Arlberg, Gleinalm a Bosruck), které stojí mimo běžnou dálniční známku.
Každý produkt pochází od národního poskytovatele, ne od tiše přidané přirážky třetí strany: katalog vrací státní cenu a váš poplatek jako oddělená pole, takže co ukazujete zákazníkovi a co si necháváte, není nikdy záhadou.
Tři způsoby integrace
Vyberte si integraci, která odpovídá tomu, kolik kontroly potřebujete a kolik máte vývojářského času.
- REST API: plná kontrola nad katalogem, checkoutem a životním cyklem objednávky ve vlastním produktu a měně. Vhodné pro vývojáře, kteří stavějí vlastní checkout, rezervační proces nebo backendovou automatizaci.
- Iframe nebo vložitelný widget checkout: hostovaný checkout vložený do vaší stránky nebo aplikace, s přesměrováním zpět k vám při úspěchu i neúspěchu. Vhodné pro týmy, které chtějí funkční nákupní proces rychle bez vlastní platební logiky.
- Partnerský panel: dashboard pro ruční vytváření a správu objednávek bez nutnosti programovat. Vhodné pro agenty a makléře prodávající případ od případu, a zároveň místo, kde každý partner bez ohledu na typ integrace testuje a sleduje objednávky.
Co API skutečně dělá
Pokrývá celý životní cyklus objednávky, ne jen seznam produktů: dotazujte se na živý katalog podle země, typu produktu, typu vozidla a měny, ověřte, zda je země nebo období k dispozici ještě před zobrazením checkoutu, ověřte vozidlo před platbou a ověřte celou objednávku před jejím potvrzením.
Objednávky vytvořené přes API i objednávky již existující ve vašem vlastním systému mohou být obě promítnuty do Vignette ID, ty druhé jako externí objednávky, čímž se vaše záznamy a strana poskytovatele udržují synchronizované. Objednávky lze upravovat, čekající nebo odložené objednávky lze zrušit a jeden proces může kombinovat více zemí a typů vozidel.
Ceny a vaše provize
Koncový bod s produkty vrací pro každou položku tři čísla: státní cenu stanovenou národním poskytovatelem, vaši partnerskou provizi a celkovou cenu, kterou platí koncový zákazník, již se zahrnutou vaší provizí. Toto rozdělení ukazuje vaši marži za produkt, zemi i typ vozidla, místo abyste ji museli zpětně dopočítávat z jednoho sloučeného čísla.
Ceny lze vyžádat ve vlastní měně, včetně EUR, UAH, USD, PLN a HUF a dalších.
Mechanika provizí, podmínky sdílení příjmů a případná záloha jsou stanoveny ve smlouvě o spolupráci vypracované pro váš účet po registraci; tyto částky závisí na vašem platebním modelu a objemu, proto patří do této smlouvy, a ne do marketingových materiálů.
Jak začít
Zaregistrujte se přes partnerský formulář a získáte samostatné sandboxové a produkční API klíče. Přihlaste se do partnerského panelu, kde můžete pozvat vývojáře, nastavit webhook a přesměrovací adresy a využít kalkulačku příjmů, která na základě zvoleného platebního modelu připraví návrh smlouvy o spolupráci.
Nejprve vše postavte a otestujte výhradně proti sandboxovému hostiteli: vytvářejte objednávky, spouštějte webhookové události a vyzkoušejte zrušení i úpravy, aniž byste se dotkli skutečných plateb nebo skutečných státních systémů. Produkční přístupové údaje se aktivují po podpisu smlouvy. Pokud chcete API nebo nastavení iframe nejprve projít s někým, je k dispozici integrační hovor s týmem.
Provozní podrobnosti, které se hodí znát před integrací
Koncový bod katalogu produktů má omezenou rychlost dotazů na partnera a minutu, s větší rezervou podle toho, jak roste váš objem; data katalogu spíše ukládejte do mezipaměti, než abyste je dotazovali při každém checkoutu, a upřednostněte webhooky před opakovaným dotazováním na stav objednávky.
Některé produkty mají podmínky, které musí checkout zohlednit: některé země povolují datum začátku platnosti až od zítřka, ne od dneška, a některé vyžadují VIN nebo další údaje o řidiči, než lze objednávku vytvořit. Ověření vozidla a přečtení omezení produktu před checkoutem předchází neúspěšným objednávkám ve chvíli platby.
Objednávky procházejí definovaným životním cyklem od vytvoření až po aktivní, použitelnou dálniční známku, s odlišnými stavy pro objednávky čekající na odpověď poskytovatele, objednávky odložené na budoucí datum začátku a objednávky, které skončí zrušením nebo vrácením peněz. Nastavte webhook, aby se váš systém aktualizoval automaticky při každé změně stavu.
Pro koho je toto určeno
Cestovní kanceláře a touroperátoři přidávající silniční mýtné do stávajícího rezervačního procesu. Pojišťovací makléři nabízející dálniční známku spolu s pojistkou. Flotilové a mobilitní aplikace pokrývající vozidla přejíždějící více zemí. Půjčovny aut pokrývající zákazníka po dobu pronájmu. Vývojáři a systémoví integrátoři, kteří chtějí zdokumentované API a sandbox místo ručního procesu.
