Эта страница переведена с помощью Cloud Translation API.

API веб-пополнения

Интеграторы должны внедрить веб-хостинг для перенаправления пользователей для пополнения счета. Это пополнение представляет собой другой метод, но имеет ту же цель, что и пополнение, предоставляемое Android Top-ups . Этот веб-хостинг должен иметь веб-сайт, удобный для мобильных устройств.

Веб-хостинг должен определять мобильные веб-запросы по сравнению с веб-запросами настольных компьютеров на основе значения заголовка пользовательского агента. Страница, предоставляемая по мобильным веб-запросам, должна быть оптимизирована для мобильных устройств на Android и iOS. Помимо значения заголовка user-agent, клиент не предоставит вам никаких других подсказок относительно среды, в которой этот пользователь делает запрос (рабочий стол или Интернет).

Сервер должен реализовать протокол HTTPS с использованием GET. Путь и хост определяются интегратором. Интегратор должен поддерживать длину URL-адресов в 2048 символов. Сюда входят схема, хост, порт, путь и параметры.

Все параметры будут закодированы в UTF-8 до того, как будут закодированы в URL.

Запрос

По запросу Google предоставляет в качестве параметров URL следующие параметры:

Поля
`gspMajorVersion`	`int` Основной номер версии для этого запроса.
`gspTopUpRequest`	`TopUpRedirectRequest` Запрос на пополнение.
`gspAssociationId`	`string` Содержит идентификатор, который интегратор использует для поиска учетных данных для учетной записи, которую пополняет пользователь. Это идентификатор связи, который отправляется во время привязки учетной записи в AssociateAccountRequest.
`gspCallbackUrl`	`string` URL-адрес, на который нужно перенаправить пользователя, чтобы завершить процесс пополнения баланса в Google. Это значение имеет URL-кодировку.

Ответ

После завершения пополнения пользователь должен быть перенаправлен на gspCallbackUrl с помощью HTTPS GET. Этот URL-адрес должен иметь следующие параметры запроса:

Поля

gspResult

int

`100`	Пополнение прошло успешно.
`201`	Пользователь отменил поток вручную, и поток должен быть прерван.
`202`	Пополнение не удалось по фатальной причине, и поток должен быть прерван.

перенаправлениеRequestId string

ОБЯЗАТЕЛЬНО : requestId , отправленный в исходном/инициирующем запросе на перенаправление платежа. Google проверит, что это соответствует отправленному requestId , и поток полного перенаправления завершится ошибкой, если он не соответствует.

gspTopUpResponse RedirectResponse

ОБЯЗАТЕЛЬНО : TopUpRedirectResponse должен быть зашифрован и подписан с использованием PGP или JWE+JWS . Кроме того, это значение должно быть закодировано в формате base64 , безопасном для Интернета.