Procédure d'intégration des émetteurs pour les billets Motics dans Google Wallet

Ce document décrit les étapes à suivre par un opérateur de transports en commun l'intégrateur système, désigné ci-après par le terme "émetteur", doit fournir une Implémentation de Motics dans Google Wallet.

1. Remplir les conditions préalables

  • Signez un accord de non-divulgation (NDA) avec Google. Cet e-mail d'acceptation est partagé par l'équipe Business Development (BD) de Google.
  • Intégrez l'API Google Wallet standard pour les codes QR: <ph type="x-smartling-placeholder">
      </ph>
    • L'émetteur utilise l'API Google Wallet pour provisionner les cartes et les ajouter à dans l'application Google Wallet d'un utilisateur. Lisez les codes QR pour les transports en commun. de la documentation et de remplir les conditions préalables nécessaires à l'intégration l'API.
  • Inscrivez-vous auprès du service VDV eTicket pour obtenir un ownerId (orgId) et le informations PKI pertinentes requises pour Motics.

2. Implémentation technique

L'étape 2 contient les principaux détails de la mise en œuvre technique, qui doivent être développés en parallèle.

Mettre à niveau votre implémentation de l'API Google Wallet

La page Détails techniques décrit les méthodes et paramètres définis par l'émetteur. doit utiliser et mettre à jour pour l'intégration Motics. Plus précisément, l'émetteur doit appeler les méthodes suivantes de l'API Google Wallet avec des éléments Motics supplémentaires paramètres:

Implémenter le point de terminaison d'activation

Le serveur Google appelle le point de terminaison d'activation hébergé par l'émetteur. Ce déclenche la génération des données de droit d'accès statiques (sigSTB) sur l'émetteur Google Cloud. Pour en savoir plus, consultez la section Point de terminaison d'activation.

Pour offrir une bonne expérience utilisateur, l'utilisateur doit pouvoir déplacer ses éléments Motics d'un appareil à un autre, dans les limites définies par l'émetteur. Pour ce faire, l'émetteur doit implémenter le flux de déplacement et de dissociation.

Envoyer un e-mail de confirmation lors de l'enregistrement de la demande

Google exige que l'émetteur envoie un e-mail de confirmation aux utilisateurs lorsqu'ils enregistrer un billet Motics dans Google Wallet. L'e-mail de confirmation doit minimum) contiennent:

  • Liens utiles permettant aux utilisateurs de gérer leur billet (abonnement).
  • Instructions pour contacter le service client de l'émetteur.

3. Effectuer des tests d'intégration de bout en bout dans STAGING

Créez un test Google Wallet transitClass à des fins de développement et une fois que le le travail d'intégration est terminé, la solution doit être validée et testée de bout en bout à l'aide de ce transitClass de développement. Dans la méthode transitObject:Insert, définissez cert_environment sur STAGING. Tous les cas d'utilisation doivent être entièrement testés et tous les scénarios de test doivent réussir.

4. Effectuer des tests de bout en bout dans PRODUCTION

Une fois que la solution a été testée avec succès à l'aide de l'environnement STAGING, créer un transitClass de production ; Cette fois, définissez cert_environment sur PRODUCTION lors de l'insertion de transitObject. Suivre et terminer tous les tests et les instructions de la section Tests.

5. Suivez le processus de lancement et obtenir des approbations

Avant de lancer ou de commencer un pilote public, l'approbation du lancement complet doit avoir par Google. L'approbation dépend du résultat des différentes les phases de test et d'autres facteurs tels que, mais sans s'y limiter, suivants, qui doivent être examinés et approuvés par Google:

  • Champ d'application global du lancement et planifier <ph type="x-smartling-placeholder">
      </ph>
    • Dans le cas d'un pilote, le plan de lancement doit inclure des critères de sortie clairs et les délais pour procéder à un lancement complet.
  • Activités marketing planifiées
  • Communications de lancement
  • Date de lancement
  • Chronologie du jour du lancement et processus de remontée et contacts
  • Procédures d'assistance aux utilisateurs finaux