تحصيل قيمة تذكرة حدث
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يمكن تحصيل قيمة البطاقات بطريقتَين:
يمكنك اختياريًا فرض مستوى أمان إضافي عندما يحصّل المستخدمون قيمة البطاقة أو يستخدمونها. لمعرفة التفاصيل، يُرجى الاطّلاع على الحماية باستخدام قفل الشاشة.
النقر على NFC
يمكن للمستخدمين تحصيل قيمة بطاقاتهم بسلاسة عبر نقرة على NFC. يمكنك الاطّلاع على مزيد من المعلومات حول
الدفع الذكي
والاشتراك في ميزة "الدفع الذكي".
مسح الرمز الشريطي ضوئيًا
ساعِد عملائك في مسح "بطاقتهم" ضوئيًا من خلال إرفاق رمز شريطي.
رمز شريطي ثابت
يمكنك عرض رمز شريطي ثابت من خلال ضبط object.barcode.
توفر واجهة برمجة التطبيقات مجموعة متنوعة من أنواع الرموز الشريطية. لمزيد من التفاصيل، راجِع
النوع Barcode.
رمز شريطي دوّار
لمزيد من الأمان، يمكنك عرض رمز شريطي دوّار من خلال ضبط السمة object.rotatingBarcode. إنّ الرموز الشريطية الدوّارة تشبه الرموز الشريطية العادية، ولكنّها تتغير من وقت لآخر في العادة كل دقيقة، وتتم برمجة جهاز الدفع أو القارئ لقبول العرض الأحدث فقط. يحدّ هذا من المخاطر المرتبطة بأخذ لقطة الشاشة للرمز الشريطي، لا سيّما سرقة التذاكر أو إعادة بيع التذاكر غير المصرّح بها. لمزيد من التفاصيل، راجِع
النوع RotatingBarcode.
صورة متحرّكة للأمان
هناك طريقة أخرى لمنع إساءة استخدام لقطات الشاشة، وهي عرض صورة متحركة أمنية للرمز الشريطي، والتي
تدعم عملية التحقق البشرية من البطاقة.
المظهر المادي للصور المتحركة الأمنية هو مخطط لامع حول الرمز الشريطي للبطاقة. لا يتم تشغيل هذه الصورة المتحركة المتلألئة إلا عندما يكون الجهاز متحرّكًا، ما يتيح للمستخدم اختبار
صلاحية البطاقة من خلال إمالة الجهاز. أمّا من ناحية أخرى، فإنّ حمل الجهاز ثابتًا سيؤدي إلى إضافة صور متحركة مفعمة بالألوان ومفعمة بالحيوية فقط.
لتفعيل صورة متحركة أمنية للبطاقة، اضبط السمة AnimationType
للحقل SecurityAnimation على FOIL_SHIMMER في فئة البطاقة.
انظر الشكل 1. أدناه لمشاهدة مثال حول كيفية ظهور الحركة الأمنية عند تفعيلها:
الشكل 1.
الحماية باستخدام قفل الشاشة
لحماية إمكانية وصول عميلك إلى "البطاقة"، يمكنك فرض قفل الشاشة في كل مرة يضيف فيها العميل بطاقتك أو يطّلع عليها. ويمكن إجراء ذلك من خلال ضبط class.viewUnlockRequirement.
لمزيد من التفاصيل، راجِع
النوع ViewUnlockRequirement.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003ePasses can be redeemed via NFC tap or barcode scan, offering users flexible options.\u003c/p\u003e\n"],["\u003cp\u003eRotating barcodes and security animations enhance security by mitigating risks like ticket theft and unauthorized resale.\u003c/p\u003e\n"],["\u003cp\u003ePasses can include a screen lock requirement for added security, protecting customer access.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers have access to various barcode types and customization options through the API, enabling them to tailor the pass experience.\u003c/p\u003e\n"],["\u003cp\u003eGoogle Pay's Smart Tap technology facilitates seamless redemption through NFC.\u003c/p\u003e\n"]]],["Passes can be redeemed via NFC tap or barcode scan. For barcodes, options include static or rotating types, with rotating barcodes enhancing security by changing regularly. An optional security animation, a shimmering effect triggered by device motion, further validates pass authenticity. Extra security can be added by requiring a screen lock each time a user accesses or adds a pass, configured via `class.viewUnlockRequirement`. The barcode can be added by setting `object.barcode`.\n"],null,["# Redeem an Event ticket\n\nPasses can be redeemed in either of two ways:\n\n- [NFC tap](#use-nfc-tap)\n- [Barcode scan](#use-barcode-scan)\n\nYou can optionally require extra security when users redeem or access their pass. For details,\nsee [Protect with Screen Lock](#protect-with-screen-lock).\n\nNFC tap\n-------\n\nYour users can seamlessly redeem their cards using an NFC tap. Learn more about\n[Smart Tap](/wallet/smart-tap), and\n[sign up](https://support.google.com/pay/merchants/contact/smart_tap_support) for Smart\nTap.\n\nBarcode scan\n------------\n\nHelp your customers scan their Pass by attaching a barcode.\n\n### Static barcode\n\nYou can display a static barcode by setting `object.barcode`.\nThe API provides a variety of barcode types. For more details, see the\n[`Barcode` type](/wallet/tickets/events/rest/v1/Barcode).\n\n### Rotating barcode\n\n\nFor additional security, you can display a rotating barcode by setting\n`object.rotatingBarcode`. Rotating barcodes look just like regular barcodes but\nchange periodically, typically every minute, and the terminal/reader is programmed to only\naccept the most recent one. This reduces the risks associated with barcode screenshotting, in\nparticular ticket theft or unauthorized ticket resale. For more details, see the\n[`RotatingBarcode` type](/wallet/tickets/events/rest/v1/RotatingBarcode).\n\n### Security animation\n\n\nAnother way to prevent screenshot abuse is by displaying the barcode security animation, which\nsupports human-verification of a pass.\n\n\nThe physical manifestation of a security animation is a shimmering outline around the barcode of\nthe pass. This shimmering animation triggers only when the device is in motion so one can test\nthe pass' validity by tilting the device. On the other hand holding the device still will only\nanimate the colorful security animation in loop.\n\n\nTo enable security animation for a pass, in the pass class, set the [`SecurityAnimation`](/wallet/tickets/events/rest/v1/SecurityAnimation)\nfield's [`AnimationType`](/wallet/tickets/events/rest/v1/SecurityAnimation#AnimationType)\nto `FOIL_SHIMMER`.\n\n\nSee Figure 1. below for an example of how the security animation appears when it is enabled:\n\n\n**Figure 1.**\n\nProtect with Screen Lock\n------------------------\n\nTo protect your customer's access to their Pass, you can require a screen\nlock each time they add or access their pass. This can be done by setting `class.viewUnlockRequirement`.\nFor more details, see the\n[`ViewUnlockRequirement` type](/wallet/tickets/events/rest/v1/ViewUnlockRequirement)."]]
