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.

