PaymentAddress

PaymentAddress.addressLine 読取専用 非推奨 Non-standard

他のプロパティに含まれていない住所の各行を提供する文字列の配列。正確なサイズと内容は国や場所によって異なります。例: 通り名、住居番号、アパートの番号、地方の配達ルート、説明の説明、私書箱の番号など。

PaymentAddress.country 読取専用 非推奨 Non-standard

文字列で、 ISO-3166-1 alpha-2 標準を使用して、住所が配置されている国を指定します。この文字列は常に正規の大文字形式で指定されます。有効な country の値の例: "US", "GB", "CN", "JP"

PaymentAddress.city 読取専用 非推奨 Non-standard

文字列で、住所の都市名または町名の部分を持ちます。

PaymentAddress.dependentLocality 読取専用 非推奨 Non-standard

文字列で、都市に従属する地区またはサブ地区を示します。例: neighborhood, borough, district, イギリスの dependent locality

PaymentAddress.organization 読取専用 非推奨 Non-standard

文字列で、支払い先住所にある組織、事業所、会社、機関などの名前を指定します。

PaymentAddress.phone 読取専用 非推奨 Non-standard

文字列で、受領者または連絡担当者の電話番号を指定します。

PaymentAddress.postalCode 読取専用 非推奨 Non-standard

文字列で、郵便物の配送経路として管轄の国が使用するコードを指定する文字列です。例: 米国の ZIP コード、インドの PIN コード、日本の郵便番号など。

PaymentAddress.recipient 読取専用 非推奨 Non-standard

文字列で、支払い先住所の受取人、購入者、または連絡先の名前を示します。

PaymentAddress.region 読取専用 非推奨 Non-standard

文字列で、国の最上位の行政区画 (州、都道府県など) を含みます。

PaymentAddress.sortingCode 読取専用 非推奨 Non-standard

文字列で、フランスで使用されているような郵便ソートコードを提供します。

PaymentAddress.toJSON() 非推奨 Non-standard

PaymentAddress オブジェクトのプロパティの JSON 表現を返す標準のシリアライザー。

次の例では、 PaymentRequest() コンストラクターを使用して、新しい支払い要求を作成しています。これは、 3 つのオブジェクトを引数して取ります。 1 つは支払いに使用できる支払い方法の詳細を含むオブジェクト、 1 つは実際の注文の詳細（購入アイテムや配送オプションなど）が入ったオブジェクト、もう 1 つは追加のオプションを含むオプションオブジェクトです。

これら 3 つのうち最初のもの（下の例では supportedInstruments）は、支払い方法で定義された構造に準拠しなければならない data プロパティを保有しています。

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();

PaymentRequest.show() を使用して支払いフローが起動され、プロミスが正常に解決されると、満たされたプロミス（上記の instrumentResponse）から利用できる PaymentResponse オブジェクトは、レスポンスの詳細を含む PaymentResponse.details プロパティを保有します。これは、支払い方法の提供者によって定義された構造に適合していなければなりません。