Agrupar vários cartões

Usar um ID de agrupamento

Por padrão, adicionar vários cartões a um único link Adicionar à Carteira do Google não vai agrupá-los no app Carteira do Google do usuário. No entanto, os cartões podem ser agrupados garantindo que todos tenham o mesmo ID de agrupamento. Os cartões agrupados vão aparecer juntos no app Carteira do Google. Quando um grupo de cartões for selecionado, cada cartão será mostrado em um carrossel.

Os cartões podem ser agrupados:

  • durante o provisionamento inicial;
  • usando os métodos update ou patch.

Para adicionar um cartão a um grupo, a propriedade groupingInfo.groupingId do objeto do cartão precisa ser definida. Todos os objetos dos cartões com o mesmo valor groupingId serão agrupados automaticamente, mesmo se eles foram adicionados separadamente.

O exemplo a seguir mostra um cartão de fidelidade e uma oferta sendo agrupados para convencer o usuário a fazer o uso de ambos na próxima compra.

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