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, kann sie bereits aus den relevanten Webstandards entfernt worden sein, befindet sich im Prozess der Entfernung oder wird nur aus Kompatibilitätsgründen beibehalten. Vermeiden Sie die Verwendung und aktualisieren Sie gegebenenfalls bestehenden Code; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu treffen. Beachten Sie, dass diese Funktion jederzeit nicht mehr funktionieren kann.

Kein Standard: Diese Funktion ist nicht standardisiert und befindet sich nicht im Standardisierungsprozess. Verwenden Sie sie nicht auf Produktionsseiten, die auf das Web ausgerichtet sind: Sie wird nicht für alle Benutzer funktionieren. Außerdem kann es 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 Nur lesbar 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 Nur lesbar 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 Nur lesbar Veraltet Nicht standardisiert

Eine Zeichenkette, die den Stadt- oder Ortsteil der Adresse enthält.

PaymentAddress.dependentLocality Nur lesbar 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 Nur lesbar Veraltet Nicht standardisiert

Eine Zeichenkette, die den Namen der Organisation, Firma, des Unternehmens oder der Institution an der Zahlungsadresse angibt.

PaymentAddress.phone Nur lesbar Veraltet Nicht standardisiert

Eine Zeichenkette, die die Telefonnummer des Empfängers oder der Kontaktperson angibt.

PaymentAddress.postalCode Nur lesbar 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 Nur lesbar Veraltet Nicht standardisiert

Eine Zeichenkette, die den Namen des Empfängers, Käufers oder der Kontaktperson an der Zahlungsadresse angibt.

PaymentAddress.region Nur lesbar 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 Nur lesbar 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.

js
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