Olvassa el az API dokumentációt

Európai matricák értékesítése a saját termékén keresztül

Egyetlen API kilenc ország úthasználati díjaihoz, beépítve az alkalmazásába, weboldalába vagy háttérrendszerébe

Amit egyetlen kapcsolattal kap

Ahelyett, hogy országonként külön díjfizetési hatósággal kellene integrálódnia, egyszer csatlakozik, és elérheti a hivatalos matricatermékeket személyautókhoz, kishaszonjárművekhez és motorkerékpárokhoz Ausztriában, Svájcban, Szlovéniában, Magyarországon, Szlovákiában, Csehországban, Romániában, Bulgáriában és Moldovában, valamint Ausztria alpesi szakaszdíjait (Brenner, Tauern, Katschberg, Karawanken, Arlberg, Gleinalm és Bosruck), amelyek a rendes matricán kívül esnek.

Minden termék a nemzeti szolgáltatótól származik, nem egy csendben rárakott harmadik féltől eredő felárral: a katalógus külön mezőként adja vissza az állami árat és az Ön díját, így soha nem rejtély, hogy mit mutat az ügyfélnek, és mit tart meg.

Háromféle integrációs mód

Válassza azt az integrációt, amely megfelel az Ön által igényelt kontroll mértékének és a rendelkezésre álló fejlesztési időnek.

  • REST API: teljes kontroll a katalógus, a fizetés és a rendelés életciklusa felett a saját terméke és pénzneme keretein belül. Fejlesztőknek való, akik egyedi fizetési felületet, foglalási folyamatot vagy háttérrendszeri automatizálást építenek.
  • Iframe vagy beágyazható widget fizetési felület: egy hosztolt fizetési felület, amelyet az oldalára vagy alkalmazásába illeszt be, sikeres vagy sikertelen fizetés esetén az Önhöz visszairányító átirányítással. Olyan csapatoknak való, akik gyorsan szeretnének működő vásárlási folyamatot, saját fizetési logika kiépítése nélkül.
  • Partnerpanel: egy irányítópult a rendelések kézi létrehozásához és kezeléséhez, kód nélkül. Az eseti alapon értékesítő ügynököknek és alkuszoknak való, és minden partner számára ez az a hely is, ahol a rendeléseket tesztelik és nyomon követik, az integráció típusától függetlenül.

Mit csinál valójában az API

Nemcsak egy terméklistát fed le, hanem a teljes rendelési életciklust: lekérdezheti az élő katalógust ország, terméktípus, járműtípus és pénznem szerint, ellenőrizheti, hogy egy ország vagy időszak elérhető-e a fizetési felület megjelenítése előtt, ellenőrizheti a járművet a fizetés előtt, és ellenőrizheti a teljes rendelést, mielőtt véglegesítené.

Az API-n keresztül leadott rendelések és a saját rendszerében már létrehozott rendelések egyaránt megjeleníthetők a Vignette ID-ban, utóbbiak külső rendelésként, így az Ön nyilvántartása és a szolgáltatói oldal szinkronban marad. A rendelések módosíthatók, a függőben lévő vagy elhalasztott rendelések lemondhatók, és egyetlen folyamat is vegyíthet országokat és járműtípusokat.

Árazás és az Ön jutaléka

A termékvégpont minden tételhez három számot ad vissza: a nemzeti szolgáltató által meghatározott állami árat, az Ön partnerdíját, és a végfelhasználó által fizetett teljes árat, amelybe az Ön díja már be van építve. Ez a szétválasztás terméken, országon és járműtípuson belül is megmutatja a haszonkulcsát, ahelyett hogy egyetlen összevont számból kellene visszafejtenie.

Az árak a saját pénznemében is lekérdezhetők, többek között EUR, UAH, USD, PLN és HUF pénznemben.

A jutalékszámítás mechanizmusát, a bevételmegosztási feltételeket és bármilyen letétet a regisztráció után az Ön fiókjához elkészített együttműködési megállapodás rögzíti; ezek a számok az Ön fizetési modelljétől és forgalmától függenek, ezért ott van a helyük, nem a marketinganyagban.

Kezdő lépések

Regisztráljon a partneri űrlapon, hogy külön sandbox és éles API-kulcsokat kapjon. Jelentkezzen be a partnerpanelbe, hogy fejlesztőket hívjon meg, beállítsa a webhookját és az átirányítási URL-jeit, és elérje a bevételkalkulátort, amely az Ön által választott fizetési modell alapján megszerkeszti az együttműködési megállapodását.

Építsen és teszteljen mindent kizárólag a sandbox hoszt ellen: hozzon létre rendeléseket, indítson el webhook-eseményeket, és gyakoroljon lemondásokat és módosításokat valódi fizetések vagy valódi állami rendszerek érintése nélkül. Az éles hozzáférési adatok a megállapodás aláírásával aktiválódnak. Ha előbb szeretné átbeszélni az API vagy az iframe beállítását, egyeztetési hívás is elérhető a csapattal.

