Što dobivate jednom vezom
Umjesto integracije zasebnog tijela za cestarinu za svaku zemlju, povezujete se jednom i dobivate pristup službenim vinjetnim proizvodima za osobne automobile, kombije i motocikle u Austriji, Švicarskoj, Sloveniji, Mađarskoj, Slovačkoj, Češkoj, Rumunjskoj, Bugarskoj i Moldaviji, kao i austrijskim alpskim dioničkim cestarinama (Brenner, Tauern, Katschberg, Karawanken, Arlberg, Gleinalm i Bosruck) koje su izvan uobičajene vinjete.
Svaki proizvod dolazi izravno od nacionalnog izvoditelja, a ne od nečujno dodane marže treće strane: katalog vraća državnu cijenu i vašu proviziju kao zasebna polja, pa nikad nije upitno što prikazujete kupcu i koliko zadržavate vi.
Tri načina integracije
Odaberite integraciju koja odgovara koliko vam je nadzora potrebno i koliko vremena za razvoj imate na raspolaganju.
- REST API: potpun nadzor nad katalogom, blagajnom i životnim ciklusom narudžbe unutar vlastitog proizvoda i valute. Pogodno za razvojne programere koji grade vlastitu blagajnu, tijek rezervacije ili automatizaciju u pozadinskom sustavu.
- Blagajna putem iframea ili ugradbenog widgeta: hostirana blagajna umetnuta u vašu stranicu ili aplikaciju, s preusmjeravanjem natrag k vama nakon uspjeha ili neuspjeha. Pogodno za timove koji žele brzo dobiti funkcionalan tijek kupnje bez vlastite logike plaćanja.
- Partnerska ploča: nadzorna ploča za ručno stvaranje i upravljanje narudžbama, bez potrebnog koda. Pogodno za agente i brokere koji prodaju od slučaja do slučaja, a ujedno je i mjesto na kojem svaki partner, bez obzira na integraciju, testira i prati narudžbe.
Što API zapravo radi
Obuhvaća cijeli životni ciklus narudžbe, ne samo popis proizvoda: pretražujte živi katalog po zemlji, vrsti proizvoda, vrsti vozila i valuti, provjerite je li određena zemlja ili razdoblje dostupno prije prikaza blagajne, provjerite vozilo prije plaćanja i provjerite cijelu narudžbu prije njezine potvrde.
Narudžbe podnesene putem API-ja i narudžbe već stvorene u vašem vlastitom sustavu mogu se odraziti u Vignette ID-u, potonje kao vanjske narudžbe, čime se vaša evidencija i strana izvoditelja drže usklađenima. Narudžbe je moguće mijenjati, čekajuće ili odgođene narudžbe otkazati, a jedan tijek može objediniti više zemalja i vrsta vozila.
Cijene i vaša provizija
Krajnja točka za proizvode za svaku stavku vraća tri iznosa: državnu cijenu koju određuje nacionalni izvoditelj, vašu partnersku proviziju i ukupnu cijenu koju plaća krajnji kupac, u kojoj je vaša provizija već uključena. Ta razdvojenost pokazuje vašu maržu po proizvodu, zemlji i vrsti vozila, umjesto da je morate obrnutim putem izračunavati iz jednog zbirnog iznosa.
Cijene se mogu zatražiti u vašoj vlastitoj valuti, uključujući, među ostalim, EUR, UAH, USD, PLN i HUF.
Mehanika provizije, uvjeti podjele prihoda i eventualni polog utvrđeni su u ugovoru o suradnji koji se za vaš račun izrađuje nakon registracije; ti iznosi ovise o vašem modelu plaćanja i obujmu poslovanja, pa pripadaju tom ugovoru, a ne marketinškim materijalima.
Kako početi
Registrirajte se putem partnerskog obrasca kako biste dobili zasebne API ključeve za testno okruženje i produkciju. Prijavite se u partnersku ploču kako biste pozvali razvojne programere, konfigurirali webhook i preusmjeravajuće URL adrese te pristupili kalkulatoru prihoda koji izrađuje nacrt ugovora o suradnji na temelju odabranog modela plaćanja.
Gradite i testirajte isključivo na testnom poslužitelju: stvarajte narudžbe, pokrećite webhook događaje te isprobavajte otkazivanja i izmjene bez ikakvog dodira sa stvarnim plaćanjima ili stvarnim državnim sustavima. Produkcijske vjerodajnice aktiviraju se nakon potpisivanja ugovora. Ako prije toga želite zajedno proći postavljanje API-ja ili iframea, dostupan je poziv s timom za integraciju.
Operativni detalji vrijedni poznavanja prije integracije
Krajnja točka za katalog proizvoda ograničena je brojem zahtjeva po partneru u minuti, s više prostora kako vaš obujam raste; podatke kataloga spremajte u predmemoriju umjesto da ih dohvaćate za svaku blagajnu, a za status narudžbe radije koristite webhook nego ponavljano dohvaćanje.
Neki proizvodi nose uvjete koje blagajna mora obraditi: pojedine zemlje dopuštaju datum početka tek od sutra, a ne od danas, a neke prije stvaranja narudžbe zahtijevaju VIN vozila ili dodatne podatke o vozaču. Provjera vozila i čitanje ograničenja proizvoda prije blagajne sprječavaju neuspjele narudžbe u trenutku plaćanja.
Narudžbe prolaze kroz određen životni ciklus od stvaranja do aktivne, upotrebljive vinjete, s posebnim stanjima za narudžbe koje čekaju odgovor izvoditelja, narudžbe odgođene na budući datum početka i narudžbe koje završavaju otkazivanjem ili povratom sredstava. Konfigurirajte webhook kako bi se vaš sustav automatski ažurirao pri svakoj promjeni statusa.
Kome je ovo namijenjeno
Putničkim agencijama i organizatorima putovanja koji cestarine dodaju postojećem tijeku rezervacije. Brokerima osiguranja koji vinjetu objedinjuju s policom. Aplikacijama za voznu flotu i mobilnost koje pokrivaju vozila na putu kroz više zemalja. Tvrtkama za najam vozila koje pokrivaju kupca za razdoblje najma. Razvojnim programerima i sistemskim integratorima koji umjesto ručnog postupka žele dokumentiran API i testno okruženje.
