Agrupar vários cartões

Usar um ID de agrupamento

Por padrão, adicionar vários cartões a um único Adicionar à Carteira do Google não agrupa esses cartões na app Carteira do Google de um usuário. No entanto, os cartões podem ser agrupados garantir 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 é selecionado, cada um deles ser mostrados em um carrossel.

Os cartões podem ser agrupados:

  • Durante o provisionamento inicial
  • Ao usar o método update ou patch métodos

Para adicionar um cartão a um grupo, a propriedade groupingInfo.groupingId do o objeto do cartão precisa ser definido. Todos os objetos de cartão com o mesmo O valor groupingId será agrupado automaticamente, mesmo que eles foram adicionados separadamente.

O exemplo a seguir mostra um cartão de fidelidade e uma oferta sendo agrupados para motivar o usuário a usar 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",
  },
}