このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docsコミュニティーについてもっと知り、仲間になるにはこちらから。
PaymentAddress
安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。
非推奨;: この機能は非推奨になりました。まだ対応しているブラウザーがあるかもしれませんが、すでに関連するウェブ標準から削除されているか、削除の手続き中であるか、互換性のためだけに残されている可能性があります。使用を避け、できれば既存のコードは更新してください。このページの下部にある互換性一覧表を見て判断してください。この機能は突然動作しなくなる可能性があることに注意してください。
非標準: この機能は標準化されていません。非標準の機能はブラウザーの対応が限られ、将来的に変更または削除される可能性があるため、本番環境での使用は推奨されません。ただし、標準の選択肢が存在しない特定のケースでは、有効な代替手段となる場合があります。
PaymentAddress は決済リクエスト API のインターフェイスで、配送先または支払い先住所情報を保存するために使用されます。
万国郵便連合のウェブページにあるAddressing S42 standard という、郵便宛名の国際標準に関する資料を参照すると便利かもしれません。
プロパティ
PaymentAddress.addressLine読取専用非推奨;非標準他のプロパティに含まれていない住所の各行を提供する文字列の配列。正確なサイズと内容は国や場所によって異なります。例: 通り名、住居番号、アパートの番号、地方の配達ルート、説明の説明、私書箱の番号など。
PaymentAddress.country読取専用非推奨;非標準文字列で、ISO-3166-1 alpha-2 標準を使用して、住所が配置されている国を指定します。この文字列は常に正規の大文字形式で指定されます。有効な
countryの値の例:"US","GB","CN","JP"PaymentAddress.city読取専用非推奨;非標準文字列で、住所の都市名または町名の部分を持ちます。
PaymentAddress.dependentLocality読取専用非推奨;非標準文字列で、都市に従属する地区またはサブ地区を示します。例: neighborhood, borough, district, イギリスの dependent locality
PaymentAddress.organization読取専用非推奨;非標準文字列で、支払い先住所にある組織、事業所、会社、機関などの名前を指定します。
PaymentAddress.phone読取専用非推奨;非標準文字列で、受領者または連絡担当者の電話番号を指定します。
PaymentAddress.postalCode読取専用非推奨;非標準文字列で、郵便物の配送経路として管轄の国が使用するコードを指定する文字列です。例: 米国の ZIP コード、インドの PIN コード、日本の郵便番号など。
PaymentAddress.recipient読取専用非推奨;非標準文字列で、支払い先住所の受取人、購入者、または連絡先の名前を示します。
PaymentAddress.region読取専用非推奨;非標準文字列で、国の最上位の行政区画 (州、都道府県など) を含みます。
PaymentAddress.sortingCode読取専用非推奨;非標準文字列で、フランスで使用されているような郵便ソートコードを提供します。
メモ:値が指定されていないプロパティには、空の文字列が含まれています。
インスタンスメソッド
PaymentAddress.toJSON()非推奨;非標準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 プロパティを保有します。これは、支払い方法の提供者によって定義された構造に適合していなければなりません。