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 bénéficieront particulièrement de cette fonctionnalité, car elle leur permettra d'ajouter plus facilement et plus rapidement leurs cartes d'embarquement à Wallet.

Cela se produit automatiquement, quel que soit le canal d'enregistrement (par exemple, le Web, l'application ou la borne d'aéroport). La compagnie aérienne utilise le numéro de compte fidélité de l'utilisateur pour associer et envoyer la carte.

Remarque : Cette fonctionnalité est une implémentation spécifique de la fonctionnalité "Passes associées automatiquement". Le reste du document utilise la terminologie plus générale "Passes associés automatiquement", ainsi que "pass principal" et "pass associé" pour décrire cette fonctionnalité.

Fonctionnement de cette fonctionnalité

Étape 1 : Autorisez le voyageur fréquent à ajouter sa carte de fidélité à Wallet.

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

É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.
• Vous pouvez associer jusqu'à 50 objets à un objet principal.
• 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 des Conditions d'utilisation acceptables 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 associé.
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"
  }
  …

Comportement attendu

Une fois que vous avez reçu une réponse positive, les appareils sur lesquels vous avez mis à jour la carte devraient recevoir la carte associée. Ce pass associé sera regroupé avec le pass principal. Les utilisateurs peuvent voir la carte associée en balayant l'écran vers la droite.

Gestion des exceptions

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