PaymentAddress
==============

**安全なコンテキスト用:** この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。

 **非推奨:** この機能は非推奨になりました。まだ対応しているブラウザーがあるかもしれませんが、すでに関連するウェブ標準から削除されているか、削除の手続き中であるか、互換性のためだけに残されている可能性があります。使用を避け、できれば既存のコードは更新してください。このページの下部にある互換性一覧表を見て判断してください。この機能は突然動作しなくなる可能性があることに注意してください。

**非標準:** この機能は標準ではなく、標準化の予定もありません。公開されているウェブサイトには使用しないでください。ユーザーによっては使用できないことがあります。実装ごとに大きな差があることもあり、将来は振る舞いが変わるかもしれません。

**`PaymentAddress`** は支払いリクエスト API のインターフェイスで、配送先または支払い先住所情報を保存するために使用されます。

万国郵便連合のウェブページにある Addressing S42 standard という、郵便宛名の国際標準に関する資料を参照すると便利かもしれません。

プロパティ
-----

`PaymentAddress.addressLine` (en-US) 読取専用  
非推奨

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

`PaymentAddress.country` (en-US) 読取専用  
非推奨

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

`PaymentAddress.city` (en-US) 読取専用  
非推奨

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

`PaymentAddress.dependentLocality` (en-US) 読取専用  
非推奨

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

`PaymentAddress.organization` (en-US) 読取専用  
非推奨

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

`PaymentAddress.phone` (en-US) 読取専用  
非推奨

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

`PaymentAddress.postalCode` (en-US) 読取専用  
非推奨

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

`PaymentAddress.recipient` (en-US) 読取専用  
非推奨

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

`PaymentAddress.region` (en-US) 読取専用  
非推奨

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

`PaymentAddress.sortingCode` (en-US) 読取専用  
非推奨

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


**メモ:** 値が指定されていないプロパティには、空の文字列が含まれています。

メソッド
----

`PaymentAddress.toJSON()` (en-US) 
非推奨

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

例
-

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

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


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


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

ブラウザーの互換性
---------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.