결제 수단 식별자

개요

이 명세는 결제 수단 식별자와 그 유효성이 검증되는 방식, 그리고 해당되는 경우 W3C에서 발행되고 공식적으로 등록되는 방식을 정의합니다. 다른 명세(예: Payment Request API)는 이러한 식별자를 사용하여 웹 플랫폼에서 금전 거래를 용이하게 합니다.

이 문서의 상태

이 절은 이 문서가 공개된 시점의 상태를 설명합니다. 현재 W3C 간행물 목록과 이 기술 보고서의 최신 개정판은 https://www.w3.org/TR/의 W3C 기술 보고서 색인에서 확인할 수 있습니다.

워킹 그룹은 구현 보고서를 작성하여 구현 경험을 입증합니다. 이 보고서는 두 개 이상의 독립적인 구현이 테스트 스위트의 각 필수 테스트를 통과함을 보여줍니다(즉, 각 테스트는 명세의 MUST 요구 사항에 해당합니다).

이 명세의 개발 중에 다른 워킹 그룹에 대한 의존성에는 변경이 없었습니다.

이 문서는 Web Payments Working Group에 의해 권고안 트랙을 사용한 권고안으로 공개되었습니다.

W3C는 웹의 표준으로서 이 명세의 광범위한 배포를 권장합니다.

W3C 권고안은 광범위한 합의 형성 이후 W3C와 그 회원들이 승인하고, 워킹 그룹 구성원들이 구현을 위한 로열티 없는 라이선스 제공을 약속한 명세입니다. 이 권고안의 향후 업데이트에는 새 기능이 포함될 수 있습니다.

이 문서는 2017년 8월 1일 W3C 특허 정책에 따라 운영되는 그룹에 의해 작성되었습니다. W3C는 그룹의 산출물과 관련하여 이루어진 모든 특허 공개의 공개 목록을 유지합니다. 해당 페이지에는 특허 공개 지침도 포함되어 있습니다. 개인이 필수 청구항을 포함한다고 믿는 특허에 대한 실제 지식을 가지고 있는 경우, 그 개인은 W3C 특허 정책 제6절에 따라 해당 정보를 공개해야 합니다.

이 문서는 2021년 11월 2일 W3C 프로세스 문서의 적용을 받습니다.

결제 수단 식별자(PMI)는 다음 중 하나입니다.

URL 기반 결제 수단 식별자,
또는 표준화된 결제 수단 식별자.

결제 수단 식별자에 의존하는 명세는 유효하지 않은 결제 수단 식별자를 처리하기 위한 자체 규칙을 MUST 지정해야 합니다.

문자열 pmi로 결제 수단 식별자를 검증하는 단계는 다음 알고리즘에 제시되어 있습니다. 이 알고리즘은 pmi가 유효하면 true를 반환합니다.

url을 pmi로 기본 URL 파서를 실행한 결과라고 합니다.
url이 실패이면, pmi로 표준화된 결제 수단 식별자를 검증하고 그 결과를 반환합니다.
그렇지 않으면, url을 전달하여 URL 기반 결제 수단 식별자를 검증하고 그 결과를 반환합니다.

URL 기반 결제 수단 식별자는 URL이며, URL 기반 결제 수단 식별자를 검증하는 단계에 따라 유효한 것입니다.

참고

제3자 결제 처리기를 위해 URL 기반 결제 수단 식별자를 사용하려는 개발자는 Payment Method Best Practice 문서를 읽는 것이 권장됩니다.

URL 기반 결제 수단 식별자를 검증하는 단계는 다음 알고리즘에 제시되어 있습니다. 이 알고리즘은 URL url을 입력으로 받아, 해당 URL이 유효하면 true를 반환합니다.

url의 스킴이 "https"가 아니면 false를 반환합니다.
url의 사용자 이름 또는 비밀번호가 빈 문자열이 아니면 false를 반환합니다.
그렇지 않으면 true를 반환합니다.

예제 1: 유효한 URL 기반 PMI와 유효하지 않은 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]의 같음을 사용하여 MUST 수행해야 합니다.

사용자 에이전트가 가져오기를 URL 기반 결제 수단 식별자에 대해 수행하는 것은 OPTIONAL입니다.

표준화된 결제 수단 식별자는 표준화된 결제 수단을 나타내는 문자열입니다.

표준화된 결제 수단 식별자의 구문은 다음 [ABNF]로 제시됩니다.

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

사용자 에이전트는 제표준화된 결제 수단 식별자를 0개 이상 지원할 MAY 있습니다. 해당 식별자는 4. 표준화된 결제 수단 레지스트리 절에 나열됩니다.

표준화된 결제 수단 식별자를 검증하는 단계는 다음 알고리즘에 제시되어 있습니다. 이 알고리즘은 string을 입력으로 받아, 해당 식별자가 유효하면 true를 반환합니다.

string이 표준화된 결제 수단 식별자의 구문을 준수하면 true를 반환합니다. 그렇지 않으면 false를 반환합니다.

참고

API에서 사용될 때, 다음 수단 식별자들은 모두 사용자 에이전트에 의해 무시됩니다. 일부 사용자 에이전트는 개발자가 문제를 수정할 수 있도록 식별자가 유효하지 않음을 알릴 수 있습니다.

아래 예제는 "basic-card" 표준화된 결제 수단 식별자를 참조합니다. Web Payments Working Group이 해당 작업을 중단했지만, 이 식별자는 여기서 예제로 사용됩니다.

예제: 유효한 식별자와 유효하지 않은 식별자

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

const invalid = [
  {
    // ❌ 유효한 범위 밖의 유니코드 문자를 포함합니다.
    supportedMethods: "basic-💳",
  },
  {
    // ❌ 대문자를 포함합니다.
    supportedMethods: "Basic-Card",
  },
  {
    // ❌ 유효한 범위 밖의 유니코드 문자를 포함합니다.
    supportedMethods: "¡basic-*-card!",
  },
];

표준화된 결제 수단 식별자에 대해, 사용자 에이전트는 is를 사용하여 문자열 비교를 MUST 수행해야 합니다.

이 절은 비규범적입니다.

참고

표준화된 결제 수단은 W3C에서 표준화를 거쳤으며 이 레지스트리에 나열된 결제 수단입니다.

현재 표준화된 결제 수단 식별자는 없습니다.

이 절은 비규범적입니다.

제3자 결제 처리기를 위해 URL 기반 결제 수단 식별자를 사용하려는 개발자는 Payment Method Manifest 명세와 Payment Method Best Practice 위키 페이지를 읽는 것이 권장됩니다. 이 문서들은 함께, 브라우저에 의한 적시 결제 처리기 설치를 포함하여 결제 수단을 위한 승인된 결제 처리기의 생태계를 관리하는 방법을 설명합니다.

결제 수단 식별자 §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]은 다음을 정의합니다.
- 기본 URL 파서
- 같음(url의 경우)
- 비밀번호(url의 경우)
- 스킴(url의 경우)
- URL
- 사용자 이름(url의 경우)

[ABNF]: Augmented BNF for Syntax Specifications: ABNF. D. Crocker, Ed.; 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와 제3자 결제 처리기

6. 보안 고려 사항

7. 개인정보 보호 고려 사항

8. 적합성

A. 색인

A.1 이 명세에서 정의한 용어

A.2 참조로 정의된 용어

B. 참고 문헌

B.1 규범 참고 문헌

B.2 정보 참고 문헌