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.
Instanz-Eigenschaften
PaymentResponse.details
Schreibgeschützt-
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
Schreibgeschützt-
Gibt den Bezeichner der Zahlungsmethode zurück, die der Benutzer ausgewählt hat, z. B. Visa, Mastercard, PayPal usw.
PaymentResponse.payerEmail
Schreibgeschützt-
Gibt die vom Benutzer angegebene E-Mail-Adresse zurück. Diese Option ist nur vorhanden, wenn die
requestPayerEmail
-Option imoptions
-Parameter desPaymentRequest()
-Konstruktors auftrue
gesetzt ist. PaymentResponse.payerName
Schreibgeschützt-
Gibt den vom Benutzer angegebenen Namen zurück. Diese Option ist nur vorhanden, wenn die
requestPayerName
-Option imoptions
-Parameter desPaymentRequest()
-Konstruktors auftrue
gesetzt ist. PaymentResponse.payerPhone
Schreibgeschützt-
Gibt die vom Benutzer angegebene Telefonnummer zurück. Diese Option ist nur vorhanden, wenn die
requestPayerPhone
-Option imoptions
-Parameter desPaymentRequest()
-Konstruktors auftrue
gesetzt ist. PaymentResponse.requestId
Schreibgeschützt-
Gibt den Bezeichner der
PaymentRequest
zurück, die die aktuelle Antwort erzeugt hat. Dies ist derselbe Wert, der imPaymentRequest()
-Konstruktor durchdetails.id
angegeben wurde. PaymentResponse.shippingAddress
Schreibgeschützt-
Gibt die vom Benutzer angegebene Lieferadresse zurück. Diese Option ist nur vorhanden, wenn die
requestShipping
-Option imoptions
-Parameter desPaymentRequest()
-Konstruktors auftrue
gesetzt ist. PaymentResponse.shippingOption
Schreibgeschützt-
Gibt die ID-Eigenschaft der vom Benutzer ausgewählten Versandoption zurück. Diese Option ist nur vorhanden, wenn die
requestShipping
-Option imoptions
-Parameter desPaymentRequest()
-Konstruktors auftrue
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