Üzemeltetési részletek, amelyeket érdemes tudni integráció előtt

A termékkatalógus végpontja partnerenként percenként korlátozott sebességű, egyre nagyobb mozgástérrel, ahogy a forgalma nő; érdemes gyorsítótárazni a katalógusadatokat ahelyett, hogy minden fizetéskor lekérdezné, és érdemes a webhookokat előnyben részesíteni egy rendelés állapotának ismételt lekérdezésével szemben.

Egyes termékeknek olyan feltételei vannak, amelyeket a fizetési folyamatnak kezelnie kell: bizonyos országok csak a holnapi napról engedélyeznek kezdő dátumot, nem a mai napról, és néhány megköveteli az alvázszámot (VIN) vagy további vezetői adatokat, mielőtt a rendelés létrehozható. A jármű ellenőrzése és egy termék korlátozásainak beolvasása a fizetés előtt elkerüli a sikertelen rendeléseket a fizetés pillanatában.

A rendelések egy meghatározott életciklusban haladnak a létrehozástól egy aktív, használható matricáig, külön állapotokkal a szolgáltató válaszára váró rendelésekhez, egy jövőbeli kezdő dátumra elhalasztott rendelésekhez, és a lemondással vagy visszatérítéssel záruló rendelésekhez. Állítson be egy webhookot, hogy a rendszere minden állapotváltozáskor automatikusan frissüljön.

Kiknek szól ez

Utazási irodáknak és utazásszervezőknek, akik úthasználati díjakat adnak egy meglévő foglalási folyamathoz. Biztosítási alkuszoknak, akik matricát csomagolnak egy kötvényhez. Flotta- és mobilitási alkalmazásoknak, amelyek több országon áthaladó járműveket fednek le. Autókölcsönző cégeknek, amelyek a bérlés időszakára fedezik az ügyfelet. Fejlesztőknek és rendszerintegrátoroknak, akik dokumentált API-t és sandboxot szeretnének egy kézi folyamat helyett.

Egyszerű, de erős API

API DocsRead docs

Partneri irányítópult

Partner DashboardPartner dashboard

Partneri és API kérdések

Van sandbox, amelyben tesztelhetek, mielőtt élesbe állnék?

Igen. A partnerként történő regisztráció külön sandbox és éles API-kulcsokat ad, és a sandbox a teljes rendelési folyamatot támogatja, beleértve a webhook-eseményeket, a lemondásokat és a módosításokat, valódi fizetések vagy valódi állami rendszerek érintése nélkül.

Mely országok és termékek érhetők el?

Ausztria, Svájc, Szlovénia, Magyarország, Szlovákia, Csehország, Románia, Bulgária és Moldova, matrica- és alagútdíj-termékekkel személyautókhoz, kishaszonjárművekhez és motorkerékpárokhoz, ideértve Ausztria alpesi szakaszdíjait is, amelyek a rendes matricán kívül esnek.

Értékesíthetek eurótól eltérő pénznemben?

Igen. A termékkatalógus a saját pénznemében is lekérdezhető, többek között EUR, UAH, USD, PLN és HUF pénznemben, az Ön jutalékával már beépítve a visszaadott teljes árba.

Saját fizetési felületet kell építenem, vagy van kész megoldás?

Mindkettő elérhető. Építhet teljesen egyedi fizetési felületet a REST API-ra, vagy használhatja az iframe vagy beágyazható widget fizetési felületet egy működő vásárlási folyamathoz, sikeres vagy sikertelen fizetés esetén Önhöz visszairányító átirányítással.

Kell-e egyáltalán kódot írnom?

Nem. A partnerpanel lehetővé teszi a rendelések kézi létrehozását és kezelését fejlesztés nélkül, ami az eseti alapon értékesítő alkuszoknak és ügynököknek felel meg. Bármely partner, függetlenül attól, milyen integrációt használ, a panelt is használhatja rendelések nyomon követésére és tesztelésére.

Hogyan működik egy rendelés lemondása vagy módosítása?

Egy rendelés a létrehozás után módosítható, a függőben lévő vagy elhalasztott rendelések pedig lemondhatók az API-n vagy a partnerpanelen keresztül. Az, hogy egy már teljesített, aktív matrica lemondható-e, az adott ország és termék nemzeti szolgáltatójának saját szabályaitól függ.

Milyen adatokra van szükségem egy rendelés leadásához?

Minimálisan a termékre, az országra, a járműtípusra és a rendszámra, amelyet előzetesen a jármű-ellenőrző végponton keresztül ellenőriznek. Egyes országok emellett alvázszámot (VIN) vagy vezetői adatokat is megkövetelnek, és néhány csak a holnapi napról engedélyez kezdő dátumot, nem a mai napról, amit a termékadatok a fizetés előtt jeleznek.

Ki az API mögötti szerződő fél?

A Vignette ID partneri API-ját és együttműködési megállapodásait a PD Business Services FZ LLC üzemelteti, amelynek székhelye Abu Dzabiban, az Egyesült Arab Emírségekben van.