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 zur Verarbeitung der Transaktion und zur Bestimmung des erfolgreichen Geldtransfers verwendet wird. Der Inhalt des Objekts hängt von der verwendeten Zahlungsmethode ab. Entwickler müssen überprüfen, welche Form das Objekt aufweisen soll, indem sie die URL-Kontrolle konsultieren.

PaymentResponse.methodName Nur lesbar

Gibt den Zahlungskennzeichner für die Zahlungsmethode zurück, die der Benutzer ausgewählt hat, zum Beispiel 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 Option requestPayerEmail 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 Option requestPayerName 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 Option requestPayerPhone im options-Parameter des PaymentRequest()-Konstruktors auf true gesetzt ist.

PaymentResponse.requestId Nur lesbar

Gibt die Kennung 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 Versandadresse zurück. Diese Option ist nur vorhanden, wenn die Option requestShipping im options-Parameter des PaymentRequest()-Konstruktors auf true gesetzt ist.

PaymentResponse.shippingOption Nur lesbar

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

Instanz-Methoden

PaymentResponse.retry()

Wenn etwas mit den Zahlungsantwortdaten nicht stimmt (und es sich um einen behebbaren Fehler handelt), ermöglicht diese Methode einem Händler, den Benutzer aufzufordern, die Zahlung zu wiederholen. Die Methode nimmt ein Objekt als Argument, das dem Benutzer genau signalisiert, was mit der Zahlungsantwort nicht stimmt, damit er versuchen kann, eventuelle Probleme zu beheben.

PaymentResponse.complete()

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

PaymentResponse.toJSON()

Gibt ein JSON-Objekt zurück, das dieses PaymentResponse-Objekt darstellt.

Ereignisse

Dieses Ereignis kann mit addEventListener() oder durch Zuweisen eines Ereignis-Listeners zur oneventname-Eigenschaft dieses Interfaces gehört werden.

payerdetailchange

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

Spezifikationen

Specification
Payment Request API
# paymentresponse-interface

Browser-Kompatibilität

BCD tables only load in the browser