PaymentResponse

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Das PaymentResponse-Interface der Payment Request API wird zurückgegeben, nachdem ein Benutzer eine Zahlungsmethode ausgewählt und eine Zahlungsanfrage genehmigt hat.

EventTarget PaymentResponse

Instanz-Eigenschaften

PaymentResponse.details Nur lesbar

Gibt ein JSON-serialisierbares Objekt zurück, das eine zahlungsmethodenspezifische Nachricht bereitstellt, die vom Händler verwendet wird, um die Transaktion zu verarbeiten und den erfolgreichen Geldtransfer zu bestimmen. Der Inhalt des Objekts hängt von der verwendeten Zahlungsmethode ab. Entwickler sollten die Kontrolle des URL-Inhabers konsultieren, um die erwartete Struktur des Details-Objekts zu erfahren.

PaymentResponse.methodName Nur lesbar

Gibt den Bezeichner der Zahlungsmethode zurück, die der Benutzer ausgewählt hat, z. B. Visa, Mastercard, PayPal usw.

PaymentResponse.payerEmail Nur lesbar

Gibt die vom Benutzer angegebene E-Mail-Adresse zurück. Diese Option ist nur vorhanden, wenn die requestPayerEmail-Option im options-Parameter des PaymentRequest()-Konstruktors auf true gesetzt ist.

PaymentResponse.payerName Nur lesbar

Gibt den vom Benutzer angegebenen Namen zurück. Diese Option ist nur vorhanden, wenn die requestPayerName-Option im options-Parameter des PaymentRequest()-Konstruktors auf true gesetzt ist.

PaymentResponse.payerPhone Nur lesbar

Gibt die vom Benutzer angegebene Telefonnummer zurück. Diese Option ist nur vorhanden, wenn die requestPayerPhone-Option im options-Parameter des PaymentRequest()-Konstruktors auf true gesetzt ist.

PaymentResponse.requestId Nur lesbar

Gibt den Bezeichner der PaymentRequest zurück, die die aktuelle Antwort erzeugt hat. Dies ist derselbe Wert, der im PaymentRequest()-Konstruktor durch details.id angegeben wurde.

PaymentResponse.shippingAddress Nur lesbar

Gibt die vom Benutzer angegebene Lieferadresse zurück. Diese Option ist nur vorhanden, wenn die requestShipping-Option im options-Parameter des PaymentRequest()-Konstruktors auf true gesetzt ist.

PaymentResponse.shippingOption Nur lesbar

Gibt die ID-Eigenschaft der vom Benutzer ausgewählten Versandoption zurück. Diese Option ist nur vorhanden, wenn die requestShipping-Option im options-Parameter des PaymentRequest()-Konstruktors auf true gesetzt ist.

Instanz-Methoden

PaymentResponse.retry()

Wenn etwas mit den Daten der Zahlungsantwort nicht stimmt (und es sich um einen behebbaren Fehler handelt), erlaubt diese Methode einem Händler, den Benutzer aufzufordern, die Zahlung erneut zu versuchen. Die Methode nimmt ein Objekt als Argument, das verwendet wird, um dem Benutzer genau mitzuteilen, was an der Zahlungsantwort falsch ist, damit er versucht, die Probleme zu beheben.

PaymentResponse.complete()

Benachrichtigt den Benutzeragenten, dass die Benutzerinteraktion beendet ist. Dies führt dazu, dass die verbleibende Benutzeroberfläche geschlossen wird. Diese Methode sollte nur aufgerufen werden, nachdem das Promise von der Methode PaymentRequest.show() zurückgegeben wurde.

PaymentResponse.toJSON()

Gibt ein JSON-Objekt zurück, das dieses PaymentResponse-Objekt repräsentiert.

Ereignisse

Hören Sie auf dieses Ereignis mit addEventListener() oder durch Zuweisen eines Ereignislisteners zur oneventname-Eigenschaft dieses Interfaces.

payerdetailchange

Wird während eines erneuten Versuchs ausgelöst, wenn der Benutzer Änderungen an seinen persönlichen Informationen vornimmt, während er ein Zahlungsanfrageformular ausfüllt. Ermöglicht es dem Entwickler, alle angeforderten Benutzerdaten (z. B. Telefonnummer oder E-Mail-Adresse) erneut zu validieren, wenn sie sich ändern.

Spezifikationen

Specification
Payment Request API
# paymentresponse-interface

Browser-Kompatibilität

BCD tables only load in the browser