Автоматически связанные карты

Фон

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

• Билеты на мероприятия
• Посадочный талон
• Проездной билет
• Предложение
• Подарочная карта
• Карта лояльности
• Стандартная карта

Основная карта с уведомлением о том, что добавлена новая карта	Новая карта связана с основной

Примеры использования

Связывание карт может быть полезно в разных случаях. Вот несколько примеров:

• Свяжите предложение с существующей картой постоянного клиента.
• Свяжите ваучер на питание с посадочным талоном или билетом на мероприятие.
• Свяжите парковочный абонемент с билетом на мероприятие.

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

• Основной и связанный объекты должны использовать один и тот же issuerId.
• Для каждого основного объекта можно создать не более 50 связанных объектов.
• Автоматическая отправка связанных карт не гарантируется и выполняется по мере возможности. Пользователи могут отказаться от получения автоматически связанных карт. Если карта важна и пользователь должен ее получить, рекомендуем связаться с ним по другому каналу, чтобы убедиться, что он добавил карту.
• В обновленных правилах допустимого использования 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.
У связанного объекта уже есть другой связанный объект. Нельзя добавлять вложенные связанные объекты.	Связанные объекты не могут иметь другие связанные объекты.
Объект уже связан с другим объектом. Нельзя добавлять вложенные связанные объекты.	Основной объект не может быть связанным объектом.
Нельзя добавить больше связанных объектов, так как превышен лимит.	Для основной карты достигнут лимит в 50 связанных карт.