PaymentAddress
Deprecated
Avoid using this feature in new projects. This feature may be a candidate for removal from web standards or browsers.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Nicht standardisiert: Diese Funktion ist nicht standardisiert. Wir raten davon ab, nicht-standardisierte Funktionen auf produktiven Webseiten zu verwenden, da sie nur von bestimmten Browsern unterstützt werden und sich in Zukunft ändern oder entfernt werden können. Unter Umständen kann sie jedoch eine geeignete Option sein, wenn es keine standardisierte Alternative gibt.
Die PaymentAddress-Schnittstelle der Payment Request API dient zum Speichern von Versand- oder Zahlungsadressinformationen.
Die Materialien zum Addressing-S42-Standard auf der Website des Weltpostvereins können hilfreich sein. Sie enthalten Informationen zu internationalen Standards für Postanschriften.
Instanzeigenschaften
PaymentAddress.addressLineSchreibgeschützt-
Ein Array von Strings mit den einzelnen Adresszeilen, die nicht durch andere Eigenschaften abgedeckt sind. Anzahl und Inhalt variieren je nach Land oder Ort. Sie können beispielsweise einen Straßennamen, eine Hausnummer, eine Wohnungsnummer, Angaben zu einer ländlichen Zustellroute, Zustellhinweise oder eine Postfachnummer enthalten.
PaymentAddress.countrySchreibgeschützt-
Ein String, der das Land angibt, in dem sich die Adresse befindet, gemäß dem Standard ISO 3166-1 Alpha-2. Der String wird immer in seiner kanonischen Form mit Großbuchstaben angegeben. Beispiele für gültige
country-Werte sind"US","GB","CN"und"JP". PaymentAddress.citySchreibgeschützt-
Ein String mit dem Stadt- oder Ortsnamen der Adresse.
PaymentAddress.dependentLocalitySchreibgeschützt-
Ein String, der einen untergeordneten Ort oder Ortsteil innerhalb einer Stadt angibt, beispielsweise ein Stadtviertel, einen Stadtbezirk, einen Distrikt oder eine sogenannte „dependent locality“ im Vereinigten Königreich.
PaymentAddress.organizationSchreibgeschützt-
Ein String mit dem Namen der Organisation, Firma, des Unternehmens oder der Einrichtung an der Zahlungsadresse.
PaymentAddress.phoneSchreibgeschützt-
Ein String mit der Telefonnummer der empfangenden Person oder der Kontaktperson.
PaymentAddress.postalCodeSchreibgeschützt-
Ein String mit einem Code, der in einem Zuständigkeitsgebiet zur Postzustellung verwendet wird, beispielsweise dem ZIP-Code in den Vereinigten Staaten oder dem PIN-Code in Indien.
PaymentAddress.recipientSchreibgeschützt-
Ein String mit dem Namen der empfangenden, kaufenden oder an der Zahlungsadresse zuständigen Kontaktperson.
PaymentAddress.regionSchreibgeschützt-
Ein String mit der obersten Verwaltungseinheit des Landes, beispielsweise einem Bundesstaat, einer Provinz, einer Oblast oder einer Präfektur.
PaymentAddress.sortingCodeSchreibgeschützt-
Ein String mit einem Postsortiercode, wie er beispielsweise in Frankreich verwendet wird.
Hinweis: Eigenschaften, für die keine Werte angegeben wurden, enthalten leere Strings.
Instanzmethoden
PaymentAddress.toJSON()-
Gibt ein JSON-serialisierbares einfaches Objekt zurück, das das
PaymentAddress-Objekt repräsentiert. Die Methode wird vonJSON.stringify()automatisch aufgerufen.
Beispiele
Im folgenden Beispiel wird der Konstruktor PaymentRequest() verwendet, um eine neue Zahlungsanfrage zu erstellen. Er erhält drei Objekte als Parameter: eines mit Angaben zu den Zahlungsmethoden, die für die Zahlung verwendet werden können, eines mit Angaben zur eigentlichen Bestellung (etwa gekaufte Artikel und Versandoptionen) und ein optionales Objekt mit weiteren Optionen.
Das erste dieser drei Objekte (supportedInstruments im folgenden Beispiel) enthält eine data-Eigenschaft, deren Inhalt der von der Zahlungsmethode definierten Struktur entsprechen muss.
const supportedInstruments = [
{
supportedMethods: "https://example.com/pay",
},
];
const details = {
total: { label: "Donation", amount: { currency: "USD", value: "65.00" } },
displayItems: [
{
label: "Original donation amount",
amount: { currency: "USD", value: "65.00" },
},
],
shippingOptions: [
{
id: "standard",
label: "Standard shipping",
amount: { currency: "USD", value: "0.00" },
selected: true,
},
],
};
const options = { requestShipping: true };
async function doPaymentRequest() {
const request = new PaymentRequest(supportedInstruments, details, options);
// Add event listeners here.
// Call show() to trigger the browser's payment flow.
const response = await request.show();
// Process payment.
const json = response.toJSON();
const httpResponse = await fetch("/pay/", { method: "POST", body: json });
const result = httpResponse.ok ? "success" : "failure";
await response.complete(result);
}
doPaymentRequest();
Nachdem der Zahlungsvorgang mit PaymentRequest.show() gestartet wurde und das Promise erfolgreich erfüllt ist, enthält das über das erfüllte Promise verfügbare PaymentResponse-Objekt (instrumentResponse oben) eine PaymentResponse.details-Eigenschaft mit Antwortdetails. Diese müssen der vom Anbieter der Zahlungsmethode definierten Struktur entsprechen.