PaymentAddress

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.

PaymentAddress.toJSON() Veraltet Nicht standardisiert

Ein Standard-Serializer, der eine JSON-Darstellung der Eigenschaften des PaymentAddress-Objekts zurückgibt.

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.