Esta página descreve a implementação de um fluxo de transferência e desvinculação de tíquete para a Motics bilhetes. Para oferecer uma boa experiência ao usuário, ele deve ser capaz de mover seus bilhete móvel de um dispositivo para outro, dentro de determinados limites definidos pelo emissor. O emissor precisa restringir um tíquete a um dispositivo. O usuário deve excluir do tíquete original antes de salvá-lo em um novo dispositivo. Se o usuário não puder excluir o tíquete original (talvez por ter perdido o dispositivo), o emissor deve desvincule o ingresso do dispositivo antigo.
Mover e Desvincular requisitos de fluxo
The Move & O fluxo de desvinculação precisa atender aos seguintes requisitos:
- Um bilhete da Motics só pode ser usado em um dispositivo por vez.
- O usuário precisa conseguir mover o tíquete do Motics para um novo dispositivo nestes
casos:
- Acesso a dispositivos antigos, por exemplo, ao fazer upgrade para um dispositivo novo
- Sem acesso a um dispositivo antigo, por exemplo, se ele for perdido ou roubado.
- O número de jogadas ou ativações de ingressos precisa ser limitado de acordo com as controles do emissor de tíquetes da Motics, conforme definido pelo departamento de negócios do PTO e cumprimento de requisitos regulatórios.
Experiência do usuário
Esta seção descreve com mais detalhes os dois cenários diferentes para o Usuário Experiência, dependendo de o usuário ainda ter acesso ao dispositivo antigo ao tentar transferir um tíquete da Motics.
O usuário tem acesso ao dispositivo antigo
Nesses casos, o usuário pode iniciar o fluxo de transferência no dispositivo antigo:
- O usuário exclui o ingresso da Motics do app Carteira no dispositivo antigo.
- O usuário encontra o e-mail de confirmação do emissor no novo dispositivo ou faz login na loja on-line ou no portal de ingressos e clica no botão "Salvar em" Link da Carteira do Google para salvar a passagem novamente no app Carteira do Google.
O usuário não tem acesso ao dispositivo antigo
Quando o usuário não tem acesso ao dispositivo antigo, precisa iniciar o fluxo de desvinculação e movimentação do portal de ingressos da loja on-line ou Entrar em contato com o suporte ao cliente do emissor, que pode iniciar o fluxo de desvinculação em nome do usuário.
- O usuário encontra o e-mail de confirmação do emissor com instruções para ligue para o atendimento ao cliente para receber ajuda ou inicie um fluxo de desvinculação do o site do emissor ou o portal de ingressos. Pode ser um botão "Desvincular" na página portal de ingressos.
- O emissor desvincula o ingresso do dispositivo antigo em nome do usuário Veja mais detalhes na seção Responsabilidades do emissor.
- O ingresso não poderá ser usado (o código de barras não será lido) no dispositivo original como assim que o emissor o desvincular.
- O emissor precisa colocar o tíquete antigo na lista de bloqueio para garantir que ele não possa mais ser verificados por dispositivos de inspeção.
- O ingresso será excluído automaticamente do dispositivo original assim que ele ficar on-line novamente (melhor esforço).
- O usuário encontra o e-mail de confirmação do emissor no novo dispositivo ou faz login na loja on-line ou no portal de ingressos e clica no botão "Salvar em" Link da Carteira do Google para salvar a passagem novamente no app Carteira do Google.
Responsabilidades do emissor
- Durante a configuração inicial, o emissor precisa inserir a transitClass com
multipleDevicesAndHoldersAllowedStatus=ONE_USER_ONE_DEVICE
- O e-mail de confirmação que o emissor envia ao usuário no momento da compra precisa conter instruções sobre como transferir a passagem para um novo dispositivo.
- O e-mail de confirmação deve conter um identificador do ingresso para a ajudar no processo de suporte.
- Para manter o volume de contatos no mínimo, o emissor também precisa ter uma desvinculação em sua loja on-line ou portal de ingressos, onde um usuário pode gerenciar ingresso.
- O emissor é responsável por limitar o número de vezes que um tíquete pode ser
ativado. Isso evita que os usuários troquem o mesmo tíquete de um lado para outro.
entre dispositivos (ambos conectados à mesma conta na Google Wallet) indefinidamente.
- O emissor precisa monitorar quantas vezes o endpoint de ativação é chamado para o mesmo objectId e rejeitar a solicitação de ativação se ela excede o limite.
- Como cada emissor tem regras próprias sobre quantas vezes um bilhete pode ser movidos, o Google exige que os emissores lidem com a limitação de movimentação de ingressos seu fim.
- Se o usuário quiser desvincular o tíquete entrando em contato com o suporte ao cliente:
- Se o usuário não puder remover o ingresso do dispositivo antigo, o emissor
desvincula o tíquete chamando
transitObject:patch
com{hasLinkedDevice:false}
para oobjectId
do ingresso.- O emissor precisará encontrar o objectId do tíquete fornecido. Eles deve procurá-lo com base no identificador dado ao usuário no e-mail de confirmação.
- Se o usuário não puder remover o ingresso do dispositivo antigo, o emissor
desvincula o tíquete chamando
- Se o usuário iniciar o fluxo de desvinculação na loja on-line ou no portal de ingressos:
- O emissor desvincula o tíquete chamando
transitObject:patch
com{hasLinkedDevice:false}
para oobjectId
do ingresso.
- O emissor desvincula o tíquete chamando
- O emissor precisa colocar o tíquete antigo na lista de bloqueio para que ele não possa mais ser verificados por dispositivos de inspeção.
Responsabilidades do Google
Em resposta ao recebimento do transitObject:patch
com
{hasLinkedDevice:false}
, o Google revogará o certificado existente (se
existe uma) com o servidor Motics. Se o usuário ainda tiver a conta antiga
dispositivo com o ingresso original, o código de barras não funcionará mais, como
excluído do dispositivo antigo, desde que ele esteja on-line ou volte a ficar on-line.
Diagrama de sequência
Figura 1. Fluxo de desvinculação do tíquete da Motics
A Figura 1 mostra as chamadas transitObject:patch
e pruneTree()
que ocorrem.
para desvincular um tíquete quando o usuário não tiver mais acesso ao dispositivo antigo.