概览
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
您可以使用 Google 钱包创建的一些卡券可能包含敏感用户数据。这些卡券提供额外的保护,可帮助确保用户数据安全,并且其在 Wallet API 中的管理方式有所不同。如果您的卡券包含敏感数据(如 Wallet API 使用限制政策中所定义),则应使用通用私人凭证类别。
通用私人凭证类别支持以下用例:
某些国家/地区和管辖区要求以特定方式管理敏感数据。因此,此处突出显示的用例列表可能会因您所在的国家/地区或其他法规而异。如果您的用户数据受您所在国家/地区的法律法规(例如美国的《健康保险流通与责任法案》)约束,则数据必须使用通用的私人凭证类别,并且可能需要接受进一步审核。
有何不同之处?
通用私人凭证使用独立的方法来定义和分发凭证。作为开发者,您可以在单个 JSON Web 令牌中定义卡券布局和内容,然后将其直接分发给用户,以便用户将其保存到自己的 Google 钱包中。
在初始配置过程中,会处理敏感数据的卡券(称为“通用私人凭证”)可能还需要受到额外的隐私控制。如 Wallet API 使用限制政策 中所定义,未经 Google 明确许可,我们不允许使用 API 来处理 Google 钱包中的敏感数据。
请求访问权限
如果您的卡券包含敏感数据,请在 Google Pay 和钱包控制台中与支持团队联系,并请求访问权限。如果您不确定您的卡券是否包含敏感数据,请与支持团队联系。
您需要提供以下信息:
- 资格文件:验证您的身份并证明您是有效实体
- 指向您的徽标的网址
- 您网站的网址
开始使用
在获准发放通用私人凭证后,可以开始实现将卡券添加到 Google 钱包。
开始使用
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-08-29。
[null,null,["最后更新时间 (UTC):2025-08-29。"],[[["\u003cp\u003eGoogle Wallet has extra protection for passes containing sensitive user data, like health insurance or national ID cards, using the generic private pass vertical.\u003c/p\u003e\n"],["\u003cp\u003eThese passes are managed differently, requiring developers to define the layout and contents in a JSON Web Token distributed directly to the user.\u003c/p\u003e\n"],["\u003cp\u003eUsing the Google Wallet APIs for sensitive data requires explicit permission from Google and may involve additional privacy controls during onboarding.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers must request access through Google Pay and Wallet Console support and provide verification documents to be eligible to issue generic private passes.\u003c/p\u003e\n"],["\u003cp\u003eAfter approval, developers can begin implementation by referring to the provided 'Get started' resources.\u003c/p\u003e\n"]]],["Generic private passes, designed for sensitive user data like health insurance or national IDs, require a specific approach within Google Wallet. Developers define the pass layout and content in a JSON Web Token distributed directly to the user. Access to create these passes is restricted and requires explicit permission from Google. To request access, submit an eligibility document, logo URL, and website URL via the Google Pay and Wallet Console. Once approved, developers can implement the pass using the provided guidelines. Passes that use private information may be subject to additional privacy controls.\n"],null,["# Overview\n\nSome passes that you can create with Google Wallet may contain sensitive user data. These passes have extra protection to help keep your users data safe and are managed differently in the Wallet API. The generic private pass vertical should be used in cases where sensitive data (as defined in the Wallet API [Acceptable Use Policy](https://payments.developers.google.com/terms/aup)) is included in your Pass.\n\nThe generic private pass vertical supports use cases such as:\n\n- Health Insurance Cards\n- National Identification Cards\n- Other Government IDs\n\nSome countries and jurisdictions require that sensitive data is managed in a particular way. As such, the list of use cases highlighted here may vary depending on your country or other regulations. If your user data is subject to legal regulation in your country of origin (e.g. the Health Insurance Portability and Accountability Act in the United States), it will have to use the generic private pass vertical and may be subject to additional review.\n\n### What is different?\n\nGeneric private passes use a self-contained method for defining and distributing the pass. As the developer, you define the pass layout and contents in a single JSON Web Token that is then distributed directly to the user for them to save it into their Wallet.\n\nPasses which process sensitive data (known as generic private pass) may be subject to additional privacy controls during onboarding. We do not allow the APIs to be used for processing sensitive data in Google Wallet without explicit permission from Google, as described in the as defined in the Wallet API [Acceptable Use Policy.](https://payments.developers.google.com/terms/aup)\n\nRequest access\n--------------\n\nIf your pass contains sensitive data, [contact support](https://support.google.com/google-pay-and-wallet-console/answer/10913634) in the [Google Pay and Wallet Console](https://pay.google.com/business/console/) and request for access. If you are unsure if your pass contains sensitive data, please contact support.\n\nYou will be required to provide the following:\n\n- Eligibility Document verifying your identity and attesting you are a valid entity\n- A URL to your logo\n- A URL to your website\n\nGet started\n-----------\n\nAfter you have received approval to issue generic private pass, get started with your implementation to add passes to Google Wallet.\n\n[Get started](/wallet/generic-private-pass/guides)"]]