Lisez la documentation de l'API

Vendez des vignettes européennes via votre propre produit

Une API pour les péages routiers de neuf pays, intégrée à votre application, site web ou back-office

Ce que vous obtenez avec une seule connexion

Plutôt que d'intégrer une autorité de péage distincte par pays, vous vous connectez une seule fois et accédez aux produits de vignette officiels pour voitures, utilitaires et motos dans neuf pays : Autriche, Suisse, Slovénie, Hongrie, Slovaquie, Tchéquie, Roumanie, Bulgarie et Moldavie, ainsi qu'aux péages de section alpins autrichiens (Brenner, Tauern, Katschberg, Karavanke, Arlberg, Gleinalm et Bosruck) qui se situent en dehors de la vignette ordinaire.

Chaque produit provient de l'opérateur national, et non d'une majoration tierce ajoutée silencieusement : le catalogue renvoie le prix officiel et votre commission sous forme de champs distincts, ce que vous montrez à un client et ce que vous conservez n'est donc jamais un mystère.

Trois façons de vous intégrer

Choisissez l'intégration qui correspond au niveau de contrôle dont vous avez besoin et au temps d'ingénierie dont vous disposez.

  • API REST : contrôle total sur le catalogue, le checkout et le cycle de vie des commandes, au sein de votre propre produit et devise. Convient aux développeurs créant un checkout personnalisé, un flux de réservation ou une automatisation backend.
  • Checkout iframe ou widget intégrable : un checkout hébergé inséré dans votre page ou application, avec une redirection vers vous en cas de succès ou d'échec. Convient aux équipes voulant un flux d'achat fonctionnel rapidement, sans gérer la logique de paiement elles-mêmes.
  • Portail partenaire : un tableau de bord pour créer et gérer des commandes manuellement, sans code requis. Convient aux agents et courtiers vendant au cas par cas, et sert également de lieu où chaque partenaire teste et surveille ses commandes, quelle que soit l'intégration choisie.

Ce que l'API fait concrètement

Elle couvre l'ensemble du cycle de vie des commandes, pas seulement une liste de produits : interrogez le catalogue en temps réel par pays, type de produit, type de véhicule et devise, vérifiez si un pays ou une durée est disponible avant d'afficher le checkout, validez un véhicule avant le paiement, et validez une commande complète avant de la valider définitivement.

Les commandes passées via l'API et celles déjà créées dans votre propre système peuvent toutes deux être reflétées dans Vignette ID, les secondes en tant que commandes externes, gardant vos registres et le côté opérateur synchronisés. Les commandes peuvent être modifiées, les commandes en attente ou différées annulées, et un même flux peut combiner plusieurs pays et types de véhicules.

Tarification et votre commission

Le point d'accès produits renvoie trois montants pour chaque article : le prix officiel fixé par l'opérateur national, votre commission partenaire, et le prix total payé par le client final, votre commission déjà incluse. Cette séparation montre votre marge par produit, par pays et par type de véhicule, plutôt que de vous forcer à la reconstituer à partir d'un chiffre unique mélangé.

Les prix peuvent être demandés dans votre propre devise, notamment en EUR, UAH, USD, PLN et HUF, entre autres.

Les mécanismes de commission, les conditions de partage des revenus et tout dépôt éventuel sont définis dans l'accord de coopération établi pour votre compte une fois inscrit ; ces chiffres dépendent de votre modèle de paiement et de votre volume, ils relèvent donc de cet accord plutôt que d'un texte marketing.

Pour commencer

Inscrivez-vous via le formulaire partenaire pour recevoir des clés API sandbox et production distinctes. Connectez-vous au portail partenaire pour inviter des développeurs, configurer vos URL de webhook et de redirection, et accéder au calculateur de revenus qui rédige votre accord de coopération selon le modèle de paiement que vous choisissez.

Développez et testez d'abord entièrement contre l'hôte sandbox : créez des commandes, déclenchez des événements webhook, et exercez des annulations et modifications sans toucher à de vrais paiements ni à de vrais systèmes gouvernementaux. Les identifiants de production s'activent une fois l'accord signé. Un appel d'intégration avec l'équipe est disponible si vous souhaitez d'abord passer en revue la configuration de l'API ou de l'iframe.

