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

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

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

Обзор

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

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

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

Как настроить тестовый класс в Google Кошельке

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

Задайте значения в объекте discoverableProgram, чтобы создать черновик программы подарочных карт с возможностью входа. Чтобы тестировщики могли его увидеть, убедитесь, что у них есть доступ к вашей консоли Google Pay и Кошелька. Подробнее о том, как предоставить доступ к Google Pay and Wallet Console другим пользователям, рассказывается в статье О странице "Пользователи".

Чтобы завершить проверку функциональности вашей реализации в процессе разработки, свяжитесь с нами, используя виджет поддержки в Google Pay and Wallet Console. В консоли выберите тему Google Wallet API и подтему Gift card sign-in (Вход в аккаунт для работы с подарочными картами).

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

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

Вы должны указать URL страницы, на которой пользователь может войти в существующий аккаунт.

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

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

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

Примечание. Сначала строка JSON кодируется в UTF-8, а затем – с помощью android.util.Base64 с параметрами NO_WRAP и URL_SAFE. Это соответствует разделу 4 стандарта RFC 3548.

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

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

Примечание. Не добавляйте кнопку Google Wallet API, так как пользователи должны возвращаться в Google Кошелек без дополнительных действий.

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

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

Примечание. Не забудьте добавить косую черту (/) в URL перед JWT.

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

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

Стандартный процесс обмена данными

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

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

После того как вы завершите разработку и протестируете процесс входа, отправьте запрос через виджет службы поддержки в Google Pay and Wallet Console.

После полной проверки вашей реализации, которая подтвердит правильность работы функции в сочетании с приложением 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.