На этой странице описано, как реализовать перенос и отмену связи для билетов Motics. Чтобы пользователям было удобно, у них должна быть возможность переносить билеты Motics с одного устройства на другое в пределах ограничений, установленных эмитентом. Эмитент должен ограничить использование билета одним устройством. Чтобы сохранить билет на новом устройстве, пользователь должен удалить его с предыдущего. Если пользователь не может удалить исходный билет (например, из-за потери устройства), эмитент должен отменить связь билета со старым устройством.
Требования к переносу и отмене связи
Процесс переноса и отмены связи должен соответствовать следующим требованиям:
- Билет Motics можно использовать только на одном устройстве одновременно.
- Пользователь должен иметь возможность перенести билет Motics на новое устройство в следующих случаях:
- Доступ к старому устройству, например при переходе на новое.
- У вас нет доступа к старому устройству, например оно потеряно или украдено.
- Количество переносов или активаций билетов должно быть ограничено соответствующими элементами управления на стороне эмитента билетов Motics, как определено бизнес-требованиями PTO.
Удобство для пользователей
В этом разделе подробно описаны два сценария взаимодействия с пользователем в зависимости от того, есть ли у него доступ к старому устройству при попытке перенести билет Motics.
У пользователя есть доступ к старому устройству
В таких случаях пользователь может запустить процесс переноса со своего старого устройства:
- Пользователь удаляет билет Motics из приложения "Кошелек" на старом устройстве.
- Пользователь находит письмо с подтверждением от эмитента на новом устройстве или входит в аккаунт на сайте или портале по продаже билетов и нажимает на ссылку "Сохранить в Google Кошельке", чтобы повторно сохранить билет в приложении "Google Кошелек".
У пользователя нет доступа к старому устройству
Если у пользователя нет доступа к старому устройству, он должен инициировать отмену связи и перенос билета на портале продажи билетов или обратиться в службу поддержки эмитента, которая может инициировать отмену связи от имени пользователя.
- Пользователь находит письмо с подтверждением от эмитента, в котором есть инструкции о том, как позвонить в службу поддержки, или начинает процесс отмены связи на сайте эмитента или портале продажи билетов. Например, это может быть кнопка отмены связи на портале продажи билетов.
- Эмитент отменяет связь билета со старым устройством от имени пользователя. Подробнее об этом рассказывается в разделе Обязанности эмитента.
- Как только эмитент отменит связь, билет станет непригодным для использования на исходном устройстве (штрихкод не будет сканироваться).
- Эмитент должен добавить старый билет в черный список, чтобы его нельзя было отсканировать на устройствах проверки.
- Билет будет автоматически удален с исходного устройства, как только оно снова подключится к интернету.
- Пользователь находит письмо с подтверждением от эмитента на новом устройстве или входит в билетный интернет-магазин или на портал и нажимает на ссылку "Сохранить в 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
На рисунке 1 показаны вызовы transitObject:patch и pruneTree(), которые выполняются для отмены связи с билетом, когда у пользователя больше нет доступа к старому устройству.