Как настроить интеллектуальную бесконтактную технологию с помощью API

На этой странице описано, как настроить интеллектуальную бесконтактную технологию, используя API.

Как создать аккаунт эмитента бонусов для интеллектуальной бесконтактной технологии

Чтобы создать аккаунт эмитента бонусов, выполните следующие действия:

1. Создайте аккаунт эмитента.
2. Назначьте для него один или несколько открытых ключей и одну или несколько их версий.
3. Получите автоматически сгенерированный идентификатор продавца.

Как создать аккаунт эмитента

Узнать больше о том, как создать аккаунт продавца с помощью API, можно в разделе Как автоматически создавать аккаунты эмитентов.

Чтобы создать аккаунт вручную, перейдите в Business Console.

Как назначить один или несколько открытых ключей и одну или несколько их версий.

Поставщик терминалов должен предоставить вам открытый ключ и сообщить его версию.

Примечание. Если поставщик терминалов отказывается предоставить открытый ключ до тех пор, пока вы не сообщите ему идентификатор Collector ID, воспользуйтесь временным ключом, указанным ниже.

-----BEGIN PUBLIC KEY-----\nMFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEchyXj86
9zfmKhRi9xP7f2AK07kEo\n4lE7ZlWTN14jh4YBTny+hRGRXcUzevV9zSSPJlPHpqqu5pEwlv1xyFvE1w==
\n-----END PUBLIC KEY-----\n
    

Когда вы в первый раз укажете открытый ключ, сгенерируется уникальный идентификатор Collector ID для аккаунта продавца с Redemption Issuer ID.

Удалите временный ключ, когда получите открытый ключ от поставщика терминалов.

Чтобы назначить открытые ключи и определить их версии, отправьте вызов REST в указанную конечную точку, воспользовавшись ключом авторизованного сервисного аккаунта:

PATCH https://walletobjects.googleapis.com/walletobjects/v1/issuer/<issuerid>

Важно! Значением поля smartTapMerchantData.authenticationKeys[].id должно быть десятичное число в диапазоне от 1 до 2 147 483 647 включительно. У каждого открытого ключа должна быть своя уникальная версия.

Примечание. Используйте ключ авторизованного сервисного аккаунта, который связан с аккаунтом пользователя, создавшего аккаунт эмитента.

В вызов REST необходимо включить следующие строки:

{
  "smartTapMerchantData": {
    "authenticationKeys": [{
        "id": 1,
        "publicKeyPem": "<my_public_key>"
      },
      {
        "id": 2,
        "publicKeyPem": "..."
      }
    ]
  }
}

Ответ будет содержать приведенную выше часть кода и дополнительное поле smartTapMerchantData.smartTapMerchantId. Это идентификатор Collector ID для аккаунта продавца с Redemption Issuer ID. Предоставьте поставщику терминалов и продавцу идентификатор Collector ID и сопутствующую информацию, чтобы подключить интеллектуальную бесконтактную технологию.

Подробная информация об использовании конечной точки продавца находится в Справочнике по API.

Как получить автоматически сгенерированный идентификатор Collector ID

В этом разделе описано, как получить идентификатор Collector ID. Воспользуйтесь ключом авторизованного сервисного аккаунта и отправьте вызов REST к следующей конечной точке:

GET https://walletobjects.googleapis.com/walletobjects/v1/issuer/<issuerid>

Примечание. Используйте ключ авторизованного сервисного аккаунта, который связан с аккаунтом пользователя, создавшего аккаунт продавца.

Ответ будет содержать поле smartTapMerchantData.smartTapMerchantId. Это идентификатор Collector ID для аккаунта продавца с Redemption Issuer ID. Предоставьте поставщику терминалов и продавцу идентификатор Collector ID и сопутствующую информацию, чтобы подключить интеллектуальную бесконтактную технологию.

Подробная информация об использовании конечной точки продавца находится в Справочнике по API.

Как настроить карты для интеллектуальной бесконтактной технологии

В этом разделе описано, как настроить классы и объекты, чтобы карты можно было активировать с помощью интеллектуальной бесконтактной технологии.

Если указанные ниже значения заданы верно и аккаунт с Redemption Issuer ID настроен правильно, на карте в Google Pay будет отображаться значок NFC. Чтобы принимать оплату такими картами, продавцам нужны терминалы с поддержкой интеллектуальной бесконтактной технологии.

Как настроить класс

Чтобы настроить поддержку технологии NFC для класса объектов, выполните запрос PATCH со следующими значениями:

  class.enableSmartTap = true
  class.redemptionIssuers[] = ["issuer_id_1",... ,"issuer_id_n"]

После того как вы зададите указанные выше свойства для класса, все его объекты будут поддерживать технологию NFC. Чтобы появился значок NFC, нужно настроить объект и аккаунт с Redemption Issuer ID. Подробнее об этом написано в разделе Как определить аккаунт с Redemption Issuer ID.

Предупреждение. Если вы используете класс update() в REST API, всегда вызывайте метод get() перед внесением изменений, иначе вы можете удалить свойства или задать их с ошибкой. В качестве альтернативного способа используйте patch().

Как настроить объект

Чтобы объект поддерживал технологию NFC, нужно настроить его класс. Затем требуется задать следующее значение, которое будет передаваться с вашей карты на терминал:

  object.smartTapRedemptionValue = "string value to be conveyed over NFC"

Это значение будет передаваться при использовании NFC. Более подробная информация об этом указана в разделе Передача значений карты.

Предупреждение. Если вы используете класс update() в REST API, всегда вызывайте метод get() перед внесением изменений, иначе вы можете удалить свойства или задать их с ошибкой. В качестве альтернативного способа используйте patch().