支付方式标识符

摘要

本规范定义了支付方式标识符及其验证方式，并在适用情况下定义了如何创建这些标识符并将其正式注册到 W3C。其他规范（例如 Payment Request API）会使用这些标识符，以便在 Web 平台上促成货币交易。

本文档状态

本节描述了本文档在发布时的状态。当前 W3C 出版物列表以及本技术报告的最新修订版可在 W3C 技术报告索引中找到，网址为 https://www.w3.org/TR/。

工作组通过产出实现报告来展示实现经验。该报告表明，有两个或更多独立实现通过了测试套件中的每项强制性测试（即每个测试都对应于本规范的一项 MUST 要求）。

在本规范的制定过程中，对其他工作组的依赖没有发生变化。

本文档由 Web Payments Working Group 使用推荐标准轨道发布为推荐标准。

W3C 建议将本规范作为 Web 标准进行广泛部署。

W3C 推荐标准是一种规范，它在经过广泛共识建立后，由 W3C 及其成员认可，并且获得了工作组成员对实现进行免版税许可的承诺。本推荐标准的未来更新可以纳入新特性。

本文档由一个按照 2017 年 8 月 1 日 W3C 专利政策运作的工作组产出。 W3C 维护了一个与专利披露有关的公开列表，其中列出了与该组交付成果相关的披露；该页面还包含披露专利的说明。任何实际知悉某项专利，并认为该专利包含必要权利要求的个人，都必须按照 W3C 专利政策第 6 节披露该信息。

本文档受 2021 年 11 月 2 日 W3C 流程文档约束。

支付方式标识符（PMI）是以下二者之一：

基于 URL 的支付方式标识符，
或标准化支付方式标识符。

依赖于支付方式标识符的规范MUST 规定其自身处理无效支付方式标识符的规则。

使用字符串 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 的scheme 不是 "https"，则返回 false。
如果 url 的 username 或 password 不是空字符串，则返回 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",
  },
];

用户代理MUST使用 [URL] 的 equal 对基于 URL 的支付方式标识符执行比较。

用户代理可以选择OPTIONAL获取基于 URL 的支付方式标识符。

标准化支付方式标识符是一个表示标准化支付方式的字符串。

标准化支付方式标识符的语法由以下 [ABNF] 给出：

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

用户代理MAY支持第 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!",
  },
];

对于标准化支付方式标识符，用户代理MUST 使用 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，编辑；P. Overell。IETF。2008 年 1 月。互联网标准。URL：https://www.rfc-editor.org/rfc/rfc5234
[fetch]: Fetch Standard。Anne van Kesteren。WHATWG。现行标准。URL：https://fetch.spec.whatwg.org/
[infra]: Infra Standard。Anne van Kesteren；Domenic Denicola。WHATWG。现行标准。URL：https://infra.spec.whatwg.org/
[RFC2119]: Key words for use in RFCs to Indicate Requirement Levels。S. Bradner。IETF。1997 年 3 月。最佳当前实践。URL：https://www.rfc-editor.org/rfc/rfc2119
[RFC8174]: Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words。B. Leiba。IETF。2017 年 5 月。最佳当前实践。URL：https://www.rfc-editor.org/rfc/rfc8174
[URL]: URL Standard。Anne van Kesteren。WHATWG。现行标准。URL：https://url.spec.whatwg.org/

[payment-method-manifest]: Payment Method Manifest。 Dapeng(Max) Liu；Domenic Denicola；Zach Koch。W3C。2017 年 12 月 12 日。W3C 工作草案。URL：https://www.w3.org/TR/payment-method-manifest/
[payment-request]: Payment Request API。Marcos Caceres；Rouslan Solomakhin；Ian Jacobs。W3C。2021 年 9 月 30 日。W3C 候选推荐。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 资料性引用