Casos de uso

Neste guia, descrevemos as seguintes maneiras específicas de usar a API Google Pay for Passes a fim de engajar os clientes na vertical de ingressos para eventos:

Fazer um botão para salvar vários cartões

Para usuários que compram vários cartões e querem salvar todos eles no Google Pay, é útil que eles possam salvar muitos objetos com um clique do botão ou link Salvar no Google Pay. Vários objetos ou classes podem ser definidos no JSON Web Token (JWT) a ser assinado.

O JWT deve ser feito em um dos seguintes formatos:

  • Usando apenas classes e objetos pré-inseridos.
  • Usando somente recursos de objeto e classe que são totalmente definidos dentro do JWT.

Para ver um exemplo de como criar um botão para vários cartões, consulte o botão Salvar vários participantes. Para mais informações sobre a representação da interface do usuário de cartões, consulte Ingressos de eventos para grupos.

Ingressos de eventos para grupos

Se houver objetos EventTicketObject que atendam a determinadas condições, o app Google Pay os identificará como um grupo. Isso pode ser feito com ou sem a propriedade class.eventID.

Há recursos que funcionarão de maneira diferente se forem usados em um grupo, em vez de objetos individuais, como notificações de status ou organização de vários cartões salvos para muitos convidados na interface do usuário.

Grupo com class.eventId

A propriedade class.eventId pode agrupar ingressos, independentemente de outras propriedades. Por exemplo, se dois objetos EventTicketObject tiverem class.eventId = "foo", mesmo se tiverem class.eventName e class.dateTime.start, ambos serão considerados em um grupo.

Quando class.eventID é usado, os objetos só exigem que as propriedades a seguir sejam consistentes para serem consideradas como um grupo.

  • Código do emissor (da API Google Pay for Passes Merchant Center)
  • class.eventId

Agrupamento sem class.eventId

Se class.eventId não estiver definido para objetos EventTicketObject, eles só serão considerados um grupo se todas as propriedades listadas abaixo forem iguais:

  • Código do emissor (da API Google Pay for Passes Merchant Center)
  • class.eventName
  • class.dateTime.start

Notificação do próximo evento

O Google Pay envia uma notificação ao usuário três horas antes do evento. O horário de início é estabelecido por class.dateTime.start.

Para receber essa notificação, o usuário precisa ativar as notificações. Para isso, é preciso navegar para Configurações > Notificações e ativar Atualizações sobre seus cartões.

A notificação é mostrada em dois lugares: na tela de bloqueio e na área de notificações.

Tela de bloqueio

Se o usuário tiver notificações ativadas na tela de bloqueio, ele receberá a notificação de status no seguinte formato não modificável:
Your upcoming event
Expand for more options

Se ele tocar na notificação e desbloquear o dispositivo, o cartão será exibido no app Google Pay.

Se o usuário tiver vários cartões, somente aquele que for usado mais rapidamente será mostrado. Se ele salvou vários ingressos de eventos, conforme Agrupar vários ingressos de eventos, a notificação mostra apenas um dos cartões no grupo. No entanto, o usuário pode deslizar para a esquerda e para a direita depois de tocar na notificação para ver os outros cartões agrupados.

Área de notificações

A notificação mostra o código de barras e outras opções. O usuário pode tocar nele para ver o cartão no app Google Pay.

Uma notificação de status não será dispensada automaticamente depois que um usuário a abrir. A dispensa automática ocorrerá 60 minutos depois do horário de término do evento. Se nenhum horário class.dateTime.end for informado, será usado class.dateTime.start.

Gerenciar cartões expirados

Na guia "Cartões" do aplicativo do Google Pay, há uma seção "Cartões expirados" que contém todos os cartões arquivados ou inativos. Um ingresso de evento será movido para a seção "Cartões expirados" se pelo menos uma das seguintes condições for verdadeira:

  • O object.validTimeInterval.end.date do ingresso de evento terminou. O cartão será movido para "Cartões expirados" a qualquer momento em até 24 horas após object.validTimeInterval.end.date.
  • Passaram-se pelo menos 72 horas desde o class.dateTime.end do ingresso de evento. Se class.dateTime.end não foi especificado, class.dateTime.start será usado.
  • O campo state do EventTicketObject está marcado como Expired, Inactive ou Completed.

Depois que o usuário salvar um cartão, faça referência ao atributo objectId dele para definir um direcionamento para o cartão.

Use o link a seguir para fazer referência ao cartão:

https://pay.google.com/gp/v/object/{<issuerId>}.{<ObjectId>}

O cartão pode ser exibido no app Google Pay ou em um navegador da Web.