Функция регистрации подарочной карты (входа в систему) позволяет пользователям искать подарочную карту и добавлять ее в Google Кошелек. Пользователи будут перенаправлены на ваш веб-сайт, удобный для мобильных устройств, для завершения процесса, после чего они смогут добавить свою карту в Google Кошелек.
В этом руководстве представлен обзор шагов по реализации, необходимых для включения этой функции в вашей программе подарочных карт.
Обзор
Для начала убедитесь, что вы ранее настроили свой проект и имеете доступ к API Google Кошелька.
Вы должны выполнить следующие четыре шага, чтобы реализовать функцию входа в программу подарочных карт:
- Настройте тестовый класс в Google Кошельке для проверки процесса входа в систему.
- Разработайте страницы входа, использующие Google Wallet
SharedDataType. - Реализуйте возврат подарочной карты в Google Кошелек после входа в систему.
- Запросить проверку и активацию.
Настройте тестовый курс в 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 .