Как перенести билеты Motics в Google Кошелек и отменить связь с ними

На этой странице описано, как реализовать перенос и отмену связи для билетов Motics. Чтобы пользователям было удобно, у них должна быть возможность переносить билеты Motics с одного устройства на другое в пределах ограничений, установленных эмитентом. Эмитент должен ограничить использование билета одним устройством. Чтобы сохранить билет на новом устройстве, пользователь должен удалить его с предыдущего. Если пользователь не может удалить исходный билет (например, из-за потери устройства), эмитент должен отменить связь билета со старым устройством.

Процесс переноса и отмены связи должен соответствовать следующим требованиям:

  • Билет Motics можно использовать только на одном устройстве одновременно.
  • Пользователь должен иметь возможность перенести билет Motics на новое устройство в следующих случаях:
    • Доступ к старому устройству, например при переходе на новое.
    • У вас нет доступа к старому устройству, например оно потеряно или украдено.
  • Количество переносов или активаций билетов должно быть ограничено соответствующими элементами управления на стороне эмитента билетов Motics, как определено бизнес-требованиями PTO.

Удобство для пользователей

В этом разделе подробно описаны два сценария взаимодействия с пользователем в зависимости от того, есть ли у него доступ к старому устройству при попытке перенести билет Motics.

У пользователя есть доступ к старому устройству

В таких случаях пользователь может запустить процесс переноса со своего старого устройства:

  1. Пользователь удаляет билет Motics из приложения "Кошелек" на старом устройстве.
  2. Пользователь находит письмо с подтверждением от эмитента на новом устройстве или входит в аккаунт на сайте или портале по продаже билетов и нажимает на ссылку "Сохранить в Google Кошельке", чтобы повторно сохранить билет в приложении "Google Кошелек".

У пользователя нет доступа к старому устройству

Если у пользователя нет доступа к старому устройству, он должен инициировать отмену связи и перенос билета на портале продажи билетов или обратиться в службу поддержки эмитента, которая может инициировать отмену связи от имени пользователя.

  1. Пользователь находит письмо с подтверждением от эмитента, в котором есть инструкции о том, как позвонить в службу поддержки, или начинает процесс отмены связи на сайте эмитента или портале продажи билетов. Например, это может быть кнопка отмены связи на портале продажи билетов.
  2. Эмитент отменяет связь билета со старым устройством от имени пользователя. Подробнее об этом рассказывается в разделе Обязанности эмитента.
  3. Как только эмитент отменит связь, билет станет непригодным для использования на исходном устройстве (штрихкод не будет сканироваться).
  4. Эмитент должен добавить старый билет в черный список, чтобы его нельзя было отсканировать на устройствах проверки.
  5. Билет будет автоматически удален с исходного устройства, как только оно снова подключится к интернету.
  6. Пользователь находит письмо с подтверждением от эмитента на новом устройстве или входит в билетный интернет-магазин или на портал и нажимает на ссылку "Сохранить в Google Кошельке", чтобы повторно сохранить билет в приложении "Google Кошелек".

Обязанности эмитента

  • При первоначальной настройке эмитент должен вставить transitClass с multipleDevicesAndHoldersAllowedStatus=ONE_USER_ONE_DEVICE.
  • В письме с подтверждением, которое эмитент отправляет пользователю при покупке, должны быть инструкции о том, как перенести билет на новое устройство.
  • В письме с подтверждением должен быть идентификатор запроса, который поможет в процессе поддержки.
  • Чтобы минимизировать количество обращений, эмитенту также следует добавить кнопку отмены связи в интернет-магазин или на портал продажи билетов, где пользователь может управлять своим билетом.
  • Эмитент несет ответственность за ограничение количества активаций билета. Это сделано для того, чтобы пользователи не могли бесконечно перемещать один и тот же билет между устройствами, на которых выполнен вход в один и тот же аккаунт Кошелька.
    • Эмитент должен отслеживать, сколько раз конечная точка активации вызывается для одного и того же objectId, и отклонять запрос на активацию, если лимит превышен.
    • У каждого эмитента свои правила в отношении того, сколько раз можно перенести билет. Поэтому Google требует, чтобы эмитенты сами ограничивали количество переносов.
  • Если пользователь хочет отменить связь с билетом, обратившись в службу поддержки:
    • Если пользователь не может удалить билет со старого устройства, эмитент отменяет связь с билетом, вызывая transitObject:patch с {hasLinkedDevice:false} для objectId билета.
      • Эмитент должен найти objectId для нужного билета. Для этого нужно использовать идентификатор, указанный в письме с подтверждением.
  • Если пользователь инициирует отмену связи в интернет-магазине или на портале продажи билетов:
    • Эмитент отменяет связь билета, вызывая transitObject:patch с {hasLinkedDevice:false} для objectId билета.
  • Эмитент должен добавить старый билет в черный список, чтобы его нельзя было отсканировать на контроле.

Обязанности Google

В ответ на вызов transitObject:patch с {hasLinkedDevice:false} Google отзовет существующий сертификат (если он есть) с сервера Motics. Если у пользователя все ещё есть старое устройство с исходным билетом, штрихкод больше не будет работать, поскольку он будет удален со старого устройства, как только оно подключится к интернету.

Диаграмма последовательности

Рисунок 1. Motics Ticket Unlink Flow Процесс отмены связи с билетом Motics

На рисунке 1 показаны вызовы transitObject:patch и pruneTree(), которые выполняются для отмены связи с билетом, когда у пользователя больше нет доступа к старому устройству.