Регистрация подарочной карты пользователя

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

В этом руководстве представлен обзор шагов по реализации, необходимых для включения этой функции в вашей программе подарочных карт.

Обзор

Для начала убедитесь, что вы ранее настроили свой проект и имеете доступ к API Google Кошелька.

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

  1. Настройте тестовый класс в Google Кошельке для проверки процесса входа в систему.
  2. Разработайте страницы входа, использующие Google Wallet SharedDataType .
  3. Реализуйте возврат подарочной карты в Google Кошелек после входа в систему.
  4. Запросить проверку и активацию.

Настройте тестовый курс в Google Кошельке.

Определите URL-адрес для входа, логотип вашей программы. Затем используйте вложенные поля discoverableProgram в giftcardclass чтобы установить соответствующие значения.

Задайте значения в discoverableProgram , чтобы создать черновую версию программы подарочных карт с возможностью входа в систему. Чтобы это было видно тестировщикам, убедитесь, что у тестировщиков есть доступ к вашему Google Pay и консоли Кошелька. Подробную информацию о том, как предоставить доступ к Google Pay и консоли Кошелька другим людям, можно найти на странице «Информация о пользователях» .

Чтобы завершить проверку функциональности вашей реализации в процессе разработки, свяжитесь с нами с помощью виджета поддержки контактов в консоли Google Pay и Wallet. В консоли выберите API Google Кошелька в теме и выберите «Вход с помощью подарочной карты» в подтеме.

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

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

Вам необходимо предоставить URL-адрес для входа, по которому пользователь может войти в существующую учетную запись.

Ваша страница входа должна соответствовать следующим требованиям:

  • Обеспечьте удобный пользовательский интерфейс для мобильных устройств.
  • Разрешить пользователю завершить вход на одной странице.
  • Используйте шифрование HTTPS с действительным сертификатом, чтобы обеспечить безопасную передачу пользовательских данных.
  • Обеспечьте бесперебойную работу страницы входа не менее 99,9%.

При отображении страницы входа Google Кошелек создаст Android WebView и на указанный вами URL-адрес будет отправлен запрос POST . Пользовательские данные предоставляются в параметре SharedDataType , который включается в запрос POST с использованием типа контента application/x-www-form-urlencoded и кодировки UTF-8 . Значение параметра SharedDataType — это объект JSON в кодировке Base64.

Реализуйте немедленный возврат подарочной карты в Google Кошелек.

После аутентификации (входа в систему) ваша страница должна немедленно вернуть подарочную карту пользователя в Google Кошелек.

Вы можете вернуть подарочную карту в Google Кошелек, перенаправив на ссылку, соответствующую структуре.

https://pay.google.com/gp/v/save/{jwt_generated}

Безопасная длина URL-адреса составляет 2000 символов. Ваши ссылки должны оставаться в пределах этого лимита. Объекты, закодированные в JWT, должны быть небольшими и содержать только данные, специфичные для пользователя. Постарайтесь сохранить большую часть данных в классе объекта, создав его перед созданием JWT. Для более крупных объектов, которые не соответствуют этому пределу, рассмотрите возможность сначала создать объект в API Google Кошелька и отправить только идентификатор объекта в JWT.

Типичный поток общения

Поток общения для пользователя, завершающего вход, показан на следующем изображении. Все действия между «Вашим Сервером» являются вашей ответственностью за реализацию.

Процесс входа в систему

Запросить проверку и активацию

После завершения разработки и проверки процесса входа в систему отправьте запрос через виджет поддержки контактов Google Pay и консоли Wallet .

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

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

Часто задаваемые вопросы

  • Существуют ли какие-либо требования к изображениям, используемым в моей программе подарочных карт?
    • Да, ваши изображения должны размещаться по протоколу HTTPS , иначе они не будут видны в Google Кошельке.
  • Существуют ли какие-либо инструменты, упрощающие реализацию и отладку JWT?
    • Да, такие платформы, как www.jwt.io, позволяют вам декодировать и отлаживать ваши токены в процессе разработки, что позволяет вам проверять отправляемый вами контент. Обратите внимание, что Google не имеет никакого отношения к таким третьим сторонам и не рекомендует их конкретно.
  • Как правильно обрабатывать данные SharedDataType в кодировке Base64?
    • Убедитесь, что вы используете кодировку UTF-8 на протяжении всего процесса. Строка JSON сначала кодируется в UTF-8, а затем кодируется с использованием android.util.Base64 с параметрами NO_WRAP и URL_SAFE. Это соответствует разделу 4 RFC 3548 .