نظرة عامة
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
قد تحتوي بعض البطاقات التي يمكنك إنشاؤها باستخدام "محفظة Google" على بيانات حساسة للمستخدم. تتضمّن هذه البطاقات حماية إضافية للمساعدة في الحفاظ على أمان بيانات المستخدمين، وتتم إدارتها بشكل مختلف في Wallet API. يجب استخدام مجال البطاقة الخاصة العام في الحالات التي تتضمّن فيها بطاقتك بيانات حسّاسة (على النحو المحدّد في سياسة الاستخدام المقبول في Wallet API).
يتيح مجال البطاقة الخاصة العام حالات استخدام مثل:
- بطاقات التأمين الصحي
- بطاقات الهوية الوطنية
- مستندات تعريف أخرى صادرة عن جهة حكومية
تتطلب بعض البلدان ونطاقات السلطة إدارة البيانات الحساسة بطريقة معيّنة. وبناءً على ذلك، قد تختلف قائمة حالات الاستخدام الموضَّحة هنا حسب بلدك أو لوائح تنظيمية أخرى. إذا كانت بيانات المستخدمين تخضع للوائح قانونية في بلد المنشأ (على سبيل المثال، قانون نقل التأمين الصحي والمسؤولية في الولايات المتحدة)، يجب أن تستخدم البيانات المجال العام للبطاقات الخاصة وقد تخضع لمراجعة إضافية.
ما الفارق؟
تستخدم البطاقات الخاصة العامة طريقة مستقلة لتحديد البطاقة وتوزيعها. وبصفتك المطوّر، يمكنك تحديد تنسيق البطاقة ومحتواها في رمز JSON المميّز للويب، ثم يتم توزيعه على المستخدم مباشرةً ليتمكّن من حفظها في "محفظة Google".
قد تخضع البطاقات التي تعالج البيانات الحسّاسة (المعروفة باسم البطاقات الخاصة العامة) لعناصر تحكّم إضافية في الخصوصية خلال عملية الإعداد. لا نسمح باستخدام واجهات برمجة التطبيقات لمعالجة البيانات الحساسة في "محفظة Google" بدون الحصول على إذن صريح من Google على النحو المحدّد في سياسة الاستخدام المقبول في Wallet API.
طلب الدخول
إذا كانت بطاقتك تتضمّن بيانات حسّاسة، يُرجى التواصل مع فريق الدعم في Google Pay و"وحدة التحكّم في المحفظة" وطلب الوصول إلى البطاقة. إذا لم تكن متأكّدًا مما إذا كانت بطاقتك تتضمّن بيانات حسّاسة، يُرجى التواصل مع فريق الدعم.
سيُطلب منك تقديم ما يلي:
- مستند الأهلية لإثبات هويتك والتأكّد من أنّك كيان صالح
- عنوان URL لشعارك
- عنوان URL لموقعك الإلكتروني
بدء
بعد حصولك على الموافقة لإصدار بطاقة خاصة عامة، ابدأ عملية التنفيذ لإضافة بطاقات إلى "محفظة Google".
البدء
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 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)"]]