Este documento discute as etapas que um operador de transporte público (PTO, na sigla em inglês) faz e as integrador de sistemas, aqui chamado de emissor, precisa fazer para fornecer uma Implementação do Motics na Carteira do Google.
1. Atender aos pré-requisitos
- Assinar um contrato de confidencialidade (NDA) com o Google. Essa opção do tipo "clicar para aceitar" formulário on-line é compartilhado pela equipe de desenvolvimento comercial (BD, na sigla em inglês) do Google.
- Integrar com a API Google Wallet padrão para QR codes:
- O emissor usa a API Google Wallet para provisionar cartões e adicioná-los ao ao app Carteira do Google de um usuário. Leia os códigos QR do Google Transit. e atender aos pré-requisitos necessários para a integração a API.
- Registre-se no VDV eTicket Service para receber um OwnerId (orgId) e o detalhes relevantes de ICP necessários para o Motics.
2. Implementação técnica
A etapa 2 contém os principais detalhes técnicos da implementação, que devem ser em paralelo.
Fazer upgrade da implementação da API Google Wallet
A página Detalhes técnicos descreve os métodos e parâmetros que o emissor precisa usar e atualizar para a integração do Motics. Especificamente, o emissor precisa chamar os seguintes métodos da API Google Wallet com outros métodos relacionados ao Motics parâmetros:
Implementar o endpoint de ativação
O servidor do Google chama o endpoint de ativação hospedado pelo emissor. Isso aciona a geração dos dados de direitos estáticos (sigSTB) no emissor servidor. Consulte a seção endpoint de ativação para mais detalhes.
Implemente a estratégia "Mover e Desvincular fluxo
Para oferecer uma boa experiência do usuário, o usuário deve ser capaz de mover seus dispositivos móveis de um dispositivo para outro, dentro de determinados limites definidos pelo emissor. Para isso, o emissor precisa implementar o fluxo para mover e desvincular.
Enviar e-mail de confirmação ao salvar a passagem
O Google exige que o emissor envie um e-mail de confirmação aos usuários quando eles salvar um ingresso da Motics na Carteira do Google. O e-mail de confirmação deve (em um mínimo) conter:
- Links úteis para que os usuários gerenciem seus ingressos (assinaturas).
- Instruções para entrar em contato com o suporte ao cliente do emissor.
3. Realizar testes de integração completos no STAGING
Crie um transitClass de teste da Carteira do Google para uso no desenvolvimento e depois que a
o trabalho de integração estiver concluído, a solução precisa ser validada e testada
completo usando este transitClass de desenvolvimento. No transitObject:Insert,
defina cert_environment como STAGING. Todos os casos de uso precisam ser totalmente testados
e todos os casos de teste
precisam ter um resultado bem-sucedido.
4. Realizar testes completos em PRODUÇÃO
Depois que a solução for testada com sucesso usando o ambiente STAGING,
criar um novo transitClass de produção. Desta vez, defina cert_environment como
PRODUCTION ao inserir o transitObject. Seguir e concluir todos os testes
casos e instruções na seção Testes.
5. Siga o processo de lançamento e obter aprovações
Antes de lançar ou iniciar um piloto público, a aprovação total do lançamento precisa ter concedidas pelo Google. A aprovação depende do resultado das várias fases de teste, bem como outros fatores como, mas não se limitando a) a seguir, que precisam ser analisados e aprovados pelo Google:
- Escopo geral do lançamento e planejar
- No caso de um piloto, o plano de lançamento deve incluir critérios de saída claros e cronogramas para prosseguir para um lançamento completo.
- Atividades de marketing planejadas
- Comunicações de lançamento
- Data de lançamento
- Cronogramas do dia do lançamento, processo de encaminhamento e contatos
- Processos de suporte ao usuário final