Čo získate jedným pripojením
Namiesto napájania samostatného mýtneho úradu pre každú krajinu sa pripojíte raz a získate prístup k oficiálnym produktom diaľničných známok pre osobné autá, dodávky a motocykle naprieč Rakúskom, Švajčiarskom, Slovinskom, Maďarskom, Slovenskom, Českom, Rumunskom, Bulharskom a Moldavskom, a navyše k rakúskemu alpskému úsekovému mýtu (Brenner, Tauern, Katschberg, Karawanken, Arlberg, Gleinalm a Bosruck), ktoré stojí mimo bežnej diaľničnej známky.
Každý produkt pochádza od národného poskytovateľa, nie od ticho pridanej prirážky tretej strany: katalóg vracia štátnu cenu a váš poplatok ako oddelené polia, takže to, čo ukazujete zákazníkovi, a to, čo si necháte, nikdy nie je záhadou.
Tri spôsoby integrácie
Vyberte si integráciu, ktorá zodpovedá tomu, koľko kontroly potrebujete a koľko máte vývojárskeho času.
- REST API: plná kontrola nad katalógom, checkoutom a životným cyklom objednávky vo vlastnom produkte a mene. Vhodné pre vývojárov, ktorí stavajú vlastný checkout, rezervačný proces alebo backendovú automatizáciu.
- Iframe alebo vložiteľný widget checkout: hostovaný checkout vložený do vašej stránky alebo aplikácie, s presmerovaním späť k vám pri úspechu aj neúspechu. Vhodné pre tímy, ktoré chcú funkčný nákupný proces rýchlo bez vlastnej platobnej logiky.
- Partnerský panel: dashboard na ručné vytváranie a správu objednávok bez potreby programovať. Vhodné pre agentov a maklérov predávajúcich prípad od prípadu, a zároveň miesto, kde každý partner bez ohľadu na typ integrácie testuje a sleduje objednávky.
Čo API skutočne robí
Pokrýva celý životný cyklus objednávky, nielen zoznam produktov: dotazujte sa na živý katalóg podľa krajiny, typu produktu, typu vozidla a meny, overte, či je krajina alebo obdobie k dispozícii ešte pred zobrazením checkoutu, overte vozidlo pred platbou a overte celú objednávku pred jej potvrdením.
Objednávky vytvorené cez API aj objednávky už existujúce vo vašom vlastnom systéme môžu byť obe premietnuté do Vignette ID, tie druhé ako externé objednávky, čím sa vaše záznamy a strana poskytovateľa udržujú synchronizované. Objednávky je možné upravovať, čakajúce alebo odložené objednávky je možné zrušiť a jeden proces môže kombinovať viacero krajín a typov vozidiel.
Ceny a vaša provízia
Koncový bod s produktmi vracia pre každú položku tri čísla: štátnu cenu stanovenú národným poskytovateľom, vašu partnerskú províziu a celkovú cenu, ktorú platí koncový zákazník, už so zahrnutou vašou províziou. Toto rozdelenie ukazuje vašu maržu za produkt, krajinu aj typ vozidla, namiesto toho, aby ste ju museli spätne dopočítavať z jedného zlúčeného čísla.
Ceny je možné vyžiadať vo vlastnej mene, vrátane EUR, UAH, USD, PLN a HUF a ďalších.
Mechanika provízií, podmienky delenia príjmov a prípadná záloha sú stanovené v zmluve o spolupráci vypracovanej pre váš účet po registrácii; tieto sumy závisia od vášho platobného modelu a objemu, preto patria do tejto zmluvy, a nie do marketingových materiálov.
Ako začať
Zaregistrujte sa cez partnerský formulár a získate samostatné sandboxové a produkčné API kľúče. Prihláste sa do partnerského panela, kde môžete pozvať vývojárov, nastaviť webhook a presmerovacie adresy a využiť kalkulačku príjmov, ktorá na základe zvoleného platobného modelu pripraví návrh zmluvy o spolupráci.
Najprv všetko postavte a otestujte výhradne proti sandboxovému hostiteľovi: vytvárajte objednávky, spúšťajte webhookové udalosti a vyskúšajte zrušenia aj úpravy bez toho, aby ste sa dotkli skutočných platieb alebo skutočných štátnych systémov. Produkčné prístupové údaje sa aktivujú po podpise zmluvy. Ak si chcete API alebo nastavenie iframe najprv prejsť s niekým, k dispozícii je integračný hovor s tímom.
Prevádzkové detaily, ktoré sa oplatí poznať pred integráciou
Koncový bod katalógu produktov má obmedzenú rýchlosť dotazov na partnera a minútu, s väčšou rezervou podľa toho, ako rastie váš objem; dáta katalógu radšej ukladajte do medzipamäte, než aby ste sa na ne dotazovali pri každom checkoute, a uprednostnite webhooky pred opakovaným dotazovaním na stav objednávky.
Niektoré produkty majú podmienky, ktoré musí checkout zohľadniť: niektoré krajiny povoľujú dátum začiatku platnosti až od zajtra, nie od dnes, a niektoré vyžadujú VIN alebo ďalšie údaje o vodičovi, kým je možné objednávku vytvoriť. Overenie vozidla a prečítanie obmedzení produktu pred checkoutom predchádza neúspešným objednávkam vo chvíli platby.
Objednávky prechádzajú definovaným životným cyklom od vytvorenia až po aktívnu, použiteľnú diaľničnú známku, s odlišnými stavmi pre objednávky čakajúce na odpoveď poskytovateľa, objednávky odložené na budúci dátum začiatku a objednávky, ktoré skončia zrušením alebo vrátením peňazí. Nastavte webhook, aby sa váš systém aktualizoval automaticky pri každej zmene stavu.
Pre koho je toto určené
Cestovné kancelárie a touroperátori pridávajúci cestné mýto do existujúceho rezervačného procesu. Poisťovací makléri ponúkajúci diaľničnú známku spolu s poistkou. Flotilové a mobilné aplikácie pokrývajúce vozidlá prechádzajúce viacerými krajinami. Autopožičovne pokrývajúce zákazníka na dobu prenájmu. Vývojári a systémoví integrátori, ktorí chcú zdokumentované API a sandbox namiesto ručného procesu.
