PaymentResponse: complete() Methode

result Optional

Ein String, der den Status des Zahlungsvorgangs nach Abschluss angibt. Er muss einer der folgenden sein:

success

Die Zahlung wurde erfolgreich verarbeitet. Der User-Agent kann dem Benutzer eine Art "Zahlung erfolgreich" Anzeige zeigen oder nicht.

fail

Die Zahlung wurde nicht erfolgreich verarbeitet. Der Fehler kann dem Benutzer vom User-Agent mitgeteilt werden oder nicht, abhängig vom Design.

unknown

Der Erfolg oder Misserfolg der Transaktion ist unbekannt oder irrelevant, und der User-Agent sollte keine Benachrichtigung anzeigen, auch nicht, wenn er normalerweise würde. Dies ist der Standardwert.

Hinweis: In älteren Versionen der Spezifikation wurde ein leerer String, "", anstelle von unknown verwendet, um einen Abschluss ohne bekannten Ergebnisstatus anzuzeigen. Siehe den Abschnitt zur Browser-Kompatibilität unten für Details.

Ein Promise, das sich ohne Eingabewert auflöst, sobald die Zahlungsoberfläche vollständig geschlossen ist. Wenn ein Fehler auftritt, schlägt das Versprechen stattdessen fehl und gibt eine der unten aufgeführten Ausnahmen zurück.

AbortError DOMException

Wird zurückgegeben, wenn das Dokument, in dem die Zahlungsanforderung stattfindet, inaktiv wurde, während die Benutzeroberfläche angezeigt wurde.

InvalidStateError DOMException

Wird zurückgegeben, wenn die Zahlung bereits abgeschlossen ist oder complete() aufgerufen wurde, während eine Anfrage zur Wiederholung der Zahlung aussteht. Sie können eine Zahlung nicht als abgeschlossen behandeln, nachdem Sie die Wiederholung der Zahlung angefordert haben.

Das folgende Beispiel sendet Zahlungsinformationen mit der Fetch API an einen sicheren Server. Es ruft complete() mit einer zur Antwort passenden Entscheidung auf.

// 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);
  });