이 문서에는 Google Wallet API 사용 시 알고 있어야 하는 일반적인 용어와 개념이 나와 있습니다.
패스
통과
패스는 Google 월렛에 저장하도록 사용자에게 발급되는 패스 객체의 인스턴스입니다. Google Wallet API는 탑승권, 이벤트 티켓, 신분증 등 여러 일반적인 패스 유형을 지원합니다. Google Wallet API는 또한 특별히 지원되지 않는 패스를 만드는 데 사용할 수 있는 일반 패스 유형을 제공합니다.
대부분의 경우 패스는 패스 클래스와 패스 객체를 모두 사용하여 생성됩니다.
패스 발급기관
패스 발급기관은 패스를 만들고 사용자에게 발급하여 Google 월렛에 저장하는 기관입니다. 패스 발급기관이 패스를 소유하며 패스를 생성, 발급, 업데이트할 수 있습니다. 패스 발급기관은 개인 개발자, 회사, 조직은 물론 소매업체를 위한 이벤트 티켓이나 쿠폰 구현을 전문으로 하는 회사와 같이 다른 사람을 대신하여 패스를 만들고 발급하는 애그리게이터가 될 수 있습니다.
패스 클래스
패스 클래스는 패스를 만드는 공유 템플릿이라고 생각할 수 있습니다. 패스 클래스는 이를 사용하는 모든 패스에 포함될 특정 속성을 정의합니다. 패스 발급기관은 여러 개의 클래스를 만들 수 있으며, 각 클래스는 스타일 및 모양과 같은 속성뿐 아니라 스마트 탭, 등록 및 로그인과 같은 추가 기능을 정의하는 고유한 속성 집합을 포함합니다.
대부분의 경우 패스는 패스 템플릿을 정의하는 패스 클래스와 발급되는 개별 패스의 세부사항을 정의하는 패스 객체를 제공하여 생성됩니다.
패스 객체
패스 객체는 Google 월렛에 저장하기 위해 사용자에게 발급되는 개별 패스를 정의합니다. 패스 객체에는 사용자별 정보가 포함되는 경우가 많습니다. 예를 들어 패스 클래스는 특정 매장의 기프트 카드 패스를 정의할 수 있는 반면, 패스 객체는 잔액 또는 만료일과 같은 특정 세부정보를 제공합니다.
패스 객체는 여러 패스 인스턴스에서 공유할 수 있는 패스 클래스와 달리 발급된 모든 패스에 대해 생성되어야 합니다.
비공개 패스
Google Wallet API로 만든 일부 패스에는 민감한 사용자 데이터가 포함될 수 있습니다. 이러한 패스는 사용자 데이터를 안전하게 보호하기 위해 추가 보호가 필요하며 Google Wallet API에서는 일반 비공개 패스 유형을 사용하여 다르게 관리됩니다. 일반 비공개 패스는 민감한 정보 (Google Wallet API 서비스이용 정책에 정의됨)가 패스에 포함되어 있는 경우에 사용해야 하며, 온보딩 중에 추가적인 개인 정보 보호 설정 및 검토가 적용될 수 있습니다.
스마트 탭
스마트 탭은 휴대기기와 NFC 단말기 간에 데이터를 전달하기 위한 Google의 독점적인 근거리 무선 통신 프로토콜입니다. 스마트 탭 기술을 통해 사용자는 휴대전화를 호환되는 NFC 단말기에 가까이 대면 Google 월렛에 저장된 패스를 사용할 수 있습니다.
패스에 스마트 탭 프로토콜을 사용하려면 스마트 탭 지원 단말기 공급업체와 관계를 맺어야 합니다.
API 및 SDK
Google 월렛 API
Google Wallet API는 사용자가 Google 월렛에 저장할 수 있는 패스를 만들고 발급할 수 있도록 Google에서 제공하는 서비스입니다. 이 API는 Google Wallet REST API, Google 월렛 Android SDK, Google 월렛 콘솔을 비롯한 다양한 방식으로 사용할 수 있습니다.
Google 월렛 REST API
Google Wallet REST API는 Google Wallet API에 HTTP 요청을 전송하여 프로그래매틱 방식으로 패스를 만들고 관리하기 위한 인터페이스입니다.
Google Wallet REST API를 사용하려면 Google Cloud 계정이 있어야 서비스 계정을 만들 수 있습니다. 이 계정은 Google Wallet REST API 요청을 인증하는 데 사용됩니다.
Google 월렛 Android SDK
Google 월렛 Android SDK는 패스 생성 및 발급과 같이 Android 앱에서 Google Wallet API를 사용하기 위한 일련의 편리한 메서드를 제공합니다.
Google 월렛에 추가
'Google 월렛에 추가' 버튼
'Google 월렛에 추가' 버튼은 사용자에게 패스를 표시하기 위해 Google에서 승인한 애셋입니다. 사용자가 버튼을 클릭하거나 탭하면 'Google 월렛에 추가' 링크가 트리거되어 발급된 패스를 사용자의 Google 월렛에 추가하는 과정이 시작됩니다.
'Google 월렛에 추가' 버튼은 사용자가 이미 상호작용 방법을 알고 있는 친숙한 UI 요소이므로 가능하면 항상 사용하는 것이 좋습니다.
버튼 사용에 관한 애셋 및 가이드라인은 Google Wallet API 브랜드 가이드라인에서 확인할 수 있습니다.
'Google 월렛에 추가' 링크
'Google 월렛에 추가' 링크를 사용하면 일반 하이퍼링크로 사용자에게 패스를 발급할 수 있습니다. 이 기능은 이메일, SMS, 웹사이트, 모바일 앱 등 하이퍼링크를 사용할 수 있는 곳이면 어디에서나 사용할 수 있습니다.
'Google 월렛에 추가' 링크는 서명된 JWT를 URL https://pay.google.com/gp/v/save/에 추가하여 생성합니다.
발급기관 계정
데모 모드
발급기관 계정을 만들면 게시 액세스 권한이 승인될 때까지 '데모 모드' 상태가 됩니다. 데모 모드에서는 패스를 만들 수 있지만 발급기관 계정의 '관리자' 또는 '개발자' 역할이 있는 사용자나 Google 월렛 콘솔에서 테스트 계정으로 추가된 사용자에게만 패스를 발급할 수 있습니다.
'데모 모드'에서는 발권된 패스의 제목이 '[테스트 전용]'으로 시작되어 테스트 목적으로만 사용될 수 있음을 나타냅니다.
테스트 계정
발급기관 계정이 '데모 모드'일 때 계정에 대한 '관리자' 또는 '개발자' 역할이 없는 사용자에게 패스를 발급하려면 Google 월렛 콘솔에서 해당 사용자를 테스트 계정으로 추가해야 합니다. 테스트 계정으로 등록한 사용자는 내가 발급한 패스를 Google 월렛에 추가할 수 있습니다. 이 기능은 '데모 모드'에서 더 많은 잠재고객을 대상으로 패스를 테스트하는 데 유용합니다.
비즈니스 프로필
Google Wallet API 발급기관 계정을 만들려면 Google Pay 및 월렛 콘솔에 등록할 때 비즈니스 프로필을 설정해야 합니다. 비즈니스 프로필은 Google에 회사 또는 조직에 관한 기본 정보를 제공하며 게시 액세스 승인을 받아야 합니다.
게시 액세스 권한
모든 사용자가 Google 월렛에 저장할 수 있는 패스를 발급하려면 게시 액세스 권한을 승인받아야 합니다. 게시 액세스 승인을 받으려면 패스 클래스를 하나 이상 만들고 완전한 비즈니스 프로필을 가지고 있어야 합니다. Google 월렛 Android SDK를 사용하여 패스를 발급하려는 발급기관은 앱의 SHA-1 지문도 제출해야 합니다.
게시 액세스를 요청하려면 Google 월렛 콘솔로 이동하여 '게시 액세스 요청' 버튼을 클릭하세요. Google 월렛 팀에서 요청을 검토한 후 게시 액세스 권한이 부여되면 알려 드립니다.
인증
JSON 웹 토큰(JWT)
JSON 웹 토큰은 정보를 JSON 객체로 안전하게 전송하기 위해 일반적으로 사용되는 업계 표준입니다. Google Wallet API를 사용하는 경우 JWT('jot'라고 발음함) 형식의 패스 인스턴스를 만드는 데 사용할 패스 객체의 세부정보를 인코딩한 다음 해당 JWT를 Google Wallet API 요청에 포함하여 전송합니다.
JWT는 Google Wallet API로 전송되기 전에 공유 비밀번호로 서명하여 안전하게 보호됩니다. Google Wallet REST API를 사용하는 경우 서명 비밀번호는 Google Cloud 서비스 계정 키입니다. Google 월렛 Android SDK를 사용하는 경우 서명 비밀번호는 Android 앱의 SHA-1 지문입니다.
서비스 계정
Google Cloud 서비스 계정은 일반적으로 사용자가 아닌 애플리케이션 또는 컴퓨팅 워크로드에서 사용하는 특별한 종류의 계정입니다. Google Wallet API의 경우, 서비스 계정은 Google Wallet REST API로 전송된 요청을 인증하는 데 사용됩니다.
서비스 계정은 Google Cloud 콘솔에서 생성됩니다. 또한 서비스 계정을 사용하려면 서비스 계정이 Google Wallet REST API에 요청할 수 있도록 Cloud 콘솔에서 Google Wallet API를 사용 설정해야 합니다.
서비스 계정 키
서비스 계정 키는 Google Wallet REST API 호출을 인증하는 데 사용할 사용자 인증 정보입니다. 서비스 계정 키는 패스 클래스 및 패스 객체 생성을 비롯하여 Google Wallet REST API를 사용하여 계정의 패스 발급기관 기능에 액세스할 수 있는 권한을 부여하므로 매우 민감하며 비공개로 유지해야 합니다.
SHA-1 디지털 지문
Android 앱 서명 인증서의 SHA-1 지문은 Google 월렛 Android SDK를 사용할 때 Google Wallet API 호출을 인증하는 데 사용하는 사용자 인증 정보입니다. 인증서의 SHA-1 지문은 Gradle 또는 keytool을 사용하여 생성됩니다. 지문을 사용하여 요청을 인증하려면 Google 월렛 콘솔에 지문을 등록해야 합니다.