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

Фон

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

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

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

Шаг 1. Разрешите часто летающему пассажиру добавить карту постоянного клиента в Кошелек.

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

Рекомендации

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

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

Что нужно учитывать при использовании автоматически связанных карт

• Основной и связанный объекты должны использовать один и тот же issuerId.
• Автоматическая отправка связанных карт не гарантируется и выполняется по мере возможности. Пользователи могут отказаться от получения автоматически связанных карт. Если карта важна и пользователь должен ее получить, рекомендуем связаться с ним по другому каналу, чтобы убедиться, что он добавил карту.
• В обновленных правилах допустимого использования Google Кошелька есть рекомендации по использованию автоматически связанных карт и билетов, которым необходимо следовать.

Интеграция инструментов

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

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

Чтобы задать linkedObjectIds для основной карты, требуется минимальная полезная нагрузка. Три обязательных параметра:

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

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

  …
  {
    "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 могут возникать ошибки, в том числе:

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