Справочные материалы о клиенте

Ознакомьтесь с этими справочными материалами, чтобы узнать о методах работы с клиентом JavaScript, необходимых для интеграции Google Pay API с веб-приложениями.

Конструктор

Инициализирует объект PaymentsClient. Вызовите его до компонентных методов.

Новый объект PaymentsClient(paymentOptions)

Аргументы

Свойство Описание
paymentOptions

Объект, содержащий пары "ключ – значение" для настройки Google Pay API. Более подробную информацию о различных настраиваемых свойствах можно найти в разделе Объект PaymentOptions.

Пример: {environment:'PRODUCTION'}.

Возвращаемые значения

Тип Описание
google.payments.api.PaymentsClient Объект PaymentsClient.

Исключения

Тип Описание
Error

Переданное значение характеристики среды не поддерживается.

Методы объекта

Утилита createButton(options)

Эта утилита предназначена для создания на веб-странице фирменной кнопки оплаты через Google Pay.

Элемент HTMLElement включает динамически встроенную каскадную таблицу стилей (CSS). Он также содержит изображение в формате SVG, загруженное из СДК Google.

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

Аргументы

Имя Описание
options

Объект, содержащий пары "ключ – значение" для настройки кнопок. Более подробную информацию о настраиваемых свойствах можно найти в разделе ButtonOptions.

Пример: {onClick:onGooglePaymentButtonClicked}.

Возвращаемые значения

Тип Описание
HTMLElement Элемент HTML <button> в универсальном блочном контейнере, таком как <div>.

Исключения

Тип Описание
Error

Необходимое свойство не настроено.

Объект isReadyToPay(isReadyToPayRequest)

Определяет способность покупателя воспользоваться способом оплаты через Google Pay API.

Аргументы

Имя Описание
isReadyToPayRequest Объект, содержащий используемые продавцом способы оплаты. Более подробную информацию о различных настраиваемых свойствах можно найти в разделе Объект IsReadyToPayRequest.

Возвращаемые значения

Тип Описание
Promise

Аргумент принят. Объект, содержащий сведения о платежеспособности пользователя. Подробнее о нем написано в разделе Объект IsReadyToPayResponse.

Аргумент отклонен. Объект ошибки, содержащий более подробную информацию о причине отказа. Чтобы узнать больше об этом элементе, ознакомьтесь с разделом PaymentsError.

Ошибки

statusCode Описание
DEVELOPER_ERROR
  • Неверный формат переданного объекта IsReadyToPayRequest. Указано недостаточно параметров для определения готовности пользователя к оплате, или в объекте содержатся недопустимые параметр и/или значение.
  • Платежная система или браузер не выполнили запрос в данном контексте безопасности. Такое случается, когда данные передаются без шифрования.

Метод loadPaymentData(paymentDataRequest)

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

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

Аргументы

Имя Описание
paymentDataRequest Объект, содержащий пары "ключ – значение" для полной настройки Google Pay API. Более подробную информацию о настраиваемых свойствах можно найти в разделе PaymentDataRequest.

Возвращаемые значения

Тип Описание
Promise

Аргумент принят. Объект, содержащий запрошенные пользователем данные. Более подробную информацию можно найти в разделе PaymentData.

Аргумент отклонен. Объект, содержащий код ошибки и более подробную информацию о причине отказа. Чтобы узнать больше об этом элементе, ознакомьтесь с разделом PaymentsError.

Ошибки

statusCode Описание
CANCELED
  • Вошедший в учетную запись пользователь Google или используемый в данный момент браузер не поддерживаются.
  • Покупатель закрыл страницу оплаты Google Pay, не авторизовав платеж.
  • Платежная система или браузер не выполнили запрос в данном контексте безопасности. Так бывает, когда данные передаются без шифрования.
  • Метод был вызван, пока была открыта страница оплаты.
  • Переданный объект PaymentDataRequest был отклонен страницей оплаты. Обычно это происходит, когда параметры шлюза PaymentMethodTokenizationSpecification parameters не настроены или настроены не полностью, а также когда значения параметров недопустимы.
DEVELOPER_ERROR Неверный формат переданного объекта PaymentDataRequest. Указано недостаточно параметров, или в объекте содержатся недопустимые параметр и/или значение.

Объект prefetchPaymentData(paymentDataRequest)

Выполните выборку настроек PaymentDataRequest, чтобы уменьшить время обработки объекта loadPaymentData во время последующего взаимодействия пользователя с приложением. Значения не отображаются.

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

Аргументы

Имя Описание
paymentDataRequest Объект, содержащий пары "ключ – значение" для полной настройки Google Pay API. Более подробную информацию о настраиваемых свойствах можно найти в разделе PaymentDataRequest. Изменение свойства transactionInfo не повлияет на кешированное значение выборки.

Объект paymentDataCallback(intermediatePaymentData)

Используется для обработки изменений данных, например адреса доставки и настроек доставки.

Аргументы

Имя Описание
intermediatePaymentData Объект, который включает выбранный адрес и способ доставки. Дополнительную информацию можно найти в разделе IntermediatePaymentData.

Возвраты

Тип Описание
Promise

Аргумент принят. Объект, содержащий сведения о платежеспособности пользователя. Дополнительную информацию можно найти в разделе PaymentDataRequestUpdate.

Аргумент отклонен. Объект, содержащий код ошибки и более подробную информацию о причине отказа. Чтобы узнать больше об этом элементе, ознакомьтесь с разделом PaymentsError.