Kaj dobite z eno povezavo
Namesto da bi za vsako državo integrirali ločenega cestninskega izvajalca, se povežete enkrat in dobite dostop do uradnih vinjetnih izdelkov za osebne avtomobile, kombije in motocikle v Avstriji, Švici, Sloveniji, na Madžarskem, Slovaškem, Češkem, v Romuniji, Bolgariji in Moldaviji, poleg tega pa še do avstrijskih alpskih odsečnih cestnin (Brenner, Tauern, Katschberg, Karavanke, Arlberg, Gleinalm in Bosruck), ki so zunaj navadne vinjete.
Vsak izdelek prihaja neposredno od nacionalnega izvajalca in ne od tihega pribitka tretje strani: katalog vrne državno ceno in vašo provizijo kot ločeni polji, zato nikoli ni skrivnost, kaj pokažete stranki in koliko obdržite vi.
Trije načini integracije
Izberite integracijo, ki ustreza temu, koliko nadzora potrebujete in koliko razvojnega časa imate na voljo.
- REST API: popoln nadzor nad katalogom, blagajno in življenjskim ciklom naročila znotraj lastnega izdelka in valute. Primeren za razvijalce, ki gradijo lastno blagajno, rezervacijski postopek ali avtomatizacijo v zalednem sistemu.
- Blagajna prek iframa ali vdelanega pripomočka: gostovana blagajna, vstavljena v vašo stran ali aplikacijo, z ob uspehu ali neuspehu preusmeritvijo nazaj k vam. Primerna za ekipe, ki želijo hitro delujoč nakupni postopek brez lastne plačilne logike.
- Partnerska plošča: nadzorna plošča za ročno ustvarjanje in upravljanje naročil, brez potrebne kode. Primerna za agente in posrednike, ki prodajajo od primera do primera, hkrati pa je mesto, kjer vsak partner ne glede na integracijo preizkuša in spremlja naročila.
Kaj API dejansko počne
Pokriva celoten življenjski cikel naročila, ne le seznama izdelkov: poizvedujte po živem katalogu glede na državo, vrsto izdelka, vrsto vozila in valuto, pred prikazom blagajne preverite, ali je država ali obdobje na voljo, pred plačilom preverite vozilo in pred potrditvijo preverite celotno naročilo.
Tako naročila, oddana prek API-ja, kot naročila, ki so že ustvarjena v vašem lastnem sistemu, se lahko odražajo v Vignette ID, slednja kot zunanja naročila, tako da so vaši zapisi in stran izvajalca vedno usklajeni. Naročila je mogoče spreminjati, čakajoča ali odložena naročila preklicati, en sam postopek pa lahko združuje več držav in vrst vozil.
Cene in vaša provizija
Končna točka za izdelke za vsak artikel vrne tri zneske: državno ceno, ki jo določi nacionalni izvajalec, vašo partnersko provizijo in skupno ceno, ki jo plača končna stranka in v kateri je vaša provizija že vključena. Ta ločitev prikaže vašo maržo po izdelku, državi in vrsti vozila, namesto da bi jo morali izračunavati iz enega združenega zneska.
Cene lahko zahtevate v svoji valuti, med drugim v EUR, UAH, USD, PLN in HUF.
Mehanika provizije, pogoji delitve prihodkov in morebiten depozit so določeni v sporazumu o sodelovanju, pripravljenem za vaš račun po registraciji; ti zneski so odvisni od vašega plačilnega modela in obsega, zato sodijo v ta sporazum in ne v trženjsko besedilo.
Kako začeti
Registrirajte se prek partnerskega obrazca, da prejmete ločene ključe API za testno okolje in produkcijo. Prijavite se v partnersko ploščo, da povabite razvijalce, nastavite webhook in preusmeritvene naslove URL ter dostopate do kalkulatorja prihodkov, ki pripravi osnutek sporazuma o sodelovanju glede na izbrani plačilni model.
Najprej gradite in testirajte izključno na testnem strežniku: ustvarjajte naročila, sprožajte dogodke webhook ter preizkušajte preklice in spremembe, ne da bi se dotaknili resničnih plačil ali resničnih državnih sistemov. Produkcijske poverilnice se aktivirajo po podpisu sporazuma. Če želite pred tem skupaj pregledati nastavitev API-ja ali iframa, je na voljo integracijski klic z ekipo.
Operativne podrobnosti, ki jih velja poznati pred integracijo
Končna točka za katalog izdelkov ima na partnerja omejeno število zahtevkov na minuto, ki se z rastjo vašega obsega poveča; podatke kataloga shranjujte v predpomnilnik, namesto da jih poizvedujete ob vsaki blagajni, in za status naročila raje uporabite webhook kot ponavljajoče poizvedovanje.
Nekateri izdelki imajo pogoje, ki jih mora blagajna obravnavati: nekatere države dovolijo datum začetka šele od jutri in ne od danes, nekatere pa pred ustvarjanjem naročila zahtevajo identifikacijsko številko vozila (VIN) ali dodatne podatke o vozniku. Preverjanje vozila in branje omejitev izdelka pred blagajno preprečita neuspela naročila ob plačilu.
Naročila potekajo skozi določen življenjski cikel od ustvarjanja do aktivne, uporabne vinjete, z ločenimi stanji za naročila, ki čakajo na odziv izvajalca, naročila, odložena na prihodnji datum začetka, in naročila, ki se končajo s preklicem ali vračilom. Nastavite webhook, da se vaš sistem samodejno posodobi ob vsaki spremembi stanja.
Za koga je to namenjeno
Potovalne agencije in organizatorji potovanj, ki cestnine dodajajo obstoječemu postopku rezervacije. Zavarovalniški posredniki, ki vinjeto združijo s polico. Aplikacije za vozne parke in mobilnost, ki krijejo vozila na poti čez več držav. Avtomobilske izposojevalnice, ki stranko krijejo za čas najema. Razvijalci in sistemski integratorji, ki namesto ročnega postopka želijo dokumentiran API in testno okolje.
