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

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

Constructor

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

new PaymentsClient(paymentOptions)

Аргументы

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

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

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

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

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

Исключения

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

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

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

createButton(options)

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

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

Более подробную информацию о доступных типах и цветах кнопок для вашего сайта можно найти в правилах фирменного оформления 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 для шлюза не настроены или настроены не полностью, а также когда значения параметров недопустимы.
DEVELOPER_ERROR Неверный формат переданного объекта PaymentDataRequest. Указано недостаточно параметров, или в объекте содержатся недопустимые параметр и/или значение.

prefetchPaymentData(paymentDataRequest)

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

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

Аргументы

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

onPaymentAuthorized(paymentData)

Этот метод используется, когда платеж авторизуется на странице оплаты.

Аргументы

Название Описание
paymentData Объект, содержащий запрошенные пользователем данные. Дополнительную информацию по теме можно найти здесь: PaymentData.

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

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

Выполнено. Объект, содержащий сведения о результатах транзакции. Дополнительную информацию по теме можно найти здесь: PaymentAuthorizationResult.

Отклонено. Объект, который содержит значение ошибки и сообщение, которое соответствует ей на странице оплаты. Дополнительную информацию по теме можно найти здесь: PaymentDataError.

onPaymentDataChanged(intermediatePaymentData)

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

Аргументы

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

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

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

Выполнено. Объект, который содержит сведения о новых данных по транзакции, способе доставки и ошибках в платежных данных. Дополнительную информацию по теме можно найти здесь: PaymentDataRequestUpdate.

Отклонено. Объект, который содержит значение ошибки и сообщение, которое соответствует ей на странице оплаты. Дополнительную информацию по теме можно найти здесь: PaymentDataError.