Présentation de la carte générique
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
La carte générique est disponible lorsque votre cas d'utilisation ne correspond à aucun
d'autres types de cartes prédéfinis. Contrairement à d'autres cartes qui incluent des champs et des éléments
propres à un cas d'utilisation, comme les billets, les cartes de fidélité et les offres,
La carte générique est conçue pour être suffisamment flexible pour répondre à divers besoins
en fournissant des champs dans lesquels vous pouvez définir des valeurs et des étiquettes personnalisées.
Exemples de cas d'utilisation
Voici quelques exemples de ce que vous pouvez faire avec la carte générique
type:
- Tickets de stationnement
- Cartes de bibliothèque
- Cartes de membre
- Cartes d'assurance
- Confirmations de réservation
- Codes de confirmation de présélection des clients
Dans certains cas, votre carte ou votre cas d'utilisation peuvent comporter des informations sensibles,
telles que les informations
permettant d'identifier l'utilisateur et les données de santé. Pour ces
dans certains cas, le type de carte privée générique peut être utilisé
cas d'utilisation. Pour en savoir plus, consultez la documentation sur les cartes privées génériques.
et la Politique d'utilisation autorisée (PUA).
L'API Google Wallet vous permet d'émettre des cartes que vos utilisateurs peuvent enregistrer dans leur compte Google Wallet sur plusieurs plates-formes, y compris les applications Android, et partout où les liens hypertexte sont compatibles, tels que les sites Web, les e-mails et les SMS.
API et SDK
L'API Google Wallet propose une API REST et un SDK Android pour vous aider à émettre et à gérer vos cartes rapidement et facilement.
- API REST Google Wallet
Pour émettre des cartes sur des plates-formes telles que le Web, les e-mails ou les SMS, nous vous recommandons d'utiliser l'API REST Google Wallet. L'API fournit un ensemble de points de terminaison qui vous permettent de créer, de récupérer et de mettre à jour les différents composants des cartes.
- SDK Google Wallet pour Android
Pour émettre des cartes dans une application Android, nous vous recommandons d'utiliser le SDK Google Wallet pour Android. Le SDK propose diverses méthodes pratiques qui facilitent l'intégration de l'API Google Wallet dans vos applications mobiles à l'aide de code natif.
Remarque: L'utilisation de l'API REST de Google Wallet ou du SDK Android Google Wallet n'est pas nécessaire pour émettre des cartes avec l'API Google Wallet, mais elle est vivement recommandée. Pour en savoir plus sur l'émission de cartes sans utiliser l'API REST ni le SDK Android, consultez Créer des objets de carte et des classes de carte dans le jeton JWT.
Conditions requises
Pour émettre des cartes avec l'API Google Wallet, vous devez d'abord procéder comme suit:
<ph type="x-smartling-placeholder">
Premiers pas avec l'API Google Wallet
Avant de commencer à utiliser l'API Google Wallet, consultez ces articles utiles pour vous familiariser avec les fonctionnalités de base et la terminologie.
- Codelabs
Des ateliers de programmation autoguidés vous expliquent comment ajouter une carte
à Google Wallet. Pour commencer, sélectionnez "Android" si votre implémentation est destinée aux appareils Android
et sélectionnez "Web" si votre mise en œuvre est compatible avec Android, le Web, les e-mails ou les SMS.
Android
Web
- Outil de création de cartes
Créez votre première carte visuellement à l'aide de l'outil de création de cartes, puis générez automatiquement le fichier JSON dont vous avez besoin pour créer la carte avec l'API Google Wallet.
- Interface GitHub de Google Wallet
Accédez à l'organisation GitHub de Google Wallet pour obtenir des outils, des bibliothèques et des exemples de code utiles pour divers langages de programmation.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/29 (UTC).
[null,null,["Dernière mise à jour le 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)."]]
