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

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

Конструктор

Инициализирует объект PaymentsClient . Необходимо вызвать этот конструктор перед вызовом методов-членов.

new PaymentsClient(paymentOptions)

Аргументы

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

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

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

Возвраты

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

Броски

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

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

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

createButton(options)

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

Сгенерированный HTMLElement включает динамически вставляемые CSS-стили и SVG-изображение, размещенное на CDN Google.

Для получения дополнительной информации о выборе подходящего цвета и типа кнопки для дизайна вашего сайта обратитесь к нашим рекомендациям по фирменному стилю . Возможно, вам потребуется изменить размеры кнопки, чтобы они соответствовали аналогичным кнопкам или элементам оформления заказа на вашей странице. Используйте наш инструмент «Настроить кнопку» , чтобы настроить кнопку под ваши нужды.

Аргументы

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

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

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

Возвраты

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

Броски

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

Обязательное свойство не задано.

isReadyToPay(isReadyToPayRequest)

Используйте метод isReadyToPay(isReadyToPayRequest) , чтобы определить возможность пользователя получить оплату через API Google Pay.

Если браузер поддерживает Google Pay, isReadyToPay возвращает true . Чтобы определить, вошел ли пользователь в учетную запись Google или уже сохранил способ оплаты в Google Pay, установите IsReadyToPayRequest.existingPaymentMethodRequired в значение true и убедитесь, что paymentMethodPresent возвращает true в разрешенном промисе. Дополнительные сведения см. в разделе IsReadyToPayResponse .

Если PaymentsClient инициализирован свойством среды со значением TEST , paymentMethodPresent всегда возвращает true .

Аргументы

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

Возвраты

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

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

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

Ошибки

статусКод Описание
DEVELOPER_ERROR
  • Переданный объект IsReadyToPayRequest имеет неправильный формат, не содержит минимально необходимых параметров для определения готовности пользователя к оплате или содержит недопустимый параметр и/или значение.
  • Запрос был инициирован в контексте безопасности, который платежный агент или браузер решили не выполнять. Чаще всего это ошибка небезопасного контекста браузера .

loadPaymentData(paymentDataRequest)

Данный метод представляет собой форму оплаты Google Pay, позволяющую выбрать способ оплаты и, при необходимости, настроить параметры.

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

Аргументы

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

Возвраты

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

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

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

Ошибки

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

prefetchPaymentData(paymentDataRequest)

Используйте этот метод для предварительной загрузки конфигурации PaymentDataRequest , чтобы сократить время выполнения loadPaymentData при последующем взаимодействии с пользователем. Значение не возвращается.

Оптимизация предварительной загрузки доступна в Chrome для Android.

Аргументы

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