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 terão um método mais simples e fácil de adicionar os cartões de embarque à Carteira, já que viajam com mais frequência.

Isso acontece automaticamente, independente do canal de check-in (por exemplo, Web, app ou quiosque do aeroporto). As companhias aéreas parceiras podem usar o número da conta de fidelidade do usuário para correlacionar e enviar o cartão para a Carteira.

Como esse recurso funciona

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

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

Práticas recomendadas

• Para ativar a inscrição no programa de fidelidade sem problemas para passageiros frequentes, considere ativar um fluxo de inscrição / login com o Google. Os usuários poderão descobrir o fluxo de inscrição no programa de fidelidade da sua companhia aérea em vários pontos de entrada na Carteira do Google, incluindo cartões de embarque.
• Considere ativar a inscrição com um clique para membros atuais do programa de fidelidade no seu app Android e site.

Observação: esse recurso é uma implementação específica da capacidade de passes vinculados automaticamente. Nesse contexto, o cartão principal é um cartão de fidelidade, e o cartão vinculado é um cartão de embarque. O restante deste documento usa a terminologia mais ampla (cartões vinculados automaticamente, cartão principal e cartão vinculado) para descrever essa funcionalidade.

Algumas considerações ao usar passes vinculados automaticamente

• O objeto principal e o objeto vinculado precisam usar o mesmo issuerId.
• 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 da 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. Este é 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 uma passagem primária. 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"
  }
  …

Como processar exceções

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

Mensagem	Motivo
O objeto principal e o objeto vinculado não compartilham o mesmo ID do emissor.	Não é possível anexar um objeto vinculado ao objeto de outro emissor.
O objeto principal e o objeto vinculado se referem ao mesmo objeto.	Não é possível anexar o mesmo objeto como linkedObject.
O objeto vinculado não existe.	O objeto vinculado já precisa estar inserido na API Carteira.
O objeto vinculado já tem outro objeto vinculado. Não é possível adicionar objetos vinculados aninhados.	Objetos vinculados não podem ter outro objeto vinculado.
O objeto já está vinculado a outro objeto. Não é possível adicionar objetos vinculados aninhados.	O objeto principal não pode ser um objeto vinculado por si só.