Lesen Sie die API-Dokumentation

Verkaufen Sie europäische Vignetten über Ihr eigenes Produkt

Eine API für Straßenmaut in neun Ländern, eingebunden in Ihre App, Website oder Ihr Backoffice

Was Sie mit einer Verbindung bekommen

Statt für jedes Land eine eigene Mautbehörde einzubinden, verbinden Sie sich einmal und erreichen offizielle Vignettenprodukte für Pkw, Transporter und Motorräder in Österreich, der Schweiz, Slowenien, Ungarn, der Slowakei, Tschechien, Rumänien, Bulgarien und Moldawien, dazu Österreichs alpine Streckenmauten (Brenner, Tauern, Katschberg, Karawanken, Arlberg, Gleinalm und Bosruck), die außerhalb der gewöhnlichen Vignette liegen.

Jedes Produkt stammt vom nationalen Anbieter, nicht von einem stillschweigend aufgeschlagenen Fremdaufschlag: Der Katalog liefert den staatlichen Preis und Ihre Gebühr als getrennte Felder, sodass nie unklar ist, was Sie einem Kunden zeigen und was Sie behalten.

Drei Wege zur Integration

Wählen Sie die Integration, die zu Ihrem gewünschten Grad an Kontrolle und Ihrer verfügbaren Entwicklungszeit passt.

  • REST-API: volle Kontrolle über Katalog, Checkout und Bestell-Lebenszyklus innerhalb Ihres eigenen Produkts und Ihrer Währung. Geeignet für Entwickler, die einen eigenen Checkout, Buchungsablauf oder Backend-Automatisierung bauen.
  • Iframe- oder einbettbarer Widget-Checkout: ein gehosteter Checkout, eingebettet in Ihre Seite oder App, mit Weiterleitung zurück zu Ihnen bei Erfolg oder Fehlschlag. Geeignet für Teams, die schnell einen funktionierenden Kaufablauf wollen, ohne die Zahlungslogik selbst zu betreiben.
  • Partnerportal: ein Dashboard zum manuellen Erstellen und Verwalten von Bestellungen, ohne Programmierung. Geeignet für Agenten und Makler, die Fall für Fall verkaufen, und dient zugleich als Ort, an dem jeder Partner unabhängig von der Integration Bestellungen testet und überwacht.

Was die API tatsächlich leistet

Sie deckt den vollständigen Bestell-Lebenszyklus ab, nicht nur eine Produktliste: Fragen Sie den Live-Katalog nach Land, Produktart, Fahrzeugtyp und Währung ab, prüfen Sie vor dem Rendern des Checkouts, ob ein Land oder Zeitraum verfügbar ist, validieren Sie ein Fahrzeug vor der Zahlung, und validieren Sie eine vollständige Bestellung, bevor Sie sie abschließen.

Über die API aufgegebene Bestellungen und bereits in Ihrem eigenen System erstellte Bestellungen können beide in Vignette ID abgebildet werden, letztere als externe Bestellungen, sodass Ihre Aufzeichnungen und die Anbieterseite synchron bleiben. Bestellungen können geändert, ausstehende oder aufgeschobene Bestellungen storniert werden, und ein einzelner Ablauf kann Länder und Fahrzeugtypen mischen.

Preisgestaltung und Ihre Provision

Der Produkte-Endpunkt liefert für jeden Artikel drei Zahlen: den vom nationalen Anbieter festgelegten staatlichen Preis, Ihre Partnergebühr und den Gesamtpreis, den der Endkunde zahlt, bereits inklusive Ihrer Gebühr. Diese Trennung zeigt Ihre Marge pro Produkt, pro Land und pro Fahrzeugtyp, statt Sie aus einer vermischten Zahl rückrechnen zu lassen.

Preise können in Ihrer eigenen Währung angefragt werden, darunter unter anderem EUR, UAH, USD, PLN und HUF.

Provisionsmechanik, Umsatzbeteiligungsbedingungen und eine etwaige Kaution sind in der Kooperationsvereinbarung festgelegt, die für Ihr Konto nach der Registrierung erstellt wird; diese Zahlen hängen von Ihrem Zahlungsmodell und Volumen ab und gehören daher in diese Vereinbarung statt in Marketingtexte.

Erste Schritte

Registrieren Sie sich über das Partnerformular, um separate Sandbox- und Produktions-API-Schlüssel zu erhalten. Melden Sie sich im Partnerportal an, um Entwickler einzuladen, Ihre Webhook- und Weiterleitungs-URLs zu konfigurieren, und den Umsatzrechner zu erreichen, der Ihre Kooperationsvereinbarung anhand des gewählten Zahlungsmodells entwirft.

Bauen und testen Sie zunächst vollständig gegen den Sandbox-Host: Erstellen Sie Bestellungen, lösen Sie Webhook-Ereignisse aus, und führen Sie Stornierungen und Änderungen durch, ohne echte Zahlungen oder echte staatliche Systeme zu berühren. Produktionszugangsdaten werden aktiviert, sobald die Vereinbarung unterzeichnet ist. Ein Integrationsgespräch mit dem Team ist verfügbar, wenn Sie zunächst API- oder Iframe-Einrichtung durchgehen möchten.

