Regrouper plusieurs cartes d'embarquement

Utiliser un identifiant de regroupement

Par défaut, l'ajout de plusieurs cartes via un même lien Ajouter à Google Wallet ne permet pas de regrouper ces cartes dans l'application Google Wallet de l'utilisateur. Toutefois, il est possible de regrouper les cartes en veillant à ce qu'elles partagent un même identifiant de regroupement. Les cartes regroupées apparaissent ensemble dans l'application Google Wallet. Lorsque l'utilisateur sélectionne un groupe de cartes, chacune des cartes s'affiche dans un carrousel.

Les cartes peuvent être regroupées :

• lors du provisionnement initial ;
• à l'aide des méthodes update ou patch.

Pour pouvoir ajouter une carte à un groupe, la propriété groupingInfo.groupingId de la carte doit être définie. Tous les objets Cartes possédant la même valeur groupingId sont automatiquement regroupés, même s'ils ont été ajoutés séparément.

L'exemple suivant présente une offre et une carte de fidélité regroupées afin d'inciter l'utilisateur à s'en servir ensemble lors de son prochain achat.

loyaltyObject = {
  "classId": "ISSUER_ID.GIFT_CARD_CLASS_SUFFIX",
  "id": "ISSUER_ID.GIFT_CARD_OBJECT_SUFFIX",
  "state": "ACTIVE",
  "groupingInfo": {
    # Note the same groupingId value
    "groupingId": "combinedGiftCardAndOfferId",
    "sortIndex": 1
  },
  "barcode": {
    "type": "QR_CODE",
    "value": "QR code"
  },
  "accountId": "Account id",
  "accountName": "Account name",
  "loyaltyPoints": {
  "label": "Points",
    "balance": {
      "int": 800
    }
  }
}

offerObject = {
  "classId": "ISSUER_ID.OFFER_CLASS_SUFFIX",
  "id": "ISSUER_ID.OFFER_OBJECT_SUFFIX",
  "state": "ACTIVE",
  "groupingInfo": {
    # Note the same groupingId value
    "groupingId": "combinedGiftCardAndOfferId",
    "sortIndex": 2
  },
  "barcode": {
      "type": "QR_CODE",
      "value": "QR code",
  },
}

Regroupement automatique des cartes d'embarquement

Remarque : La propriété groupingInfo d'une carte prévaut toujours sur la logique de regroupement automatique utilisée par les cartes d'embarquement.

Les cartes d'embarquement sont parfois utilisées au sein d'un groupe plutôt qu'individuellement. L'un des scénarios courants est le regroupement des billets pour les vols avec escales ou avec plusieurs étapes.

Les cartes d'embarquement appliquent une logique supplémentaire qui regroupe automatiquement les cartes si elles partagent les mêmes valeurs pour les propriétés suivantes :

• FlightClass.flightHeader.carrier.carrierIataCode
• FlightClass.flightHeader.flightNumber
• FlightClass.localScheduledDepartureDateTime
• FlightObject.reservationInfo.confirmationCode
• Section d'ID de l'émetteur de FlightObject.id

Si certaines des propriétés ci-dessus sont différentes pour deux cartes d'embarquement, elles ne sont pas regroupées (sauf si vous vous en chargez avec groupingInfo). Comme vous pouvez le constater, les propriétés de classe et d'objet influent sur le regroupement automatique. Des cartes d'embarquement de classes différentes peuvent ainsi être regroupées (par exemple, lorsque des vols du même voyage sont opérés par différents transporteurs).