Автоматическое добавление посадочных талонов

Фон

Эта функция позволяет авиакомпаниям автоматически отправлять посадочные талоны в Google Wallet пользователя. Это особенно удобно для часто летающих пассажиров, которым понравится более простой и удобный способ добавления посадочных талонов в Wallet, учитывая частоту их поездок.

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

Как работает эта функция

Шаг 1: Предоставьте часто летающему пользователю возможность добавить свой абонемент участника программы лояльности в Wallet.

Шаг 2: Автоматически добавляйте новые посадочные талоны для часто летающих пассажиров, привязывая их к их карте лояльности в Wallet.

Передовые методы

• Для обеспечения беспрепятственной регистрации в программе лояльности для часто летающих пассажиров рассмотрите возможность включения процесса регистрации/входа через Google . В этом случае пользователи смогут найти страницу регистрации в программе лояльности вашей авиакомпании в различных точках доступа в Google Wallet, включая посадочные талоны.
• Рассмотрите возможность включения функции регистрации в программе лояльности в один клик для существующих участников программы в вашем приложении для Android и на веб-сайте.

Примечание: Эта функция представляет собой специфическую реализацию возможности автоматического связывания пропусков. В данном контексте основной пропуск — это карта лояльности, а связанный пропуск — посадочный талон. В остальной части документа для описания этой функциональности используется более общая терминология — автоматическое связывание пропусков, основной пропуск и связанный пропуск.

Некоторые моменты, которые следует учитывать при использовании автоматически связанных пропусков.

• Основной объект и связанный объект должны использовать один и тот же идентификатор эмитента (summerId).
• Автоматическая отправка связанных пропусков не гарантируется и считается «максимально возможной». Пользователи могут отказаться от получения автоматически связанных пропусков. Если сценарий использования критически важен и пользователю необходимо получить связанный пропуск, мы рекомендуем связаться с ним по другому каналу, чтобы убедиться, что он добавит пропуск.
• В обновленную версию правил использования Google Wallet включены рекомендации по использованию автоматически связанных пропусков, которые необходимо соблюдать.

Этапы интеграции

Если вы уже создали основной объект, можете пропустить шаг 1.

1. Создайте объект любого из перечисленных типов проходов с необходимыми параметрами. Это будет основной объект.
2. Создайте еще один объект любого из перечисленных типов проходов. Он будет связанным объектом.
3. До или после сохранения основного объекта обновите основной объект, указав в параметре linkedObjectIds идентификатор связанного объекта.

Для установки идентификаторов связанных объектов (linkedObjectIds) на первом этапе требуется минимальный объем полезной нагрузки. К числу обязательных параметров относятся:

1. ISSUERID.PRIMARY_OBJECT_ID
2. ISSUERID.PRIMARY_CLASS_ID
3. ISSUERID.LINKED_OBJECT_ID

Пример JSON-запроса для добавления связанного объекта к объекту pass.

  …
  {
    "id": "ISSUERID.PASS_OBJECTID",
    "classId": "ISSUERID.PASS_CLASSID",
    "barcode": {
      "type": "qrCode",
      "value": "QR code"
    },
    "linkedObjectIds": ["ISSUERID.LINKED_PASS_OBJECTID"]
  }
  …

Пример JSON-ответа после связывания объекта с объектом передачи.

  …
  "state": "active",
  "linkedObjectIds": {
    "ISSUERID.LINKED_PASS_OBJECTID"
  }
  …

Обработка исключений

Возможны ошибки, возникающие при неправильном использовании API, в том числе:

Сообщение	Причина
Основной объект и связанный объект не имеют одинакового идентификатора эмитента.	Нельзя прикрепить связанный объект к объекту другого эмитента.
Основной объект и связанный объект относятся к одному и тому же объекту.	Нельзя прикрепить тот же объект, что и связанный объект.
Связанный объект не существует.	Связанный объект уже должен быть вставлен в Wallet API.
Связанный объект уже имеет другой связанный объект. Невозможно добавить вложенные связанные объекты.	Связанные объекты не могут иметь другие связанные объекты.
Объект уже связан с другим объектом. Невозможно добавить вложенные связанные объекты.	Основной объект не может быть связанным объектом сам по себе.