이벤트 티켓 사용
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
패스는 다음 두 가지 방법 중 하나로 사용할 수 있습니다.
사용자가 패스를 사용하거나 액세스할 때 선택적으로 추가 보안을 요구할 수 있습니다. 자세한 내용은 화면 잠금으로 보호를 참조하세요.
NFC 탭
사용자는 NFC 탭을 사용하여 간편하게 카드를 사용할 수 있습니다. 스마트 탭에 대해 자세히 알아보고 스마트 탭에 가입하세요.
바코드 스캔
바코드를 부착하여 고객이 패스를 스캔할 수 있도록 도와주세요.
정적 바코드
object.barcode를 설정하여 정적 바코드를 표시할 수 있습니다.
API는 다양한 바코드 유형을 제공합니다. 자세한 내용은 Barcode 유형을 참고하세요.
바코드 회전
보안을 강화하기 위해 object.rotatingBarcode를 설정하여 회전하는 바코드를 표시할 수 있습니다. 회전 바코드는 일반 바코드와 비슷해 보이지만 주기적으로(일반적으로 1분마다) 변경되며 터미널/리더는 최신 바코드만 허용하도록 프로그래밍됩니다. 이렇게 하면 바코드 스크린샷 촬영, 특히 티켓 도용이나 미승인 티켓 재판매와 관련된 위험을 줄일 수 있습니다. 자세한 내용은 RotatingBarcode 유형을 참고하세요.
보안 애니메이션
스크린샷 악용을 방지하는 또 다른 방법은 패스에 관한 사람의 인증을 지원하는 바코드 보안 애니메이션을 표시하는 것입니다.
보안 애니메이션의 물리적인 모습은 패스 바코드 주위에 빛나는 윤곽선입니다. 이 빛나는 애니메이션은 기기가 움직이는 경우에만 트리거되므로 기기를 기울여 패스의 유효성을 테스트할 수 있습니다. 반면 기기를 계속 들고 있으면 다채로운 보안 애니메이션만 연속으로 애니메이션 처리됩니다.
패스의 보안 애니메이션을 사용 설정하려면 패스 클래스에서 SecurityAnimation 필드의 AnimationType를 FOIL_SHIMMER로 설정합니다.
보안 애니메이션이 활성화되었을 때 표시되는 방법의 예는 아래 그림 1을 참조하세요.
그림 1.
화면 잠금으로 보호
고객의 패스 액세스를 보호하기 위해 고객이 패스를 추가하거나 액세스할 때마다 화면 잠금을 요구할 수 있습니다. 이렇게 하려면 class.viewUnlockRequirement를 설정하면 됩니다.
자세한 내용은 ViewUnlockRequirement 유형을 참고하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-29(UTC)
[null,null,["최종 업데이트: 2025-08-29(UTC)"],[[["\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)."]]
