PaymentAddress
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, könnte sie bereits aus den relevanten Webstandards entfernt worden sein, in Kürze entfernt werden oder nur noch aus Kompatibilitätsgründen bestehen. Vermeiden Sie die Verwendung und aktualisieren Sie vorhandenen Code, falls möglich; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu unterstützen. Beachten Sie, dass diese Funktion jederzeit aufhören könnte zu funktionieren.
Nicht standardisiert: Diese Funktion ist nicht standardisiert und befindet sich nicht auf dem Weg zur Standardisierung. Verwenden Sie sie nicht auf Produktionsseiten, die dem Web ausgesetzt sind: Sie funktioniert nicht für alle Benutzer. Es kann auch große Inkompatibilitäten zwischen Implementierungen geben, und das Verhalten kann sich in Zukunft ändern.
Das PaymentAddress
Interface der Payment Request API wird verwendet, um Versand- oder Zahlungsadressinformationen zu speichern.
Es kann nützlich sein, auf die Materialien des Universal Postal Union zur Addressing S42 standard zu verweisen, die Informationen über internationale Standards für Postadressen bieten.
Instanz-Eigenschaften
PaymentAddress.addressLine
Schreibgeschützt Veraltet Nicht standardisiert-
Ein Array von Zeichenketten, 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 beispielsweise einen Straßennamen, Hausnummer, Wohnungsnummer, ländliche Lieferroute, beschreibende Anleitungen oder Postfachnummer enthalten.
PaymentAddress.country
Schreibgeschützt Veraltet Nicht standardisiert-
Eine Zeichenkette, die das Land angibt, in dem sich die Adresse befindet, unter Verwendung des ISO-3166-1 alpha-2 Standards. Die Zeichenkette wird immer in ihrer kanonischen Großbuchstabenform angegeben. Einige Beispiele für gültige
country
Werte:"US"
,"GB"
,"CN"
oder"JP"
. PaymentAddress.city
Schreibgeschützt Veraltet Nicht standardisiert-
Eine Zeichenkette, die den Stadt- oder Ortsteil der Adresse enthält.
PaymentAddress.dependentLocality
Schreibgeschützt Veraltet Nicht standardisiert-
Eine Zeichenkette, die die abhängige Örtlichkeit oder Sublokalität innerhalb einer Stadt angibt, zum Beispiel ein Stadtviertel, Bezirk, Stadtbezirk oder eine britische abhängige Örtlichkeit.
PaymentAddress.organization
Schreibgeschützt Veraltet Nicht standardisiert-
Eine Zeichenkette, die den Namen der Organisation, Firma, des Unternehmens oder der Institution an der Zahlungsadresse angibt.
PaymentAddress.phone
Schreibgeschützt Veraltet Nicht standardisiert-
Eine Zeichenkette, die die Telefonnummer des Empfängers oder der Kontaktperson angibt.
PaymentAddress.postalCode
Schreibgeschützt Veraltet Nicht standardisiert-
Eine Zeichenkette, die einen Code angibt, der von einer Gerichtsbarkeit für die Postzustellung verwendet wird, wie z.B. die Postleitzahl in den Vereinigten Staaten oder der PIN-Code in Indien.
PaymentAddress.recipient
Schreibgeschützt Veraltet Nicht standardisiert-
Eine Zeichenkette, die den Namen des Empfängers, Käufers oder der Kontaktperson an der Zahlungsadresse angibt.
PaymentAddress.region
Schreibgeschützt Veraltet Nicht standardisiert-
Eine Zeichenkette, die die oberste Verwaltungseinheit des Landes enthält, beispielsweise ein Bundesstaat, eine Provinz, ein Gebiet oder eine Präfektur.
PaymentAddress.sortingCode
Schreibgeschützt Veraltet Nicht standardisiert-
Eine Zeichenkette, die einen Postsortiercode angibt, wie er in Frankreich verwendet wird.
Hinweis: Eigenschaften, für die keine Werte angegeben wurden, enthalten leere Zeichenketten.
Instanz-Methoden
PaymentAddress.toJSON()
Veraltet Nicht standardisiert-
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 annimmt — 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, das weitere Optionen enthält.
Das erste dieser drei (supportedInstruments
im untenstehenden Beispiel) enthält eine data
Eigenschaft, die der vom Zahlungsmethoden-Anbieter 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 Zahlungsablauf mithilfe von PaymentRequest.show()
ausgelöst wurde und das Versprechen erfolgreich aufgelöst wurde, enthält das PaymentResponse
Objekt, das aus dem erfüllten Versprechen (instrumentResponse
oben) verfügbar ist, eine PaymentResponse.details
Eigenschaft mit Antwortdetails. Diese muss der vom Zahlungsmethoden-Anbieter definierten Struktur entsprechen.
Browser-Kompatibilität
BCD tables only load in the browser