Betriebliche Details, die Sie vor der Integration kennen sollten

Der Produktkatalog-Endpunkt ist pro Partner und Minute ratenbegrenzt, mit mehr Spielraum, sobald Ihr Volumen wächst; cachen Sie Katalogdaten, statt sie bei jedem Checkout erneut abzufragen, und bevorzugen Sie Webhooks gegenüber wiederholtem Abfragen des Bestellstatus.

Manche Produkte tragen Bedingungen, die der Checkout behandeln muss: Manche Länder erlauben ein Startdatum nur ab morgen statt ab heute, und manche verlangen vor der Bestellerstellung eine VIN oder zusätzliche Fahrerangaben. Die Validierung eines Fahrzeugs und das Lesen der Einschränkungen eines Produkts vor dem Checkout vermeidet fehlgeschlagene Bestellungen zum Zahlungszeitpunkt.

Bestellungen durchlaufen einen festgelegten Lebenszyklus von der Erstellung bis zu einer aktiven, nutzbaren Vignette, mit eigenen Zuständen für Bestellungen, die auf die Antwort eines Anbieters warten, Bestellungen, die auf ein zukünftiges Startdatum verschoben sind, und Bestellungen, die in einer Stornierung oder Rückerstattung enden. Konfigurieren Sie einen Webhook, damit Ihr System bei jeder Statusänderung automatisch aktualisiert wird.

Für wen das gedacht ist

Reisebüros und Reiseveranstalter, die Straßenmaut in einen bestehenden Buchungsablauf einbinden. Versicherungsmakler, die eine Vignette mit einer Police bündeln. Flotten- und Mobilitäts-Apps für Fahrzeuge, die mehrere Länder durchqueren. Autovermietungen, die einen Kunden für die Mietdauer absichern. Entwickler und Systemintegratoren, die eine dokumentierte API und eine Sandbox statt eines manuellen Prozesses wollen.

Einfaches, aber leistungsstarkes API

API DocsRead docs

Dashboard für Partner

Partner DashboardPartner dashboard

Fragen zu Partnerschaft und API

Gibt es eine Sandbox, gegen die ich testen kann, bevor ich live gehe?

Ja. Die Registrierung als Partner gibt Ihnen separate Sandbox- und Produktions-API-Schlüssel, und die Sandbox unterstützt den vollständigen Bestellablauf, einschließlich Webhook-Ereignissen, Stornierungen und Änderungen, ohne echte Zahlungen oder echte staatliche Systeme zu berühren.

Welche Länder und Produkte sind abgedeckt?

Österreich, die Schweiz, Slowenien, Ungarn, die Slowakei, Tschechien, Rumänien, Bulgarien und Moldawien, mit Vignetten- und Tunnelprodukten für Pkw, Transporter und Motorräder, einschließlich Österreichs alpiner Streckenmauten, die außerhalb der gewöhnlichen Vignette liegen.

Kann ich in einer anderen Währung als Euro verkaufen?

Ja. Der Produktkatalog kann in Ihrer eigenen Währung angefragt werden, darunter unter anderem EUR, UAH, USD, PLN und HUF, mit Ihrer Provision bereits im zurückgegebenen Gesamtpreis berücksichtigt.

Muss ich meinen eigenen Checkout bauen, oder gibt es einen fertigen?

Beides ist verfügbar. Sie können einen vollständig individuellen Checkout gegen die REST-API bauen, oder den Iframe- oder einbettbaren Widget-Checkout für einen funktionierenden Kaufablauf mit Weiterleitung zurück zu Ihnen bei Erfolg oder Fehlschlag nutzen.

Muss ich überhaupt Code schreiben?

Nein. Das Partnerportal erlaubt es Ihnen, Bestellungen ganz ohne Entwicklung manuell zu erstellen und zu verwalten, was für Makler und Agenten geeignet ist, die Fall für Fall verkaufen. Jeder Partner kann, unabhängig von der genutzten Integration, das Portal auch zum Überwachen und Testen von Bestellungen nutzen.

Wie funktioniert das Stornieren oder Ändern einer Bestellung?

Eine Bestellung kann nach der Erstellung geändert werden, und ausstehende oder aufgeschobene Bestellungen können über die API oder das Partnerportal storniert werden. Ob eine abgeschlossene, aktive Vignette storniert werden kann, hängt von den eigenen Regeln des nationalen Anbieters für dieses Land und Produkt ab.

Welche Informationen brauche ich, um eine Bestellung aufzugeben?

Mindestens Produkt, Land, Fahrzeugtyp und Kennzeichen, im Voraus über den Fahrzeugvalidierungs-Endpunkt geprüft. Manche Länder verlangen zusätzlich eine VIN oder Fahrerangaben, und manche erlauben ein Startdatum nur ab morgen statt ab heute, was Ihnen die Produktdaten vor dem Checkout mitteilen.

Wer ist die Vertragspartei hinter der API?

Vignette IDs Partner-API und Kooperationsvereinbarungen werden von der PD Business Services FZ LLC betrieben, mit Sitz in Abu Dhabi, VAE.