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.
Das PaymentAddress-Interface der Payment Request API wird verwendet, um Versand- oder Zahlungsadressinformationen zu speichern.
Es kann nützlich sein, die Materialien des Universal Postal Union zur Addressing S42 standard zu konsultieren, die Informationen über internationale Standards für Postadressen bereitstellen.
Instanzeigenschaften
PaymentAddress.addressLineSchreibgeschützt-
Ein Array von Zeichenfolgen, das jede Zeile der Adresse bereitstellt, die nicht zu den anderen Eigenschaften gehört. Die genaue Größe und der Inhalt variieren je nach Land oder Ort und können z.B. einen Straßennamen, Hausnummer, Wohnungsnummer, ländliche Lieferroute, beschreibende Anweisungen oder Postfachnummer enthalten.
PaymentAddress.countrySchreibgeschützt-
Eine Zeichenfolge, die das Land angibt, in dem sich die Adresse befindet, unter Verwendung des ISO-3166-1 alpha-2 Standards. Die Zeichenfolge wird immer in ihrer kanonischen Großbuchstabenform angegeben. Einige Beispiele für gültige
country-Werte:"US","GB","CN", oder"JP". PaymentAddress.citySchreibgeschützt-
Eine Zeichenfolge, die den Stadt- oder Ortsteil der Adresse enthält.
PaymentAddress.dependentLocalitySchreibgeschützt-
Eine Zeichenfolge, die die abhängige Örtlichkeit oder Unterlokalität innerhalb einer Stadt angibt, zum Beispiel ein Stadtteil, Bezirk oder eine abhängige Örtlichkeit im Vereinigten Königreich.
PaymentAddress.organizationSchreibgeschützt-
Eine Zeichenfolge, die den Namen der Organisation, Firma, des Unternehmens oder der Institution an der Zahlungsadresse angibt.
PaymentAddress.phoneSchreibgeschützt-
Eine Zeichenfolge, die die Telefonnummer des Empfängers oder der Kontaktperson angibt.
PaymentAddress.postalCodeSchreibgeschützt-
Eine Zeichenfolge, die einen von einer Gerichtsbarkeit zur Postrouting verwendeten Code angibt, beispielsweise den Postleitzahl-Code in den Vereinigten Staaten oder den PIN-Code in Indien.
PaymentAddress.recipientSchreibgeschützt-
Eine Zeichenfolge, die den Namen des Empfängers, Käufers oder der Kontaktperson an der Zahlungsadresse angibt.
PaymentAddress.regionSchreibgeschützt-
Eine Zeichenfolge, die die oberste Verwaltungseinheit des Landes enthält, zum Beispiel einen Staat, eine Provinz, ein Oblast oder eine Präfektur.
PaymentAddress.sortingCodeSchreibgeschützt-
Eine Zeichenfolge, die einen Postsortierungscode angibt, wie er in Frankreich verwendet wird.
Hinweis: Eigenschaften, für die keine Werte angegeben wurden, enthalten leere Zeichenfolgen.
Instanzmethoden
PaymentAddress.toJSON()-
Ein Standard-Serializer, der eine JSON-Darstellung der Eigenschaften des
PaymentAddress-Objekts zurückgibt.
Beispiele
Im folgenden Beispiel wird der PaymentRequest()-Konstruktor verwendet, um eine neue Zahlungsanforderung zu erstellen, die drei Objekte als Parameter entgegennimmt — eines, das Details zu den Zahlungsmethoden enthält, die für die Zahlung verwendet werden können, eines, das Details zur eigentlichen Bestellung enthält (wie 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, die 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();
Sobald der Zahlungsfluss über PaymentRequest.show() ausgelöst wurde und das Versprechen erfolgreich erfüllt wurde, wird das PaymentResponse-Objekt, das aus dem erfüllten Versprechen (instrumentResponse oben) verfügbar ist, eine PaymentResponse.details-Eigenschaft enthalten, die Antwortdetails enthält. Diese muss der von dem Zahlungsmethoden-Provider definierten Struktur entsprechen.