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.
Instanzeigenschaften
PaymentResponse.detailsSchreibgeschü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.methodNameSchreibgeschützt-
Gibt die Kennung der vom Benutzer ausgewählten Zahlungsmethode zurück, beispielsweise Visa, Mastercard oder PayPal.
PaymentResponse.payerEmailSchreibgeschützt-
Gibt die vom Benutzer angegebene E-Mail-Adresse zurück. Diese Eigenschaft ist nur vorhanden, wenn die Option
requestPayerEmailim Parameteroptionsdes KonstruktorsPaymentRequest()auftruegesetzt ist. PaymentResponse.payerNameSchreibgeschützt-
Gibt den vom Benutzer angegebenen Namen zurück. Diese Eigenschaft ist nur vorhanden, wenn die Option
requestPayerNameim Parameteroptionsdes KonstruktorsPaymentRequest()auf true gesetzt ist. PaymentResponse.payerPhoneSchreibgeschützt-
Gibt die vom Benutzer angegebene Telefonnummer zurück. Diese Eigenschaft ist nur vorhanden, wenn die Option
requestPayerPhoneim Parameteroptionsdes KonstruktorsPaymentRequest()auftruegesetzt ist. PaymentResponse.requestIdSchreibgeschützt-
Gibt die Kennung des
PaymentRequestzurück, der die aktuelle Antwort erzeugt hat. Dies ist derselbe Wert, der im KonstruktorPaymentRequest()überdetails.idangegeben wurde. PaymentResponse.shippingAddressSchreibgeschützt-
Gibt die vom Benutzer angegebene Lieferadresse zurück. Diese Eigenschaft ist nur vorhanden, wenn die Option
requestShippingim Parameteroptionsdes KonstruktorsPaymentRequest()auftruegesetzt ist. PaymentResponse.shippingOptionSchreibgeschützt-
Gibt das ID-Attribut der vom Benutzer ausgewählten Versandoption zurück. Diese Eigenschaft ist nur vorhanden, wenn die Option
requestShippingim Parameteroptionsdes KonstruktorsPaymentRequest()auftruegesetzt 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 vonJSON.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> |