일반 패스 개요
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
일반 패스는 사용 사례가 사전 정의된 다른 패스 유형에 맞지 않는 경우에 사용할 수 있습니다. 티켓, 포인트 카드, 쿠폰과 같이 사용 사례와 관련된 필드 및 기능이 포함된 다른 패스와 달리 일반 패스는 커스텀 라벨 및 값을 정의할 수 있는 필드를 제공하여 다양한 목적을 지원할 수 있도록 유연합니다.
사용 사례 예시
다음은 일반 패스 유형으로 할 수 있는 작업의 몇 가지 예시입니다.
- 주차권
- 도서관 카드
- 멤버십 카드
- 보험 카드
- 예약 확인
- 고객의 사전 화면 확인 코드
패스 또는 사용 사례에 개인 식별 정보 (PII) 및 건강 데이터와 같은 민감한 정보가 포함될 수 있습니다. 이러한 시나리오의 경우 사전 승인된 사용 사례에 일반 비공개 패스 유형을 사용할 수 있습니다. 자세한 내용은 일반 비공개 패스 문서 및 서비스이용 정책 (AUP)을 참고하세요.
Google Wallet API를 사용하면 사용자가 패스를 발급하여 Android 앱을 비롯한 여러 플랫폼과 웹사이트, 이메일, SMS 메시지와 같은 하이퍼링크가 지원되는 모든 곳에서 Google 월렛에 저장할 수 있습니다.
API 및 SDK
Google Wallet API는 패스를 빠르고 쉽게 발급하고 관리할 수 있도록 REST API와 Android SDK를 제공합니다.
- Google 월렛 REST API
웹, 이메일 또는 SMS와 같은 플랫폼에서 패스를 발급하려면 Google Wallet REST API를 사용하는 것이 좋습니다. API는 패스의 다양한 구성요소를 생성, 검색, 업데이트할 수 있는 일련의 엔드포인트를 제공합니다.
- Google 월렛 Android SDK
Android 앱에서 패스를 발급하려면 Google 월렛 Android SDK를 사용하는 것이 좋습니다. SDK는 네이티브 코드를 사용하여 Google Wallet API를 모바일 앱에 쉽게 통합할 수 있는 다양하고 편리한 메서드를 제공합니다.
참고: Google Wallet API 또는 Google Wallet Android SDK를 사용하여 Google Wallet API에서 패스를 발급할 필요는 없지만 사용하는 것이 좋습니다. REST API 또는 Android SDK를 사용하지 않고 패스를 발급하는 방법에 대한 자세한 내용은 JWT에서 패스 객체 및 패스 클래스 만들기를 참조하세요.
요구사항
Google Wallet API로 패스를 발급하려면 먼저 다음을 수행해야 합니다.
Google Wallet API 시작하기
Google Wallet API를 사용하기 전에 기본 기능 및 용어를 익힐 수 있는 유용한 도움말을 살펴보세요.
- 주요 개념 및 용어: 이 도움말은 Google Wallet API를 사용하는 데 필요한 모든 중요한 용어 및 기능을 설명합니다.
- 패스 클래스 및 객체 개요: 사용자에게 발급하는 패스는 패스 클래스를 패스 객체와 결합하여 생성됩니다. 이 도움말에서는 이러한 두 가지 개념과 패스를 만드는 데 이러한 개념을 사용하는 방법을 설명합니다.
- Google 월렛 패스 개발 과정: 이 도움말에서는 Google Wallet API로 패스를 만드는 데 필요한 모든 단계를 처음부터 끝까지 설명합니다.
- Codelab
셀프 가이드 Codelabs에서는 Google 월렛에 패스를 추가하는 데 필요한 단계를 안내합니다. 시작하려면 Android 기기에만 구현하려는 경우 'Android'를 선택하고
Android, 웹, 이메일 또는 SMS를 지원하는 경우 '웹'을 선택하세요.
Android
웹
- 패스 빌더
패스 빌더 도구로 첫 번째 패스를 시각적으로 빌드하고 Google Wallet API로 패스를 만드는 데 필요한 JSON을 자동으로 생성합니다.
- Google 월렛 GitHub
Google 월렛 GitHub 조직에서 다양한 프로그래밍 언어에 대한 유용한 도구, 라이브러리, 샘플 코드를 확인하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-29(UTC)
[null,null,["최종 업데이트: 2025-08-29(UTC)"],[[["\u003cp\u003eThe Generic Pass is a versatile pass type in Google Wallet, suitable for various use cases beyond standard tickets or loyalty cards, allowing custom data through defined labels and values.\u003c/p\u003e\n"],["\u003cp\u003eSensitive information like PII should be handled using the Generic Private pass type, with pre-approval needed for specific use cases.\u003c/p\u003e\n"],["\u003cp\u003eGoogle Wallet API enables pass creation and management across Android, web, and messaging platforms through REST API and Android SDK.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers need a Google Wallet API Issuer Account, along with a Google Cloud Account (non-Android) or Google Play Services setup (Android).\u003c/p\u003e\n"],["\u003cp\u003eGoogle offers resources like codelabs, a pass builder tool, and GitHub repositories to help developers integrate and utilize the Google Wallet API effectively.\u003c/p\u003e\n"]]],["The Generic Pass in Google Wallet supports diverse purposes with custom labels and values, such as parking, library, or membership cards. For sensitive data, there's a Generic Private pass option. Passes can be issued across platforms, using the REST API for web, email, or SMS, and the Android SDK for Android apps. Issuers need a Google Wallet API account; non-Android developers also need a Google Cloud account. Key resources include codelabs, a pass builder, and the Google Wallet GitHub.\n"],null,["# Generic Pass overview\n\nThe Generic Pass is available for when your use case doesn't fit into any of the\nother predefined pass types. Unlike other passes that include fields and features\nthat are specific to a use case, such as tickets, loyalty cards, and offers, the\nGeneric Pass is intended to be flexible enough to support a variety of purposes\nby providing fields where you can define custom labels and values.\n\nExample use cases\n-----------------\n\nThe following are just a few examples of what you can do with the Generic pass\ntype:\n\n- Parking passes\n- Library cards\n- Membership cards\n- Insurance cards\n- Reservation confirmations\n- Customer pre-screen confirmation codes\n\nPasses that include sensitive information\n-----------------------------------------\n\nThere are cases where your pass or use case may involve sensitive information,\nsuch as personally identifiable information (PII) and health data. For these\nscenarios, the Generic Private pass type is available for pre-approved use\ncases. For more information, see the [Generic Private Pass documentation](/wallet/generic-private-pass)\nand the [Acceptable Use Policy (AUP)](https://payments.developers.google.com/terms/aup#sensitive-data).\n\nSupported platforms\n-------------------\n\nWith the Google Wallet API, you can issue passes for your users to save in their Google Wallet across multiple platforms, including Android apps, and anywhere hyperlinks are supported, such as websites, email, and SMS messages.\n\n### APIs \\& SDKs\n\nThe Google Wallet API offers a REST API and an Android SDK to help you issue and manage your passes quickly and easily.\n\n- [Google Wallet REST API](/wallet/generic/web/prerequisites) \n\n To issue passes on platforms such as the Web, email, or SMS, we recommend you use the Google Wallet REST API. The API provides a set of endpoints that let you create, retrieve, and update the various components of passes.\n- [Google Wallet Android SDK](/wallet/generic/android/prerequisites) \n\n To issue passes in an Android app, we recommend you use the Google Wallet Android SDK. The SDK provides a variety of convenience methods that make it easy to integrate the Google Wallet API into your mobile apps using native code.\n\nNote: Using the Google Wallet REST API or Google Wallet Android SDK is not required to issue passes with the Google Wallet API, but are strongly recommended. For more information on issuing passes without using the REST API or Android SDK, see [Creating Passes Objects and Passes Classes in the JWT](https://developers.google.com/wallet/retail/offers/overview/add-to-google-wallet-flow#creating-passes-objects-and-passes-classes-in-the-jwt).\n\nRequirements\n------------\n\nTo issue passes with the Google Wallet API, you will first need to do the following:\n\n- Create a [Google Wallet API Issuer account](/wallet/generic/getting-started/issuer-onboarding).\n- Non-Android developers: Create a [Google Cloud account](https://console.cloud.google.com/freetrial).\n- Android developers: [Set up Google Play services.](/android/guides/setup)\n\nGetting started with the Google Wallet API\n------------------------------------------\n\nBefore you start working with the Google Wallet API, take a look at these useful articles that will familiarize you with the basic features and terminology.\n\n- [Key concepts and terminology](/wallet/generic/resources/terminology): This article will familiarize you with all the important terms and features you will need to work with the Google Wallet API.\n- [Passes Classes and Objects overview](/wallet/generic/overview/how-classes-objects-work): Passes that you issue to your users are created by combining a Passes Class with a Passes Objects. This article will familiarize you with both of these concepts, and how they are used to create passes.\n- [Google Wallet pass development flow](/wallet/generic/overview/add-to-google-wallet-flow): This article provides an end-to-end overview of all of the steps needed to create a pass with the Google Wallet API from start to finish.\n\n### Tools \\& resources\n\n- **Codelabs** \n\n\n Self-guided codelabs walk you through the necessary steps to add a pass\n to Google Wallet. To get started, choose \"Android\" if your implementation will be on Android devices\n only and choose \"Web\" if your implementation supports Android, Web, Email or SMS.\n\n\n [Android](https://g.co/wallet/android-codelab)\n [Web](https://g.co/wallet/web-codelab)\n- **Pass builder** \n\n Build your first pass visually with the [pass builder](/wallet/generic/resources/pass-builder) tool, and automatically generate the JSON you need to create the pass with the Google Wallet API.\n- **Google Wallet Github**\n\n Get helpful tools, libraries and sample code for a variety of programming languages in the [Google Wallet Github org](https://github.com/google-wallet)."]]