Регистрация и аутентификация

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

В этом руководстве описан процесс настройки программ лояльности и карт постоянного клиента.

Обзор

Для начала необходимо создать проект и получить доступ к инструменту Google Pay API for Passes. Если вы этого ещё не сделали, следуйте инструкциям, приведенным в разделе Ссылки и кнопки для сетевых ресурсов.

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

  1. Создайте страницы регистрации/входа, которые будут обрабатывать данные пользователей приложения Google Pay.
  2. Настройте функцию добавления карты постоянного клиента в приложение Google Pay после регистрации или аутентификации в программе лояльности.
  3. Запросите проверку и активацию.

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

Указав значения в discoverableProgram, вы создадите предварительную версию программы лояльности с функцией регистрации и аутентификации. Эту программу увидят только пользователи, у которых есть доступ к вашему аккаунту Google Pay API for Passes Merchant Center. Используя ее, вы сможете проверить правильность работы подключенных функций в процессе разработки.

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

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

Для того чтобы пользователи могли выполнить эти действия, необходимо создать два адреса.

  1. URL для входа пользователя в существующий аккаунт.
  2. URL регистрации для создания нового аккаунта.

Создавая страницы аутентификации и регистрации, соблюдайте следующие требования:

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

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

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

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

В зависимости от выбора пользователя и запрашиваемых вами данных объект JSON может содержать указанные ниже поля.

Поле Регистрация Аутентификация
email
firstName  
lastName  
addressLine [1–3]  
city  
state  
zipcode  
country  
phone  

Ниже показан образец расшифрованного объекта JSON, который содержится в userProfile.

Ресурс

{
  "firstName": "Jane",
  "lastName": "Doe",
  "addressLine1": "1600 Amphitheatre Pkwy",
  "addressLine2": "Apt 123",
  "addressLine3": "Attn:Jane",
  "city": "Mountain View",
  "state": "CA",
  "zipcode": "94043",
  "country": "US",
  "email": "jane.doe@example.com",
  "phone": "555-555-5555"
}

Как подключить функцию моментального добавления карты постоянного клиента в приложение Google Pay

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

Можно добавить карту постоянного клиента в приложение Google Pay, перенаправив ее по указанной ниже ссылке. Если вы ещё не знакомы с процессом создания веб-токена JSON (JWT) для объекта LoyaltyObject, который представляет вашу карту постоянного клиента, ознакомьтесь с разделом Создание веб-токена JSON (JWT) для LoyaltyObject.

https://www.android.com/payapp/savetoandroidpay/{jwt_generated}

Безопасная длина URL – 2000 символов. Не следует превышать этот лимит. Объекты в токенах JSON должны содержать только важные для пользователя данные. Постарайтесь сохранить большую часть данных в классе, создав его раньше токена. Используйте Google Pay API for Passes, если нужно сформировать крупный объект, и отправьте в токен JSON только его идентификатор.

Стандартный процесс взаимодействия

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

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

Если вы ещё не запрашивали проверку и активацию в процессе разработки, заполните форму регистрации, чтобы отправить URL страниц регистрации и аутентификации, логотип программы лояльности и названия заполняемых пользователем полей.

Получив эти данные, наша служба поддержки создаст предварительную версию программы лояльности с функцией регистрации и аутентификации. Эту версию смогут увидеть только пользователи с доступом к вашему аккаунту Google Pay API for Passes Merchant Center, которые были внесены в белый список Gmail-аккаунтов тестировщиков в форме регистрации.

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

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

Для обеспечения оптимальной работы сервиса подключенные функции будут регулярно проверяться на соответствие предъявляемым требованиям. В случае выявления несоответствий вам направят уведомление. При этом функции могут быть отключены до устранения проблемы.

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

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

Образец процесса регистрации