Šta dobijate jednom vezom
Umjesto integracije posebnog organa za naplatu putarine za svaku zemlju, povezujete se jednom i dobijate pristup zvaničnim proizvodima vinjeta za automobile, kombije i motocikle u Austriji, Švicarskoj, Sloveniji, Mađarskoj, Slovačkoj, Češkoj, Rumuniji, Bugarskoj i Moldaviji, plus austrijskim alpskim dioničkim putarinama (Brenner, Tauern, Katschberg, Karawanken, Arlberg, Gleinalm i Bosruck) koje stoje izvan obične vinjete.
Svaki proizvod dolazi od nacionalnog pružaoca usluge, a ne od tiho dodane marže treće strane: katalog vraća državnu cijenu i vašu naknadu kao odvojena polja, tako da nikada nije misterija šta pokazujete kupcu, a šta zadržavate.
Tri načina integracije
Odaberite integraciju koja odgovara tome koliko kontrole vam je potrebno i koliko vremena za razvoj imate.
- REST API: potpuna kontrola nad katalogom, checkoutom i životnim ciklusom narudžbe unutar vlastitog proizvoda i valute. Pogodno za programere koji grade vlastiti checkout, proces rezervacije ili automatizaciju u pozadinskom sistemu.
- Iframe ili ugradivi widget checkout: hostovani checkout ugrađen na vašu stranicu ili u aplikaciju, s preusmjeravanjem nazad kod uspjeha ili neuspjeha. Pogodno za timove koji žele funkcionalan proces kupovine brzo, bez vlastite logike plaćanja.
- Partnerski panel: kontrolna tabla za ručno kreiranje i upravljanje narudžbama, bez potrebe za kodiranjem. Pogodan za agente i brokere koji prodaju od slučaja do slučaja, a ujedno je i mjesto gdje svaki partner, bez obzira na integraciju, testira i prati narudžbe.
Šta API zapravo radi
Pokriva cijeli životni ciklus narudžbe, ne samo listu proizvoda: pretražite živi katalog po zemlji, tipu proizvoda, tipu vozila i valuti, provjerite da li je zemlja ili period dostupan prije prikazivanja checkouta, validirajte vozilo prije plaćanja i validirajte cijelu narudžbu prije njenog potvrđivanja.
Narudžbe napravljene putem API-ja i narudžbe već kreirane u vašem vlastitom sistemu mogu se obje odraziti u Vignette ID-u, ove druge kao eksterne narudžbe, čime se vaši zapisi i strana pružaoca usluge održavaju usklađenim. Narudžbe se mogu mijenjati, narudžbe na čekanju ili odgođene narudžbe mogu se otkazati, a jedan proces može kombinovati više zemalja i tipova vozila.
Cijene i vaša provizija
Endpoint za proizvode vraća tri broja za svaku stavku: državnu cijenu koju određuje nacionalni pružalac usluge, vašu partnersku naknadu, i ukupnu cijenu koju plaća krajnji kupac, s vašom naknadom već uključenom. Ta podjela pokazuje vašu maržu po proizvodu, po zemlji i po tipu vozila, umjesto da je morate obrnutim putem izračunavati iz jednog spojenog broja.
Cijene se mogu zatražiti u vašoj vlastitoj valuti, uključujući EUR, UAH, USD, PLN i HUF, između ostalih.
Mehanika provizije, uslovi podjele prihoda i eventualni depozit definisani su u ugovoru o saradnji sastavljenom za vaš račun nakon registracije; ti iznosi zavise od vašeg modela plaćanja i obima, pa pripadaju tom ugovoru, a ne marketinškim materijalima.
Kako početi
Registrujte se putem partnerskog obrasca kako biste dobili odvojene sandbox i produkcijske API ključeve. Prijavite se na partnerski panel kako biste pozvali programere, konfigurisali webhook i redirect URL-ove, i pristupili kalkulatoru prihoda koji priprema nacrt vašeg ugovora o saradnji na osnovu odabranog modela plaćanja.
Prvo sve izgradite i testirajte isključivo naspram sandbox hosta: kreirajte narudžbe, aktivirajte webhook događaje, i isprobajte otkazivanja i izmjene bez dodirivanja stvarnih plaćanja ili stvarnih državnih sistema. Produkcijski pristupni podaci se aktiviraju nakon potpisivanja ugovora. Poziv za integraciju s timom je dostupan ako prvo želite proći kroz postavljanje API-ja ili iframe-a.
Operativni detalji koje je dobro znati prije integracije
Endpoint kataloga proizvoda ima ograničenje broja upita po partneru po minuti, s više prostora kako vaš obim raste; keširajte podatke kataloga umjesto da ih dohvatate za svaki checkout, i dajte prednost webhookovima umjesto ponovljenog dohvatanja statusa narudžbe.
Neki proizvodi nose uslove koje checkout mora obraditi: određene zemlje dozvoljavaju datum početka tek od sutra, a ne od danas, a neke zahtijevaju VIN ili dodatne podatke o vozaču prije nego što se narudžba može kreirati. Validacija vozila i čitanje ograničenja proizvoda prije checkouta izbjegava neuspjele narudžbe u trenutku plaćanja.
Narudžbe prolaze kroz definisan životni ciklus od kreiranja do aktivne, upotrebljive vinjete, s odvojenim stanjima za narudžbe koje čekaju odgovor pružaoca usluge, narudžbe odgođene za budući datum početka, i narudžbe koje se završe otkazivanjem ili povratom sredstava. Konfigurišite webhook kako bi se vaš sistem automatski ažurirao pri svakoj promjeni statusa.
Kome je ovo namijenjeno
Turističke agencije i tour operateri koji dodaju putarine u postojeći proces rezervacije. Osiguravajući brokeri koji uz policu nude i vinjetu. Aplikacije za flote i mobilnost koje pokrivaju vozila koja prelaze više zemalja. Firme za iznajmljivanje vozila koje pokrivaju kupca za period iznajmljivanja. Programeri i sistemski integratori koji žele dokumentovan API i sandbox umjesto ručnog procesa.
