Citește documentația API

Vindeți vinietă europene prin propriul dumneavoastră produs

Un singur API pentru taxe rutiere în nouă țări, integrat în aplicația, site-ul sau back-office-ul dumneavoastră

Ce obțineți printr-o singură conexiune

În loc să integrați separat câte o autoritate de taxare pentru fiecare țară, vă conectați o singură dată și ajungeți la produsele oficiale de vinietă pentru autoturisme, autoutilitare și motociclete în Austria, Elveția, Slovenia, Ungaria, Slovacia, Cehia, România, Bulgaria și Moldova, plus taxele alpine de secțiune ale Austriei (Brenner, Tauern, Katschberg, Karawanken, Arlberg, Gleinalm și Bosruck), care se află în afara vinietei obișnuite.

Fiecare produs provine de la furnizorul național, nu de la un adaos de terță parte aplicat pe ascuns: catalogul returnează prețul de stat și comisionul dumneavoastră ca valori separate, așa că ceea ce arătați unui client și ceea ce păstrați nu este niciodată un mister.

Trei moduri de integrare

Alegeți integrarea potrivită cât control aveți nevoie și cât timp de dezvoltare aveți la dispoziție.

  • API REST: control total asupra catalogului, plății și ciclului de viață al comenzii, în cadrul propriului dumneavoastră produs și monedă. Potrivit dezvoltatorilor care construiesc un flux de checkout, de rezervare sau o automatizare de back-office personalizată.
  • Checkout iframe sau widget integrabil: un checkout găzduit, inserat în pagina sau aplicația dumneavoastră, cu redirecționare înapoi la dumneavoastră la succes sau eșec. Potrivit echipelor care vor un flux de cumpărare funcțional rapid, fără să dezvolte propria logică de plată.
  • Panou de parteneri: un tablou de bord pentru crearea și gestionarea manuală a comenzilor, fără cod. Potrivit agenților și brokerilor care vând caz cu caz, și este, pentru orice partener, locul unde se testează și se monitorizează comenzile, indiferent de tipul de integrare.

Ce face de fapt API-ul

Acoperă întregul ciclu de viață al comenzii, nu doar o listă de produse: interogați catalogul live după țară, tip de produs, tip de vehicul și monedă, verificați dacă o țară sau o perioadă este disponibilă înainte de a afișa checkout-ul, validați un vehicul înainte de plată și validați o comandă completă înainte de a o finaliza.

Atât comenzile plasate prin API, cât și comenzile deja create în propriul dumneavoastră sistem pot fi reflectate în Vignette ID, cele din urmă ca și comenzi externe, păstrând evidențele dumneavoastră și partea furnizorului sincronizate. Comenzile pot fi modificate, comenzile în așteptare sau amânate pot fi anulate, iar un singur flux poate combina țări și tipuri de vehicule diferite.

Prețuri și comisionul dumneavoastră

Endpoint-ul de produse returnează trei cifre pentru fiecare articol: prețul de stat stabilit de furnizorul național, comisionul dumneavoastră de partener și prețul total pe care îl plătește clientul final, cu comisionul dumneavoastră deja inclus. Această separare arată marja dumneavoastră pe produs, pe țară și pe tip de vehicul, în loc să vă oblige să o deduceți dintr-o singură cifră combinată.

Prețurile pot fi solicitate în propria dumneavoastră monedă, inclusiv EUR, UAH, USD, PLN și HUF, printre altele.

Mecanismul comisionului, termenii de partajare a veniturilor și orice garanție sunt stabilite în acordul de cooperare întocmit pentru contul dumneavoastră la înregistrare; aceste cifre depind de modelul dumneavoastră de plată și de volum, așa că își au locul în acel acord, nu în materialele de marketing.

Primii pași

Înregistrați-vă prin formularul de parteneri pentru a primi chei API separate pentru sandbox și producție. Conectați-vă în panoul de parteneri pentru a invita dezvoltatori, a configura webhook-ul și adresele URL de redirecționare, și pentru a ajunge la calculatorul de venituri care redactează acordul dumneavoastră de cooperare pe baza modelului de plată ales.

Construiți și testați totul exclusiv pe gazda de sandbox mai întâi: creați comenzi, declanșați evenimente webhook și exersați anulări și modificări fără a atinge plăți reale sau sisteme guvernamentale reale. Acreditările de producție se activează odată ce acordul este semnat. Un apel de integrare cu echipa este disponibil dacă doriți să parcurgeți mai întâi configurarea API-ului sau a iframe-ului.

