決済方法識別子

概要

この仕様は、決済方法識別子と、それらがどのように検証され、該当する場合には発行され、W3C に正式に登録されるかを定義します。他の仕様（例： Payment Request API）は、Web プラットフォーム上での金銭取引を容易にするために、これらの識別子を利用します。

この文書のステータス

この節は、この文書の公開時点におけるステータスを説明します。現在の W3C 公開文書の一覧と、この技術報告書の最新版は、 https://www.w3.org/TR/ にある W3C 技術報告書一覧で確認できます。

ワーキンググループは、実装報告を作成することで実装経験を示しています。この報告書は、テストスイート内の各必須テスト（すなわち、各テストが仕様の MUST 要件に対応しているもの）に合格する、2つ以上の独立した実装を示しています。

この仕様の開発中、他のワーキンググループへの依存関係に変更はありませんでした。

この文書は、Web Payments Working Group により、勧告トラックを用いた勧告として公開されました。

W3C は、Web の標準としてこの仕様が広く展開されることを推奨します。

W3C 勧告とは、広範な合意形成の後に W3C とその会員によって承認され、ワーキンググループのメンバーから、実装に対するロイヤリティフリーのライセンス供与の確約を得ている仕様です。この勧告の将来の更新には、新機能が組み込まれる可能性があります。

この文書は、 2017年8月1日 W3C 特許ポリシーの下で活動するグループによって作成されました。 W3C は、このグループの成果物に関連して行われた特許開示の公開一覧を維持しています。このページには、特許を開示するための手順も含まれています。個人が実際に知っている特許について、その特許が必須請求項を含むと考える場合、その個人は W3C 特許ポリシー第6節に従って情報を開示しなければなりません。

この文書は、 2021年11月2日 W3C プロセス文書に準拠します。

決済方法識別子（PMI）は、次のいずれかです。

URL ベースの決済方法識別子、
または、標準化された決済方法識別子。

決済方法識別子に依存する仕様は、無効な決済方法識別子を処理するための独自の規則を指定しなければなりません。

文字列 pmi を用いて決済方法識別子を検証する手順は、次のアルゴリズムで与えられます。これは、 pmi が有効な場合に true を返します。

url を、pmi を用いて基本 URL パーサーを実行した結果とします。
url が failure の場合は、pmi を用いて標準化された決済方法識別子を検証し、その結果を返します。
そうでなければ、url を渡して URL ベースの決済方法識別子を検証し、その結果を返します。

URL ベースの決済方法識別子は、 URL であり、URL ベースの決済方法識別子を検証する手順に従って有効なものです。

注記

サードパーティ決済ハンドラーに URL ベースの決済方法識別子を使用したい開発者には、 Payment Method Best Practice 文書を読むことが推奨されます。

URL ベースの決済方法識別子を検証する手順は、次のアルゴリズムで与えられます。このアルゴリズムは URL url を入力として受け取り、URL が有効な場合に true を返します。

url のスキームが "https" でない場合は、false を返します。
url のユーザー名またはパスワードが空文字列でない場合は、false を返します。
そうでなければ、true を返します。

例 1: 有効および無効な URL ベースの PMI

const valid = [
  {
    supportedMethods: "https://example.com/pay",
  },
  {
    supportedMethods: "https://example.com/pay?version=1",
  },
  {
    supportedMethods: "https://example.com/pay/version/1",
  },
];

const invalid = [
  {
    // ❌ http://、ユーザー名、パスワードを使用しています。
    supportedMethods: "http://username:password@example.com/pay",
  },
  {
    // ❌ 不明な URI スキームを使用しています。
    supportedMethods: "unknown://example.com/pay",
  },
];

ユーザーエージェントは、URL ベースの決済方法識別子の比較を、 [URL] の等価を用いて行わなければなりません。

ユーザーエージェントが取得することは 任意です。対象は URL ベースの決済方法識別子です。

標準化された決済方法識別子とは、標準化された決済方法を表す文字列です。

標準化された決済方法識別子の構文は、次の [ABNF] で与えられます。

stdpmi = part *( "-" part )
part = 1loweralpha *( DIGIT / loweralpha )
loweralpha =  %x61-7A

ユーザーエージェントは、第標準化された決済方法識別子を 0 個以上サポートしてもよく、それらは 4. 標準化された決済方法のレジストリに列挙されます。

標準化された決済方法識別子を検証する手順は、次のアルゴリズムで与えられます。このアルゴリズムは string を入力として受け取り、その識別子が有効な場合に true を返します。

string が標準化された決済方法識別子の構文に適合する場合は true を返します。そうでなければ false を返します。

注記

API で使用される場合、次の方法識別子はすべてユーザーエージェントによって無視されます。一部のユーザーエージェントは、開発者が問題を修正できるように、識別子が無効であることを通知することがあります。

