PaymentRequestEvent
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.
Hinweis: Diese Funktion ist nur in Service Workers verfügbar.
Das PaymentRequestEvent-Interface der Web-basierten Payment Handler API ist das Objekt, das an einen Payment-Handler übergeben wird, wenn eine PaymentRequest durchgeführt wird.
Konstruktor
PaymentRequestEvent()Experimentell-
Erstellt eine neue Instanz eines
PaymentRequestEvent-Objekts.
Instanz-Eigenschaften
methodDataSchreibgeschützt Experimentell-
Gibt ein Array von Objekten zurück, das Bezahlmethoden-Identifikatoren für die akzeptierten Zahlungsmethoden der Website und alle zugehörigen spezifischen Zahlungsdaten enthält.
modifiersSchreibgeschützt Experimentell-
Gibt ein Array von Objekten zurück, das Änderungen an den Zahlungsdetails enthält.
paymentRequestIdSchreibgeschützt Experimentell-
Gibt die ID des
PaymentRequest-Objekts zurück. paymentRequestOriginSchreibgeschützt Experimentell-
Gibt den Ursprung zurück, an dem das
PaymentRequest-Objekt initialisiert wurde. topOriginSchreibgeschützt Experimentell-
Gibt den obersten Ursprung zurück, an dem das
PaymentRequest-Objekt initialisiert wurde. totalSchreibgeschützt Experimentell-
Gibt den Gesamtbetrag zurück, der für die Zahlung angefordert wird.
Instanz-Methoden
changePaymentMethod()Experimentell-
Erhält einen aktualisierten Gesamtbetrag basierend auf den Zahlungsmethoden-Details.
openWindow()Experimentell-
Öffnet die angegebene URL in einem neuen Fenster, wenn und nur wenn die gegebene URL im selben Ursprung wie die aufrufende Seite ist. Gibt ein
Promisezurück, das mit einer Referenz zu einemWindowClientaufgelöst wird. respondWith()Experimentell-
Verhindert die Standard-Ereignisbehandlung und ermöglicht es Ihnen, ein
Promisefür einPaymentResponse-Objekt selbst bereitzustellen.
Beispiele
Wenn die PaymentRequest.show()-Methode aufgerufen wird, wird auf dem Service Worker der Zahlungs-App ein paymentrequest-Ereignis ausgelöst. Dieses Ereignis wird innerhalb des Service Workers der Zahlungs-App überwacht, um die nächste Phase des Zahlungsprozesses zu beginnen.
let paymentRequestEvent;
let resolver;
let client;
// `self` is the global object in service worker
self.addEventListener("paymentrequest", async (e) => {
if (paymentRequestEvent) {
// If there's an ongoing payment transaction, reject it.
resolver.reject();
}
// Preserve the event for future use
paymentRequestEvent = e;
// …
});
Wenn ein paymentrequest-Ereignis empfangen wird, kann die Zahlungs-App ein Zahlungs-Handler-Fenster öffnen, indem sie PaymentRequestEvent.openWindow() aufruft. Das Zahlungs-Handler-Fenster zeigt den Kunden eine Benutzeroberfläche der Zahlungs-App an, in der sie sich authentifizieren, eine Lieferadresse und Optionen wählen und die Zahlung autorisieren können.
Wenn die Zahlung ausgeführt wurde, wird PaymentRequestEvent.respondWith() verwendet, um das Zahlungsergebnis an die Händler-Website zurückzugeben.
Sehen Sie Einen Zahlungsanforderungs-Ereignis vom Händler empfangen für mehr Details zu dieser Phase.
Spezifikationen
| Specification |
|---|
| Web-based Payment Handler API> # the-paymentrequestevent> |