Regrouper plusieurs cartes

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",
  },
}