PaymentRequest: событие merchantvalidation

события merchantvalidation доставляются через API запроса оплаты объекту PaymentRequest, когда обработчик платежа требует, чтобы продавец, запрашивающий покупку, подтвердил свои права использовать обработчик платежей.

Узнайте, как работает процесс валидации продавца.

Это событие не может быть отменено и не распространяется.

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

addEventListener("merchantvalidation", (event) => {});

onmerchantvalidation = (event) => {};

Объект MerchantValidationEvent. Наследуется от Event.

MerchantValidationEvent.methodName

Строка, предоставляющая уникальный идентификатор метода платежа для обработчика платежа, требующего проверки. Это может быть один из стандартных идентификаторов метода платежа или URL, который одновременно идентифицирует и обрабатывает запросы для обработчика платежей, например https://apple.com/apple-pay.

MerchantValidationEvent.validationURL

Строка, определяющая URL, с помощью которого сайт или приложение могут извлечь информацию о валидации, специфичную для обработчика платежей. После получения этих данных данные (или обещание, разрешающее данные валидации) должны быть переданы в complete(), чтобы проверить, поступает ли запрос на оплату от авторизованного продавца.

В этом примере устанавливается обработчик событий для события merchantvalidation. Он использует fetch() для отправки запроса на собственный сервер с аргументом URL валидации метода платежа, полученного из свойства события validationURL. Сервер продавца должен получить доступ к URL валидации в соответствии с документацией метода платежа. Как правило, клиент не должен получать доступ к URL валидации.

request.addEventListener("merchantvalidation", (event) => {
  event.complete(async () => {
    const merchantServerUrl = `${
      window.location.origin
    }/validate?url=${encodeURIComponent(event.validationURL)}`;
    // get validation data, and complete validation;
    return await fetch(merchantServerUrl).then((response) => response.text());
  }, false);
});

const response = await request.show();

Обработка валидации сервером продавца зависит от реализации сервера и документации метода платежа. Содержимое, предоставленное сервером валидации, передается на сервер продавца, а затем возвращается из обработчика выполнения вызова fetch() в метод complete() события. Этот ответ позволяет обработчику платежа узнать, подтвержден ли продавец.

Вы также можете использовать свойство обработчика событий onmerchantvalidation для настройки обработчика для этого события:

request.onmerchantvalidation = (event) => {
  event.complete(async () => {
    const merchantServerUrl = `${
      window.location.origin
    }/validate?url=${encodeURIComponent(event.validationURL)}`;
    // get validation data, and complete validation;
    return await fetch(merchantServerUrl).then((response) => response.text());
  });
};

const response = await request.show();

Для получения дополнительной информации см. Валидация продавца.

• API запроса оплаты
• Использование API запроса оплаты
• onmerchantvalidation свойство обработчика событий
• Валидация продавца
• paymentmethodchange событие
• shippingaddresschange событие
• shippingoptionchange событие