Agrupar vários cartões de embarque

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 forma de pagamento será ser mostrada 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",
  },
}

Agrupamento automático de cartões de embarque

Observação: a propriedade groupingInfo de um cartão sempre vai prevalecer sobre a lógica de agrupamento automático usada por ingressos de um evento.

Às vezes, os cartões de embarque são usados em grupo e não individualmente. Um comum cenário para isso é o agrupamento de passagens para voos com escala ou várias paradas.

Os cartões de embarque têm uma lógica adicional que agrupa automaticamente os cartões se tiverem os mesmos valores para as seguintes propriedades:

• FlightClass.flightHeader.carrier.carrierIataCode
• FlightClass.flightHeader.flightNumber
• FlightClass.localScheduledDepartureDateTime
• FlightObject.reservationInfo.confirmationCode
• A parte do ID do emissor de FlightObject.id

Se alguma das propriedades acima for diferente para dois cartões de embarque, elas não serão agrupadas (a menos que você faça isso usando groupingInfo). Como você pode conferir, as classes e as propriedades do objeto afetam o agrupamento automático. Isso permite o agrupamento de cartões de embarque de diferentes classes (como quando diferentes voos na mesma viagem têm companhias aéreas diferentes).