Adicionar automaticamente cartões de embarque

Contexto

Com esse recurso, as companhias aéreas podem enviar automaticamente cartões de embarque para a Carteira do Google de um usuário. Isso vai beneficiar principalmente viajantes frequentes, que vão aproveitar um método mais simples e com menos atrito para adicionar cartões de embarque à Carteira devido à maior frequência de viagens.

Isso acontece automaticamente, seja qual for o canal de check-in (por exemplo, Web, app ou quiosque do aeroporto). A companhia aérea usa o número da conta de fidelidade do usuário para correlacionar e enviar o cartão.

Observação: esse recurso é uma implementação específica da capacidade "Passagens vinculadas automaticamente". O restante do documento usa a terminologia mais ampla "Passes vinculados automaticamente", além de "passe principal" e "passe vinculado" para descrever essa funcionalidade.

Como esse recurso funciona

Etapa 1: permitir que o viajante frequente adicione o cartão de fidelidade à Carteira.

Etapa 2: vincule os novos cartões de embarque ao cartão de fidelidade na Carteira para adicioná-los automaticamente ao programa de passageiro frequente.

Algumas considerações ao usar passes vinculados automaticamente

• O objeto principal e o objeto vinculado precisam usar o mesmo issuerId.
• Há um limite de 50 objetos vinculados por objeto principal.
• O envio automático de cartões vinculados não é garantido e é considerado de melhor esforço. Os usuários podem desativar o recebimento de cartões vinculados automaticamente. Se o caso de uso for crítico e o usuário precisar receber o cartão vinculado, recomendamos comunicar por outro canal para garantir que ele adicione o cartão.
• As atualizações na Política de uso aceitável da Carteira do Google incluem orientações sobre o uso de cartões vinculados automaticamente, que precisam ser seguidas.

Etapas de integração

Se você já tiver criado um objeto primário, pule a etapa 1.

1. Crie um objeto de qualquer tipo de cartão listado com os parâmetros obrigatórios. Esse é o objeto principal.
2. Crie outro objeto de qualquer tipo de cartão listado. Esse será o objeto vinculado.
3. Antes ou depois de salvar o objeto principal, atualize o objeto principal com o ID do objeto vinculado no parâmetro linkedObjectIds.

Há uma carga útil mínima necessária para definir os linkedObjectIds em um cartão principal. Os três parâmetros obrigatórios incluem:

1. ISSUERID.PRIMARY_OBJECT_ID
2. ISSUERID.PRIMARY_CLASS_ID
3. ISSUERID.LINKED_OBJECT_ID

Exemplo de solicitação JSON para adicionar um objeto vinculado a um objeto de cartão

  …
  {
    "id": "ISSUERID.PASS_OBJECTID",
    "classId": "ISSUERID.PASS_CLASSID",
    "barcode": {
      "type": "qrCode",
      "value": "QR code"
    },
    "linkedObjectIds": ["ISSUERID.LINKED_PASS_OBJECTID"]
  }
  …

Exemplo de resposta JSON após vincular um objeto a um objeto de cartão

  …
  "state": "active",
  "linkedObjectIds": {
    "ISSUERID.LINKED_PASS_OBJECTID"
  }
  …

Comportamento esperado

Depois de receber uma resposta de sucesso, os dispositivos com o cartão atualizado vão receber o cartão vinculado. O cartão vinculado será agrupado com o cartão principal. Os usuários podem ver o cartão vinculado deslizando para a direita.

Como processar exceções

Erros podem ocorrer com o uso incorreto da API, incluindo: