Ajouter automatiquement des cartes d'embarquement

Arrière-plan

Cette fonctionnalité permet aux compagnies aériennes d'envoyer automatiquement des cartes d'embarquement à un utilisateur dans Google Wallet. Les voyageurs fréquents en bénéficieront particulièrement, car ils pourront ajouter plus facilement et plus rapidement leurs cartes d'embarquement à Wallet, étant donné qu'ils voyagent plus souvent.

Cela se produit automatiquement, quel que soit le canal d'enregistrement (par exemple, le Web, l'application ou la borne d'aéroport). Les compagnies aériennes partenaires peuvent utiliser le numéro de compte fidélité de l'utilisateur pour corréler et transférer la carte dans son portefeuille.

Fonctionnement de cette fonctionnalité

Étape 1 : Permettez au voyageur fréquent d'ajouter sa carte de fidélité à Wallet.

Étape 2 : Ajoutez automatiquement les nouvelles cartes d'embarquement du voyageur fréquent en les associant à sa carte de fidélité dans Wallet.

Bonnes pratiques

• Pour permettre aux voyageurs fréquents de s'inscrire facilement à votre programme de fidélité, envisagez d'activer un flux S'inscrire / Se connecter avec Google. Les utilisateurs pourront ensuite découvrir le processus d'inscription au programme de fidélité de votre compagnie aérienne à différents points d'entrée dans Google Wallet, y compris les cartes d'embarquement.
• Envisagez d'activer l'inscription en un clic pour les membres existants de votre programme de fidélité sur votre application Android et votre site Web.

Remarque : Cette fonctionnalité est une implémentation spécifique de la fonctionnalité de cartes associées automatiquement. Dans ce contexte, la carte principale fait référence à une carte de fidélité et la carte associée à une carte d'embarquement. Le reste de ce document utilise une terminologie plus large (cartes associées automatiquement, carte principale et carte associée) pour décrire cette fonctionnalité.

Éléments à prendre en compte lors de l'utilisation des cartes associées automatiquement

• L'objet principal et l'objet associé doivent utiliser le même issuerId.
• L'envoi automatique des cartes associées n'est pas garanti et est considéré comme un effort optimal. Les utilisateurs peuvent désactiver la réception des cartes associées automatiquement. Si le cas d'utilisation est critique et que l'utilisateur doit recevoir la carte associée, nous vous recommandons de communiquer avec lui par un autre canal pour vous assurer qu'il ajoute la carte.
• Les mises à jour du Règlement d'utilisation acceptable de Google Wallet incluent des consignes sur l'utilisation des cartes associées automatiquement, que vous devez respecter.

Étapes d'intégration

Si vous avez déjà créé un objet primary, vous pouvez ignorer l'étape 1.

1. Créez un objet de n'importe quel type de carte listé avec les paramètres requis. Il s'agit de l'objet principal.
2. Créez un autre objet de l'un des types de cartes listés. Il s'agit de l'objet linked.
3. Avant ou après l'enregistrement de l'objet principal, mettez à jour l'objet principal avec l'ID de l'objet associé dans le paramètre linkedObjectIds.

Une charge utile minimale est requise pour définir les linkedObjectIds sur une carte principale. Les trois paramètres obligatoires sont les suivants :

1. ISSUERID.PRIMARY_OBJECT_ID
2. ISSUERID.PRIMARY_CLASS_ID
3. ISSUERID.LINKED_OBJECT_ID

Exemple de requête JSON pour ajouter un objet associé à un objet pass

  …
  {
    "id": "ISSUERID.PASS_OBJECTID",
    "classId": "ISSUERID.PASS_CLASSID",
    "barcode": {
      "type": "qrCode",
      "value": "QR code"
    },
    "linkedObjectIds": ["ISSUERID.LINKED_PASS_OBJECTID"]
  }
  …

Exemple de réponse JSON après l'association d'un objet à un objet Pass

  …
  "state": "active",
  "linkedObjectIds": {
    "ISSUERID.LINKED_PASS_OBJECTID"
  }
  …

Gestion des exceptions

Des erreurs potentielles peuvent se produire en cas d'utilisation incorrecte de l'API. Voici quelques exemples :

Message	Motif
L'objet principal et l'objet associé ne partagent pas le même ID d'émetteur.	Vous ne pouvez pas associer un objet associé à l'objet d'un autre émetteur.
L'objet principal et l'objet associé font référence au même objet.	Vous ne pouvez pas joindre le même objet que linkedObject.
L'objet associé n'existe pas.	L'objet associé doit déjà être inséré dans l'API Wallet.
L'objet associé possède déjà un autre objet associé. Impossible d'ajouter des objets associés imbriqués.	Les objets associés ne peuvent pas être associés à un autre objet.
L'objet est déjà associé à un autre objet. Impossible d'ajouter des objets associés imbriqués.	L'objet principal ne peut pas être un objet associé seul.