以下の例では、"basic-card" という標準化された決済方法識別子を参照しています。Web Payments Working Group はその作業を中止していますが、この識別子はここでは例として用いられます。

例: 有効および無効な識別子

const valid = [
  {
    supportedMethods: "basic-card",
  },
];

const invalid = [
  {
    // ❌ 有効な範囲外の Unicode 文字を含んでいます。
    supportedMethods: "basic-💳",
  },
  {
    // ❌ 大文字を含んでいます。
    supportedMethods: "Basic-Card",
  },
  {
    // ❌ 有効な範囲外の Unicode 文字を含んでいます。
    supportedMethods: "¡basic-*-card!",
  },
];

標準化された決済方法識別子について、ユーザーエージェントは is を用いて文字列比較を行わなければなりません。

この節は非規範的です。

注記

標準化された決済方法とは、 W3C で標準化を経て、このレジストリに掲載されている決済方法です。

現時点では、標準化された決済方法識別子はありません。

この節は非規範的です。

サードパーティ決済ハンドラーに URL ベースの決済方法識別子を使用したい開発者には、 Payment Method Manifest 仕様と Payment Method Best Practice wiki ページを読むことが推奨されます。これらの文書は合わせて、ブラウザーによるジャストインタイムの決済ハンドラーインストールを含め、決済方法のために認可された決済ハンドラーのエコシステムを管理する方法を説明しています。

非規範的として示されている節に加え、この仕様に含まれるすべての作成ガイドライン、図、例、注記は非規範的です。この仕様内のそれ以外のすべては規範的です。

この文書におけるキーワード MAY、MUST、および OPTIONAL は、ここに示すようにすべて大文字で現れる場合に限り、 BCP 14 [RFC2119] [RFC8174] に記述されているとおりに解釈されます。

決済方法識別子 §1.
標準化された決済方法 §4.
標準化された決済方法識別子 §3.
標準化された決済方法識別子の構文 §3.
URL ベースの決済方法識別子 §2.
決済方法識別子を検証する §1.1
標準化された決済方法識別子を検証する §3.1
URL ベースの決済方法識別子を検証する §2.1

[FETCH] は次を定義します。
- fetch
[INFRA] は次を定義します。
- is（ string 用）
[PAYMENT-METHOD-MANIFEST] は次を定義します。
- Payment Method Manifest
[PAYMENT-REQUEST] は次を定義します。
- Payment Request API
[URL] は次を定義します。
- basic URL parser
- equal（ url 用）
- password（ url 用）
- scheme（ url 用）
- URL
- username（ url 用）

[ABNF]: Augmented BNF for Syntax Specifications: ABNF. D. Crocker, Ed.; P. Overell. IETF. January 2008. Internet Standard. URL: https://www.rfc-editor.org/rfc/rfc5234
[fetch]: Fetch Standard. Anne van Kesteren. WHATWG. Living Standard. URL: https://fetch.spec.whatwg.org/
[infra]: Infra Standard. Anne van Kesteren; Domenic Denicola. WHATWG. Living Standard. URL: https://infra.spec.whatwg.org/
[RFC2119]: Key words for use in RFCs to Indicate Requirement Levels. S. Bradner. IETF. March 1997. Best Current Practice. URL: https://www.rfc-editor.org/rfc/rfc2119
[RFC8174]: Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words. B. Leiba. IETF. May 2017. Best Current Practice. URL: https://www.rfc-editor.org/rfc/rfc8174
[URL]: URL Standard. Anne van Kesteren. WHATWG. Living Standard. URL: https://url.spec.whatwg.org/

[payment-method-manifest]: Payment Method Manifest. Dapeng(Max) Liu; Domenic Denicola; Zach Koch. W3C. 12 December 2017. W3C Working Draft. URL: https://www.w3.org/TR/payment-method-manifest/
[payment-request]: Payment Request API. Marcos Caceres; Rouslan Solomakhin; Ian Jacobs. W3C. 30 September 2021. W3C Proposed Recommendation. URL: https://www.w3.org/TR/payment-request/

決済方法識別子

概要

この文書のステータス

1. 決済方法識別子（PMI）

1.1 妥当性

2. URL ベースの決済方法識別子

2.1 検証

2.2 比較

2.3 取得（参照解決）

3. 標準化された決済方法識別子

3.1 妥当性

3.2 比較

4. 標準化された決済方法のレジストリ

5. URL ベースの PMI とサードパーティ決済ハンドラー

6. セキュリティに関する考慮事項

7. プライバシーに関する考慮事項

8. 適合性

A. 索引

A.1 この仕様で定義される用語

A.2 参照により定義される用語

B. 参考文献

B.1 規定参考文献

B.2 参考参考文献