Cosa ottieni con un'unica connessione
Anziché integrare una diversa autorità di pedaggio per ogni paese, ti connetti una sola volta e raggiungi i prodotti ufficiali di vignetta per auto, furgoni e motocicli in Austria, Svizzera, Slovenia, Ungheria, Slovacchia, Cechia, Romania, Bulgaria e Moldova, oltre ai pedaggi alpini di tratta austriaci (Brennero, Tauern, Katschberg, Karavanke, Arlberg, Gleinalm e Bosruck) che si collocano al di fuori della normale vignetta.
Ogni prodotto proviene dal fornitore nazionale, non da un ricarico di terze parti aggiunto silenziosamente: il catalogo restituisce il prezzo statale e la tua commissione come campi separati, così quello che mostri a un cliente e quello che trattieni non è mai un mistero.
Tre modi per integrarsi
Scegli l'integrazione più adatta al livello di controllo che ti serve e al tempo di sviluppo che hai a disposizione.
- API REST: controllo completo su catalogo, checkout e ciclo di vita dell'ordine, all'interno del tuo prodotto e della tua valuta. Adatta agli sviluppatori che costruiscono un checkout, un flusso di prenotazione o un'automazione di backend personalizzati.
- Checkout iframe o widget incorporabile: un checkout ospitato inserito nella tua pagina o app, con reindirizzamento verso di te in caso di successo o fallimento. Adatto ai team che vogliono un flusso d'acquisto funzionante rapidamente senza gestire in proprio la logica dei pagamenti.
- Pannello partner: una dashboard per creare e gestire ordini manualmente, senza scrivere codice. Adatto ad agenti e broker che vendono caso per caso, e funge anche da luogo in cui ogni partner testa e monitora gli ordini indipendentemente dall'integrazione scelta.
Cosa fa davvero l'API
Copre l'intero ciclo di vita dell'ordine, non solo un elenco di prodotti: interroga il catalogo in tempo reale per paese, tipo di prodotto, tipo di veicolo e valuta, verifica se un paese o un periodo è disponibile prima di mostrare il checkout, valida un veicolo prima del pagamento, e valida un ordine completo prima di confermarlo.
Gli ordini effettuati tramite l'API e quelli già creati nel tuo sistema possono entrambi essere rispecchiati in Vignette ID, questi ultimi come ordini esterni, mantenendo sincronizzati i tuoi registri e il lato del fornitore. Gli ordini possono essere modificati, quelli in sospeso o differiti possono essere annullati, e un unico flusso può combinare paesi e tipi di veicolo diversi.
Prezzi e la tua commissione
L'endpoint dei prodotti restituisce tre importi per ogni articolo: il prezzo statale fissato dal fornitore nazionale, la tua commissione di partner, e il prezzo totale pagato dal cliente finale, già comprensivo della tua commissione. Questa separazione mostra il tuo margine per prodotto, per paese e per tipo di veicolo, invece di costringerti a ricavarlo da un unico importo aggregato.
I prezzi possono essere richiesti nella tua valuta, tra cui EUR, UAH, USD, PLN e HUF, oltre ad altre.
I meccanismi di commissione, le condizioni di revenue-share ed eventuali depositi sono stabiliti nell'accordo di cooperazione predisposto per il tuo account dopo la registrazione; questi importi dipendono dal tuo modello di pagamento e dal volume, e per questo appartengono a quell'accordo piuttosto che al materiale di marketing.
Come iniziare
Registrati tramite il modulo partner per ricevere chiavi API separate per sandbox e produzione. Accedi al pannello partner per invitare sviluppatori, configurare i tuoi URL di webhook e reindirizzamento, e raggiungere il calcolatore di ricavi che predispone il tuo accordo di cooperazione in base al modello di pagamento scelto.
Costruisci e testa prima interamente contro l'host sandbox: crea ordini, attiva eventi webhook, ed esercita annullamenti e modifiche senza toccare pagamenti reali o sistemi governativi reali. Le credenziali di produzione si attivano una volta firmato l'accordo. È disponibile una chiamata di integrazione con il team se desideri prima ripercorrere la configurazione dell'API o dell'iframe.
Dettagli operativi utili prima di integrarsi
L'endpoint del catalogo prodotti è soggetto a limiti di frequenza per partner al minuto, con maggiore margine man mano che cresce il tuo volume; metti in cache i dati del catalogo anziché interrogarli a ogni checkout, e preferisci i webhook rispetto all'interrogazione ripetuta dello stato di un ordine.
Alcuni prodotti comportano condizioni che il checkout deve gestire: alcuni paesi consentono una data di inizio solo da domani anziché da oggi, e alcuni richiedono un VIN o dati aggiuntivi del conducente prima che l'ordine possa essere creato. Validare un veicolo e leggere le restrizioni di un prodotto prima del checkout evita ordini falliti al momento del pagamento.
Gli ordini attraversano un ciclo di vita definito dalla creazione fino a una vignetta attiva e utilizzabile, con stati distinti per gli ordini in attesa della risposta di un fornitore, gli ordini differiti a una data di inizio futura, e gli ordini che terminano in annullamento o rimborso. Configura un webhook affinché il tuo sistema si aggiorni automaticamente a ogni cambio di stato.
A chi è rivolto
Agenzie di viaggio e tour operator che aggiungono i pedaggi stradali a un flusso di prenotazione esistente. Broker assicurativi che abbinano una vignetta a una polizza. App di flotte e mobilità che coprono veicoli che attraversano più paesi. Autonoleggi che coprono un cliente per la durata del noleggio. Sviluppatori e integratori di sistemi che desiderano un'API documentata e una sandbox anziché un processo manuale.