Detalii operaționale utile de știut înainte de integrare

Endpoint-ul catalogului de produse are o limită de rată per partener pe minut, cu mai mult spațiu de manevră pe măsură ce volumul dumneavoastră crește; puneți în cache datele din catalog în loc să le interogați la fiecare checkout, și preferați webhook-urile în locul interogării repetate a stării unei comenzi.

Unele produse au condiții pe care checkout-ul trebuie să le gestioneze: anumite țări permit o dată de început doar de mâine, nu de azi, iar unele necesită un VIN sau date suplimentare despre șofer înainte ca o comandă să poată fi creată. Validarea unui vehicul și citirea restricțiilor unui produs înainte de checkout evită comenzile eșuate în momentul plății.

Comenzile trec printr-un ciclu de viață bine definit, de la creare până la o vinietă activă, utilizabilă, cu stări distincte pentru comenzile care așteaptă răspunsul unui furnizor, comenzile amânate pentru o dată de început viitoare și comenzile care se finalizează prin anulare sau rambursare. Configurați un webhook astfel încât sistemul dumneavoastră să se actualizeze automat la fiecare schimbare de stare.

Cui i se adresează

Agențiilor de turism și operatorilor de turism care adaugă taxe rutiere la un flux de rezervare existent. Brokerilor de asigurări care includ o vinietă într-o poliță. Aplicațiilor de flotă și mobilitate care acoperă vehicule ce traversează mai multe țări. Firmelor de închiriere auto care acoperă un client pe durata închirierii. Dezvoltatorilor și integratorilor de sisteme care vor un API documentat și un sandbox, în loc de un proces manual.

API ușor, dar puternic

API DocsRead docs

Panou pentru parteneri

Partner DashboardPartner dashboard

Întrebări pentru parteneri și despre API

Există un sandbox în care pot testa înainte de a trece în producție?

Da. Înregistrarea ca partener vă oferă chei API separate pentru sandbox și producție, iar sandbox-ul acceptă întregul flux de comandă, inclusiv evenimente webhook, anulări și modificări, fără a atinge plăți reale sau sisteme guvernamentale reale.

Ce țări și produse sunt acoperite?

Austria, Elveția, Slovenia, Ungaria, Slovacia, Cehia, România, Bulgaria și Moldova, acoperind produse de vinietă și de tunel pentru autoturisme, autoutilitare și motociclete, inclusiv taxele alpine de secțiune ale Austriei, care se află în afara vinietei obișnuite.

Pot vinde într-o altă monedă decât euro?

Da. Catalogul de produse poate fi solicitat în propria dumneavoastră monedă, inclusiv EUR, UAH, USD, PLN și HUF, printre altele, cu comisionul dumneavoastră deja reflectat în prețul total returnat.

Trebuie să îmi construiesc propriul checkout, sau există unul gata făcut?

Ambele variante sunt disponibile. Puteți construi un checkout complet personalizat pe baza API-ului REST, sau puteți folosi checkout-ul iframe sau widget-ul integrabil pentru un flux de cumpărare funcțional, cu redirecționare înapoi la dumneavoastră la succes sau eșec.

Trebuie să scriu vreun cod?

Nu. Panoul de parteneri vă permite să creați și să gestionați comenzi manual, fără dezvoltare, ceea ce este potrivit pentru brokerii și agenții care vând caz cu caz. Orice partener, indiferent de integrarea folosită, poate folosi și panoul pentru a monitoriza și testa comenzi.

Cum funcționează anularea sau modificarea unei comenzi?

O comandă poate fi modificată după creare, iar comenzile în așteptare sau amânate pot fi anulate prin API sau prin panoul de parteneri. Dacă o vinietă deja finalizată și activă poate fi anulată depinde de regulile proprii ale furnizorului național pentru acea țară și produs.

De ce informații am nevoie pentru a plasa o comandă?

Cel puțin de produs, țară, tip de vehicul și numărul de înmatriculare, validate în prealabil prin endpoint-ul de validare a vehiculului. Unele țări cer suplimentar un VIN sau date despre șofer, iar unele permit o dată de început doar de mâine, nu de azi, ceea ce vă spun datele produsului înainte de checkout.

Cine este entitatea contractantă din spatele API-ului?

API-ul de parteneri și acordurile de cooperare ale Vignette ID sunt operate de PD Business Services FZ LLC, cu sediul în Abu Dhabi, Emiratele Arabe Unite.