Détails opérationnels à connaître avant d'intégrer

Le point d'accès du catalogue produits est limité en débit par partenaire et par minute, avec davantage de marge à mesure que votre volume croît ; mettez en cache les données du catalogue plutôt que de les interroger à chaque checkout, et préférez les webhooks à l'interrogation répétée du statut d'une commande.

Certains produits comportent des conditions que le checkout doit gérer : certains pays n'autorisent une date de début qu'à partir de demain plutôt qu'aujourd'hui, et certains exigent un VIN ou des informations supplémentaires sur le conducteur avant de pouvoir créer la commande. Valider un véhicule et lire les restrictions d'un produit avant le checkout évite les échecs de commande au moment du paiement.

Les commandes traversent un cycle de vie défini, de la création jusqu'à une vignette active et utilisable, avec des états distincts pour les commandes en attente de réponse d'un opérateur, les commandes différées à une date de début future, et les commandes se terminant par une annulation ou un remboursement. Configurez un webhook pour que votre système se mette à jour automatiquement à chaque changement de statut.

À qui cela s'adresse

Agences de voyage et voyagistes ajoutant des péages routiers à un flux de réservation existant. Courtiers en assurance intégrant une vignette à une police. Applications de flotte et de mobilité couvrant des véhicules traversant plusieurs pays. Loueurs de véhicules couvrant un client pour la durée de la location. Développeurs et intégrateurs systèmes souhaitant une API documentée et une sandbox plutôt qu'un processus manuel.

API facile mais puissant

API DocsRead docs

Tableau de bord pour les partenaires

Partner DashboardPartner dashboard

Questions sur le partenariat et l'API

Existe-t-il une sandbox pour tester avant de passer en production ?

Oui. S'inscrire comme partenaire vous donne des clés API sandbox et production distinctes, et la sandbox prend en charge le flux de commande complet, y compris les événements webhook, les annulations et les modifications, sans toucher à de vrais paiements ni à de vrais systèmes gouvernementaux.

Quels pays et produits sont couverts ?

Autriche, Suisse, Slovénie, Hongrie, Slovaquie, Tchéquie, Roumanie, Bulgarie et Moldavie, couvrant les produits de vignette et de tunnel pour voitures, utilitaires et motos, y compris les péages de section alpins autrichiens qui se situent en dehors de la vignette ordinaire.

Puis-je vendre dans une devise autre que l'euro ?

Oui. Le catalogue produits peut être demandé dans votre propre devise, notamment en EUR, UAH, USD, PLN et HUF, entre autres, votre commission étant déjà reflétée dans le prix total renvoyé.

Dois-je créer mon propre checkout, ou en existe-t-il un déjà prêt ?

Les deux sont disponibles. Vous pouvez créer un checkout entièrement personnalisé avec l'API REST, ou utiliser le checkout iframe ou widget intégrable pour un flux d'achat fonctionnel avec une redirection vers vous en cas de succès ou d'échec.

Dois-je écrire du code, ne serait-ce qu'un peu ?

Non. Le portail partenaire vous permet de créer et de gérer des commandes manuellement sans aucun développement, ce qui convient aux courtiers et agents vendant au cas par cas. Chaque partenaire, quelle que soit l'intégration utilisée, peut également utiliser le portail pour surveiller et tester des commandes.

Comment fonctionne l'annulation ou la modification d'une commande ?

Une commande peut être modifiée après sa création, et les commandes en attente ou différées peuvent être annulées via l'API ou le portail partenaire. La possibilité d'annuler une vignette active et complétée dépend des propres règles de l'opérateur national pour ce pays et ce produit.

De quelles informations ai-je besoin pour passer une commande ?

Au minimum le produit, le pays, le type de véhicule et la plaque d'immatriculation, validés au préalable via le point d'accès de validation de véhicule. Certains pays exigent en plus un VIN ou des informations sur le conducteur, et certains n'autorisent une date de début qu'à partir de demain plutôt qu'aujourd'hui, ce que les données du produit vous indiquent avant le checkout.

Quelle est l'entité contractante derrière l'API ?

L'API partenaire et les accords de coopération de Vignette ID sont opérés par PD Business Services FZ LLC, basée à Abou Dabi, aux Émirats arabes unis.