PaymentRequestEvent

Интерфейс PaymentRequestEvent API Payment Handler — это объект, передаваемый обработчику платежей при выполнении PaymentRequest.

PaymentRequestEvent() Экспериментальная

Создает новый экземпляр объекта PaymentRequestEvent.

instrumentKey Только для чтения Устаревший Нестандартный

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

methodData Только для чтения Экспериментальная

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

modifiers Только для чтения Экспериментальная

Возвращает массив объектов, содержащих изменения в платежных данных.

paymentRequestId Только для чтения Экспериментальная

Возвращает идентификатор объекта PaymentRequest.

paymentRequestOrigin Только для чтения Экспериментальная

Возвращает происхождение, где был инициализирован объект PaymentRequest.

topOrigin Только для чтения Экспериментальная

Возвращает основное происхождение, где был инициализирован объект PaymentRequest.

total Только для чтения Экспериментальная

Возвращает общую сумму, запрашиваемую для оплаты.

changePaymentMethod() Экспериментальная

Получает обновлённую сумму, учитывая подробности способа оплаты.

openWindow() Экспериментальная

Открывает указанный URL в новом окне, если и только если данный URL находится в том же происхождении, что и вызывающая страница. Возвращает Promise, который разрешается ссылкой на WindowClient.

respondWith() Экспериментальная

Предотвращает обработку события по умолчанию и позволяет указать Promise для объекта PaymentResponse самостоятельно.

При вызове метода PaymentRequest.show() происходит срабатывание события paymentrequest в сервисном работнике приложения для платежей. Это событие обрабатывается внутри сервисного работника приложения для платежей для начала следующей стадии процесса оплаты.

let payment_request_event;
let resolver;
let client;

// `self` is the global object in service worker
self.addEventListener("paymentrequest", async (e) => {
  if (payment_request_event) {
    // If there's an ongoing payment transaction, reject it.
    resolver.reject();
  }
  // Preserve the event for future use
  payment_request_event = e;

  // ...
});

При получении события paymentrequest, приложение для платежей может открыть окно обработчика платежей, вызвав PaymentRequestEvent.openWindow(). Окно обработчика платежей представит клиенту интерфейс приложения для платежей, где он сможет пройти аутентификацию, выбрать адрес доставки и опции, а также авторизовать оплату.

После обработки платежа, используется PaymentRequestEvent.respondWith() для возврата результата платежа на веб-сайт продавца.

См. Получение события запроса платежа от продавца для получения более подробной информации об этой стадии.

• Обзор веб-приложений для платежей
• Настройка метода оплаты
• Жизненный цикл платежной транзакции
• Использование API запроса платежа
• Понятия обработки платежей