Validity

The steps to validate a payment method identifier with a pmi string are given by the following algorithm. It returns either true or false.

1. Let url be the result of running the basic URL parser with pmi.
2. If url is failure, validate a standardized payment method identifier with pmi and return the result.
3. Otherwise, validate a URL-based payment method identifier passing url and return the result.

Validation

The steps to validate a URL-based payment method identifier are given by the following algorithm. The algorithm takes a url URL as input and returns true if the URL is valid:

1. If url's scheme is not "https", return false.
2. If url's username or password is not the empty string, return false.
3. Otherwise, return true.

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

          const bad = [
            {
              // ❌ Uses http://, a username, and a password.
              supportedMethods: "http://username:password@example.com/pay",
            },
            {
              // ❌ Uses unknown URI scheme.
              supportedMethods: "unknown://example.com/pay",
            },
          ];
        

Comparison

User agents MUST perform comparisons of URL-based payment method identifiers using equals. [[!URL]]

Validity

The steps to validate a standardized payment method identifier are given by the following algorithm. The algorithm takes a string as input and returns true if the identifier is valid:

1. Return true if string contains only [[!UNICODE]] code points:
   1. In the range U+0061-U+007A ("Latin Small Letter A" to "Latin Small Letter Z")
   2. In the range U+0030-U+0039 ("Digit Zero" to "Digit Nine").
   3. Zero or more U+002D HYPHEN-MINUS (-).
2. Otherwise, return false.

When minting a new standardized payment method identifier for the purpose of standardization, be sure that it conforms to the following regular expression: [a-z0-9-]+.

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

            const bad = [
              {
                // ❌ Contains Unicode character outside the valid ranges.
                supportedMethods: "💳-card",
              },
              {
                // ❌ Contains uppercase characters.
                supportedMethods: "Basic-Card",
              },
              {
                // ❌ Contains Unicode characters outside the valid ranges.
                supportedMethods: "¡basic-*-card!",
              },
            ];
          

Comparison

For standardized payment method identifiers, user agents MUST compare strings in a case-sensitive manner (code point for code point).