PaymentResponse: метод complete()

Метод PaymentRequest complete() объекта Payment Request API уведомляет браузер, что взаимодействие пользователя завершено, и вызывает закрытие любых оставшихся пользовательских интерфейсов.

Этот метод должен быть вызван после того, как пользователь примет запрос на платеж, и Promise, возвращённый методом PaymentRequest.show(), будет разрешён.

result Необязательно

Строка, указывающая состояние операции платежа после завершения. Она должна быть одной из следующих:

success

Платеж был успешно обработан. Браузер может или не может отобразить пользователю какое-либо сообщение об успешном платеже.

fail

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

unknown

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

Примечание: В более ранних версиях спецификации вместо unknown использовалась пустая строка, "", для обозначения завершения без известного состояния результата. Подробности см. в разделе Совместимость с браузерами ниже.

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

AbortError DOMException

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

InvalidStateError DOMException

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

В следующем примере данные платежа отправляются на защищенный сервер с использованием Fetch API. Вызывается complete() с ответом, соответствующим статусу в ответе.

// Initialization of PaymentRequest arguments are excerpted for the
//   sake of brevity.
const payment = new PaymentRequest(supportedInstruments, details, options);

payment
  .show()
  .then((paymentResponse) => {
    const fetchOptions = {
      method: "POST",
      credentials: include,
      body: JSON.stringify(paymentResponse),
    };
    const serverPaymentRequest = new Request("secure/payment/endpoint");
    fetch(serverPaymentRequest, fetchOptions)
      .then((response) => {
        if (response.status < 400) {
          paymentResponse.complete("success");
        } else {
          paymentResponse.complete("fail");
        }
      })
      .catch((reason) => {
        paymentResponse.complete("fail");
      });
  })
  .catch((err) => {
    console.error("Uh oh, something bad happened", err.message);
  });