Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

PaymentResponse

Eingeschränkt verfügbar

Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.

Want more browser support for this feature? Tell us why.

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

Das Interface PaymentResponse der Payment Request API wird zurückgegeben, nachdem ein Benutzer eine Zahlungsmethode ausgewählt und eine Zahlungsanforderung bestätigt hat.

EventTarget PaymentResponse

Instanzeigenschaften

PaymentResponse.details Schreibgeschützt

Gibt ein JSON-serialisierbares Objekt zurück, das eine für die Zahlungsmethode spezifische Nachricht enthält. Der Händler verwendet sie, um die Transaktion zu verarbeiten und festzustellen, ob die Geldübertragung erfolgreich war. Der Inhalt des Objekts hängt von der verwendeten Zahlungsmethode ab. Entwickler müssen bei der für die URL zuständigen Stelle erfragen, welche Struktur das details-Objekt haben soll.

PaymentResponse.methodName Schreibgeschützt

Gibt die Kennung der vom Benutzer ausgewählten Zahlungsmethode zurück, beispielsweise Visa, Mastercard oder PayPal.

PaymentResponse.payerEmail Schreibgeschützt

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

PaymentResponse.payerName Schreibgeschützt

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

PaymentResponse.payerPhone Schreibgeschützt

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

PaymentResponse.requestId Schreibgeschützt

Gibt die Kennung des PaymentRequest zurück, der die aktuelle Antwort erzeugt hat. Dies ist derselbe Wert, der im Konstruktor PaymentRequest() über details.id angegeben wurde.

PaymentResponse.shippingAddress Schreibgeschützt

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

PaymentResponse.shippingOption Schreibgeschützt

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

Instanzmethoden

PaymentResponse.retry()

Wenn die Daten der Zahlungsantwort fehlerhaft sind und der Fehler behoben werden kann, kann ein Händler den Benutzer mit dieser Methode auffordern, die Zahlung erneut zu versuchen. Die Methode nimmt ein Objekt als Argument entgegen, das dem Benutzer genau mitteilt, was an der Zahlungsantwort nicht stimmt, damit er die Probleme beheben kann.

PaymentResponse.complete()

Teilt dem User Agent mit, dass die Benutzerinteraktion beendet ist. Dadurch werden alle noch geöffneten Benutzeroberflächen geschlossen. Diese Methode sollte erst aufgerufen werden, nachdem das von der Methode PaymentRequest.show() zurückgegebene Promise abgeschlossen ist.

PaymentResponse.toJSON()

Gibt ein JSON-serialisierbares einfaches Objekt zurück, das das PaymentResponse-Objekt repräsentiert. Wird von JSON.stringify() automatisch aufgerufen.

Ereignisse

Sie können dieses Ereignis mit addEventListener() überwachen oder der Eigenschaft oneventname dieses Interfaces einen Event Listener zuweisen.

payerdetailchange

Wird während eines erneuten Zahlungsversuchs ausgelöst, wenn der Benutzer beim Ausfüllen eines Zahlungsanforderungsformulars seine persönlichen Angaben ändert. Dadurch können Entwickler angeforderte Benutzerdaten, etwa die Telefonnummer oder E-Mail-Adresse, erneut validieren, wenn sie sich ändern.

Spezifikationen

Spezifikation
Payment Request API
# paymentresponse-interface

Browser-Kompatibilität