Émettre des cartes pour le Web, les e-mails et les SMS
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Une fois que vous avez créé une carte et l'avez encodée dans un jeton JWT signé, vous pouvez l'émettre partout où "Ajouter à Google Wallet" lien est pris en charge. Pour ce faire, l'option "Ajouter à Google Wallet" sera proposée à l'utilisateur. ou un lien hypertexte pour enregistrer la carte dans Google Wallet lorsqu'il appuie dessus. Exemples d'utilisation de cette méthode : sites Web, e-mails, SMS, etc.
Prérequis
Avant d'essayer d'émettre une carte, effectuez les opérations suivantes:
Encodez votre classe et votre objet Cartes dans un jeton JWT.
Signez votre jeton JWT avec votre clé de compte de service Google Cloud.
1. Créer un compte "Ajouter à Google Wallet" lien [link]
Émettre une carte avec un compte "Google Wallet" permet d'ajouter l'objet Cartes au compte Google Wallet d'un utilisateur et ne peut être lancé que dans le contexte d'une identité Google connectée.
Ce lien peut être intégré dans des sites Web, dans des e-mails, dans des chats, dans des SMS ou dans tout autre emplacement prenant en charge les liens hypertextes.
Pour en savoir plus sur la création du jeton JWT signé nécessaire à la création d'un compte "Ajouter à Google Wallet", consultez la page Utiliser des jetons Web JSON.
2. (Recommandé) Utilisez l'option "Ajouter à Google Wallet". bouton
Pour toutes les surfaces compatibles avec les images sous forme de liens hypertextes, comme les sites Web et les e-mails, nous vous recommandons de présenter l'option "Ajouter à Google Wallet". vers vos utilisateurs via un bouton "Ajouter à Google Wallet" . Pour les utilisateurs de Google Wallet, ce bouton est une invite familière qui permet d'ajouter une carte à Google Wallet.
Les composants Image peuvent être téléchargés dans différentes orientations et langues pour prendre en charge l'intégration de l'API Google Wallet.
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\u003eIssue passes to users by providing an 'Add to Google Wallet' link, which can be embedded in various platforms like websites, emails, and SMS.\u003c/p\u003e\n"],["\u003cp\u003eThe 'Add to Google Wallet' link is a dynamically generated URL containing an encoded and signed JWT, directing users to save the pass to their Google Wallet.\u003c/p\u003e\n"],["\u003cp\u003eBefore issuing passes, complete the onboarding process, create a Passes Class and Object, and encode them in a signed JWT.\u003c/p\u003e\n"],["\u003cp\u003eIt's recommended to present the link using the 'Add to Google Wallet' button, providing a familiar and recognizable call to action for users.\u003c/p\u003e\n"],["\u003cp\u003eDemo passes will include "[TEST ONLY]" in the title until publishing access is granted, after which the text will be removed for users.\u003c/p\u003e\n"]]],["To issue a pass, present users with an 'Add to Google Wallet' link or button. This link, embedded in websites, emails, or SMS, contains a signed JWT and saves the pass to the user's Google Wallet. Before issuing, complete onboarding, create a Passes Class and Object, and encode/sign them in a JWT. Demo passes will show \"[TEST ONLY]\" text. The 'Add to Google Wallet' button is recommended where image hyperlinking is possible, with downloadable image assets provided.\n"],null,["# Issuing passes for web, email, SMS\n\nOnce you've created a pass and encoded it in a signed JWT, you are ready to issue it anywhere that the 'Add to Google Wallet' link is supported. To do this, you will present your user with an 'Add to Google Wallet' button or a hyperlink, which will save the pass to their Google Wallet once they tap it. Examples of where you might use this method include websites, email, SMS, and more.\n| **Demo Mode / \\[TEST ONLY\\] passes**\n|\n| When you are still in [Demo Mode](../resources/terminology#demo-mode), all the passes that you create will have an additional text \"\\[TEST ONLY\\]\" in the title. This is to differentiate demo passes from live passes. Once you are granted [publishing access](../test-and-go-live/request-publishing-access), these demo mode passes will no longer have the additional text when the user reopens the wallet app on a connected device.\n\nPrerequisites\n-------------\n\nBefore you try to issue a pass, be sure you do the following:\n\n- Complete all of the steps in the [Onboarding guide](../getting-started/onboarding-guide).\n- Create at least one [Passes Class](../use-cases/create#creating_a_passes_class).\n- Create at least one [Passes Object](../use-cases/create#creating_a_passes_object).\n- [Encode](../use-cases/jwt#encoding-a-pass-in-a-jwt) your Passes Class and Passes Object in a JWT.\n- [Sign](../use-cases/jwt#web,-email,-and-sms) your JWT with your Google Cloud service account key.\n\n1. Create an 'Add to Google Wallet' link\n----------------------------------------\n\nIssuing a pass with an 'Google Wallet' link adds the Passes Object to a user's Google Wallet, and can only be initiated in the context of a logged-in Google identity.\n\nThe 'Add to Google Wallet' link is a dynamically generated URL that contains an [encoded and signed JSON Web Token (JWT)](/wallet/tickets/boarding-passes/web/jwt).\n\nThe Add to Google Wallet link has the following format: \n\n```\nhttps://pay.google.com/gp/v/save/\u003csigned_jwt\u003e\n```\n\nFor example, a fully-formed 'Add to Google Wallet' link will look something like this: \n\n```\nhttps://pay.google.com/gp/v/save/eyJhbGci6IkpXVCJ9.eyJhdWQiO...6EkC1Ahp6A\n```\n\nThis link can be embedded into websites, email, chat, SMS, or anywhere else that supports hyperlinks.\n| The safe length of an encoded JWT is 1800 characters. If your JWT is less than this limit, the entire object can be included in the signed JWT. If the length is over 1800 characters, the save may not work due to truncation by web browsers. See this [FAQ](/wallet/tickets/boarding-passes/resources/faq#my-jwt-link-url-exceeds-the-1800-character-limit-browser-restriction.-what-should-i-do) for more info.\n\nFor more information on creating Passes Classes and Passes Objects, see [Create Passes Classes and Passes Objects](/wallet/tickets/boarding-passes/web/create).\n\nFor more information on how to create the signed JWT needed to create an 'Add to Google Wallet' link, see [Working with JSON Web Tokens](/wallet/tickets/boarding-passes/web/jwt).\n\n2. (Recommended) Use the 'Add to Google Wallet' button\n------------------------------------------------------\n\nFor any surfaces that support hyperlinking images, such as websites and email, it is recommended to present the 'Add to Google Wallet' link to your users with an 'Add to Google Wallet' button. For Google Wallet users, the button is a familiar prompt that is recognizable as a way to initiate adding a pass to their Google Wallet.\n- \n- \n\n[Image assets](/wallet/tickets/boarding-passes/resources/brand-guidelines) are available to download in a variety of orientations and languages to support your Google Wallet API integration.\n\n[Download the 'Add to Google Wallet' button](/wallet/tickets/boarding-passes/resources/brand-guidelines)"]]
