Cartes associées automatiquement

Contexte

La fonctionnalité Cartes associées automatiquement vous permet d'envoyer des cartes supplémentaires à un utilisateur qui dispose déjà de votre carte dans Google Wallet. Vous pouvez également une carte pré-lien vers une carte principale lorsqu'un utilisateur enregistre la carte principale (principale). La carte associée automatiquement est regroupée avec la carte principale dotée d'un au-dessus de la carte principale pour informer l'utilisateur qu'une nouvelle carte associés. Les types de cartes suivants sont acceptés en tant que cartes principales ou associées :

  • Billet pour un événement
  • Carte d'embarquement
  • Titre de transport
  • Offre
  • Bon d'achat
  • Carte de fidélité
  • Carte générique
<ph type="x-smartling-placeholder">
Exemple de carte principale associée automatiquement Exemple de carte secondaire associée automatiquement
Carte principale avec une accroche indiquant qu'une nouvelle carte a été ajoutée Nouvelle carte associée à la carte principale

Cas d'utilisation

L'association de cartes à une carte existante peut varier selon les cas d'utilisation. Voici quelques exemples :

  • Associez une offre à une carte de fidélité existante.
  • Associez un titre-restaurant à une carte d'embarquement ou à un billet pour un événement.
  • Associez une carte de stationnement à un billet pour un événement.

Éléments à prendre en compte lorsque vous utilisez des cartes associées automatiquement

  • L'objet principal et l'objet associé doivent utiliser le même "IssuerId".
  • Le nombre d'objets associés par objet principal est limité à 50.
  • Le transfert automatique des cartes associées n'est pas garanti et considéré au mieux. Les utilisateurs peuvent désactiver la réception de cartes associées automatiquement. Si le cas d'utilisation est critique et que l'utilisateur doit recevoir la carte associée, nous vous recommandons communiquent via un autre canal pour s'assurer que l'utilisateur ajoute la carte.
  • Modifications apportées à la PUA de Google Wallet incluent des conseils sur l'utilisation des cartes associées automatiquement, qui doivent être respectés.

Procédure d'intégration

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

  1. Créez un objet avec n'importe quel type de carte répertorié. avec les paramètres requis. Il s'agit de l'objet principal.
  2. Créez un autre objet avec n'importe quel type de carte listé. Ce sera linked.
  3. Avant ou après l'enregistrement de l'objet principal, update l'objet principal avec l'identifiant de l'objet associé dans la propriété linkedObjectIds .

Une charge utile minimale est requise pour définir les éléments linkedObjectIds sur un objet principal passe. 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 de carte

  …
  {
    "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 avoir associé un objet à un objet de carte

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

Comportement attendu

Après avoir reçu une réponse positive, les appareils avec la carte que vous avez mise à jour doit recevoir la carte associée. Cette carte associée sera regroupée avec la carte principale. Les utilisateurs peuvent voir la carte associée en balayant l'écran vers la droite.

Gestion des exceptions

Une utilisation incorrecte de l'API peut entraîner des erreurs potentielles, ce qui peut inclure ;

Message Motif
L'objet principal et l'objet associé ne partagent pas le même émetteur ID. 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 associer le même objet que l'objet linkedObject.
L'objet associé n'existe pas. L'objet associé doit déjà être inséré dans Wallet API.
L'objet associé est déjà associé à un autre objet. Impossible d'ajouter des éléments imbriqués des objets associé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 un lien imbriqué d'objets. L'objet principal ne peut pas être un objet associé seul.
Impossible d'ajouter d'autres objets associés, limite dépassée. La limite de 50 cartes associées a été atteinte pour la carte principale passe.