Émettez et mettez à jour des cartes Wallet depuis votre propre système.
Signer des cartes Apple, gérer des objets Google et synchroniser chaque changement est un projet à part entière. L’API Vuelvy permet à votre équipe technique d’intégrer inscriptions, émission, mises à jour, événements et utilisations d’un programme déjà publié. La conception et la publication du programme se font dans l’espace de gestion.
Google shares your name, email and profile picture, if available, to verify your identity. This does not subscribe you to marketing. Privacy policy
La disponibilité des notifications et mises à jour dépend des fonctionnalités et règles de chaque plateforme Wallet.
- 01Clés avec autorisations par opération
- 02Idempotency-Key là où elle est exigée
- 03Émission asynchrone traçable
- 04Documentation selon le périmètre
Ce que vous pouvez intégrer
L’API Wallet v1 couvre l’exploitation quotidienne d’un programme publié. La conception de la carte et la publication des versions restent dans l’espace de gestion Vuelvy et ne passent pas par l’API.
- Inscriptions, profils et consentements
- Émission, consultation et mise à jour de cartes
- QR codes et liens d’inscription
- Événements, points, avantages et utilisations
Un exemple minimal du contrat
Pour émettre une carte, votre système envoie une requête authentifiée avec sa clé et une clé d’idempotence. L’émission est asynchrone : la réponse confirme que l’opération est acceptée, pas que le client a déjà la carte dans son Wallet.
- Requête : POST /api/wallet/v1/passes avec Authorization: Bearer et l’en-tête Idempotency-Key.
- Corps : programId du programme publié, subscriberId facultatif et données de la carte.
- Réponse 202 : passId, state « pending » et identifiants d’opération pour suivre son statut.
- Répéter la même requête avec la même clé d’idempotence renvoie 200 sans créer une autre carte.
Erreurs explicites et nouvelles tentatives sûres
Chaque réponse indique s’il faut corriger la requête, vérifier les autorisations ou réessayer. Les opérations qui l’exigent, comme l’émission de cartes, demandent une Idempotency-Key : une nouvelle tentative après une coupure réseau ne duplique donc pas l’opération.
- 401 invalid_credentials : clé absente, révoquée ou expirée
- 403 forbidden : la clé n’a pas cette autorisation
- 400 idempotency_key_required : en-tête manquant sur une opération qui l’exige
- Limite de requêtes par clé
Apple et Google : un contrat commun sans fausse équivalence
L’API unifie la logique métier et Vuelvy génère la variante propre à chaque fournisseur. Apple et Google conservent des identifiants, champs, mises à jour et alertes différents ; lorsqu’une capacité n’existe pas sur une plateforme, elle n’est pas simulée.
Obtenir l’accès et la documentation
La référence technique n’est pas publique. Si votre projet nécessite une intégration, demandez une évaluation du périmètre : nous examinons les opérations nécessaires, le responsable de l’intégration et les données échangées. Des clés avec les autorisations minimales sont ensuite créées pour votre organisation et nous partageons la documentation des endpoints concernés. Chaque situation est étudiée individuellement avant tout engagement.
- Cas d’usage et opérations nécessaires
- Autorisations minimales par clé
- Données personnelles et consentement vérifiés
- Plan de tests avant d’opérer avec de vrais clients
FAQ
Questions fréquentes
La documentation de l’API est-elle publique ?
Non. La référence des endpoints est partagée une fois le périmètre technique convenu, avec des clés disposant des autorisations minimales pour votre organisation.
Puis-je émettre des cartes pour plusieurs marques ?
Oui, avec des identifiants distincts : chaque clé appartient à une organisation et n’opère que ses programmes, cartes et données. Une agence gérant plusieurs marques utilise des clés différentes pour chaque organisation.
Que peut automatiser l’API de Wallet Marketing ?
L’API relie inscription, émission de cartes, mises à jour, statuts et événements métier à Apple Wallet et Google Wallet. Le périmètre est défini par cas d’usage pour n’exposer que les opérations nécessaires.
Une même intégration peut-elle couvrir Apple Wallet et Google Wallet ?
Vuelvy unifie la logique métier et adapte le résultat à chaque fournisseur. Apple et Google conservent des modèles, identifiants et capacités différents. L’intégration évite de dupliquer les opérations communes sans présenter les deux plateformes comme identiques.
Comment les accès à l’API et aux données sont-ils protégés ?
Les accès sont authentifiés, limités par organisation et journalisés pour assurer la traçabilité. Les identifiants des fournisseurs et les données de chaque marque restent séparés selon le périmètre souscrit.
L’API envoie-t-elle des webhooks à mon système ?
L’intégration est conçue pour que votre système envoie des événements et consulte le statut des opérations. Si votre cas exige que Vuelvy notifie un autre système, ce besoin est étudié lors de l’évaluation du périmètre avant tout engagement. Les opérations qui l’exigent utilisent une Idempotency-Key pour qu’une nouvelle tentative ne duplique pas l’opération.
Parlons de votre situation
Wallet est-il pertinent pour votre activité ?
Présentez-nous votre situation et nous vous contacterons par e-mail pour étudier les intégrations, le plan de lancement et la prochaine étape. Sans présentation standardisée et sans engagement.
Google shares your name, email and profile picture, if available, to verify your identity. This does not subscribe you to marketing. Privacy policy