Guide du développeur de l’API The Wallet Crew

Créez des intégrations de Cartes Apple Wallet et Google Wallet avec l’API The Wallet Crew, notamment l’authentification, les mises à jour de Cartes, les webhooks, les scans et les rapports.

Guide du développeur de l'API Wallet Crew

Créez des intégrations de cartes Apple Wallet et Google Wallet avec The Wallet Crew. Ce guide couvre l'authentification de l'API, les mises à jour de cartes, les webhooks, les scans, les rapports et les chemins qui prennent en charge chaque flux de travail.

Ouvrir la référence de l'API

Exemples concrets

Créez une carte de fidélité après l'inscription ou le paiement.
Mettez à jour les champs de la carte après un événement CRM, de billetterie ou de POS.
Transférez les événements du cycle de vie du Wallet vers un backend, un CRM ou une pile analytique.

Commencez ici

La plupart des projets de développement suivent le même parcours.

Obtenir les identifiants

Générez une clé API depuis la console d’administration, dans Paramètres → Sécurité → Clés API. Envoyez-la dans le X-API-KEY en-tête de chaque requête.

Ouvrir la référence de l'API

Utilisez la référence de l'API pour examiner les points de terminaison, les corps de requête, les schémas de réponse, les autorisations et les exemples en direct.

Ouvrir la référence de l'API

Faites une première requête

Commencez avec une carte qui existe déjà plutôt qu’avec un flux de création. C’est le moyen le plus rapide de valider l’accès au tenant, l’authentification et le comportement de mise à jour sans mêler la logique de création au premier test.

L’appel initial le plus courant est une mise à jour forcée de la carte. Il indique à la plateforme de récupérer à nouveau les données auprès des fournisseurs configurés, de reconstruire la carte et d’envoyer la version mise à jour à l’appareil :

PATCH /api/{tenantId}/passes?id={passId}
X-API-KEY: {api_key}
Content-Type: application/json

{
  "additionalData": { "loyaltyTier": "gold" },
  "options": { "updateMetadata": true }
}

Une carte peut également être ciblée par un identifiant externe au lieu de passId, par exemple id.shopify.customerId={customerId}. Consultez Concepts clés pour connaître la différence entre les deux. Une 200 réponse signifie que la mise à jour s’est exécutée de manière synchrone ; 202 cela signifie qu’elle a été mise en file d’attente.

Si aucune carte n’existe encore, commencez plutôt par des flux d’inscription ou par la création de carte déclenchée par le connecteur, puis revenez à cet appel une fois qu’une carte a été émise.

Poursuivez avec Premiers pas avec l'API pour le guide complet.

Développez l'intégration

Une fois que le premier appel de gestion fonctionne, passez aux flux de création, aux mises à jour, aux webhooks, aux scans et aux rapports.

Authentification

Certaines API à portée de tenant prennent en charge d'autres modèles d'authentification ou des scopes supplémentaires, par exemple le flux OAuth2 utilisé par certaines opérations administratives. Lorsque c'est le cas, le guide du point de terminaison ou la référence de l'API fait foi.

Pour une première intégration, commencez par les API documentées autour de X-API-KEY. C'est le parcours habituel pour la gestion des cartes, les webhooks, les scans et la référence API interactive.

Référence de l'API

Utilisez la référence de l'API lorsque la forme exacte de la charge utile, le schéma de réponse ou le comportement du point de terminaison est important.

Ouvrir la référence de l'API

Guides pour développeurs

Ces guides couvrent les principaux modèles d'intégration.

Concepts clés couvre les tenants, les identifiants, les modèles et les bases du cycle de vie de la carte.
Premiers pas avec l'API décrit pas à pas la première requête à portée de tenant.
flux d'inscription et création de Carte déclenchée par un connecteur couvrent l'émission de nouvelles cartes.
Mettre à jour les données de la Carte dans les gabarits explique comment afficher les données actuelles de la carte.
Webhooks, API de scan, et API Insights couvrent les événements, les scans et les rapports.

Étapes suivantes courantes

Après la réussite de la première requête, l'étape suivante dépend généralement de l'objectif d'intégration.

Si des cartes existent déjà, commencez par Premiers pas avec l'API.
Si l'émission commence lors d'une inscription, d'un paiement ou d'un formulaire hébergé, utilisez flux d'inscription.
Si l'émission commence à partir d'un événement du système source, utilisez création de Carte déclenchée par un connecteur.
Pour maintenir le contenu du Wallet à jour, utilisez Mettre à jour les données de la Carte dans les gabarits.
Pour notifier les systèmes externes en temps réel, utilisez Webhooks.

FAQ

Comment créer une clé API ?

Générez une clé API depuis la console d’administration, puis envoyez-la dans X-API-KEY pour les principales API de la plateforme décrites dans Commencez ici.

Comment une clé API doit-elle être stockée ?

Conservez les clés API dans un stockage secret côté serveur. Ne les exposez pas dans le code du navigateur, les applications mobiles, les journaux ou le contrôle de source.

Où se trouve la référence de l'API ?

Utilisation Référence de l'API pour le point d'entrée principal de l'API.

Quel est le meilleur premier appel API ?

Une mise à jour forcée d’une carte existante est généralement le meilleur premier appel, car elle valide l’accès au tenant, l’authentification et le chemin de mise à jour sans dépendre d’un flux de création.