# Apple Wallet 패스 시작하기

Apple Wallet 패스는 사용자가 iPhone 및 Apple Watch의 Wallet 앱에 보관하는 로열티 카드, 쿠폰, 이벤트 티켓, 탑승권, 스토어 카드와 같은 디지털 카드입니다. Pushwoosh를 사용하면 Control Panel에서 시각적으로 패스를 디자인하고, 공유한 다음, 사용자에게 아무것도 다시 설치하도록 요청하지 않고 언제든지 업데이트를 푸시할 수 있습니다.

패스를 변경하면 Pushwoosh는 해당 패스를 추가한 모든 기기에 알림을 보내고, iOS는 조용히 새 버전을 가져옵니다. 사용자의 휴대폰에 있는 바코드, 잔액, 게이트 번호 또는 만료일이 자동으로 업데이트됩니다.

## Apple Wallet 패스로 할 수 있는 작업

Pushwoosh의 Apple Wallet 패스를 사용하면 다음을 수행할 수 있습니다:

* `pass.json`을 직접 작성하지 않고도 색상, 필드, 로고, 스트립 이미지, 바코드를 사용하여 시각적으로 패스를 디자인할 수 있습니다.
* 로열티 카드, 쿠폰, 이벤트 티켓, 탑승권, 일반 스토어 카드를 만들 수 있습니다.
* `.pkpass` 파일, 설치 링크 또는 QR 코드로 사용자에게 패스를 배포할 수 있습니다.
* 패스 콘텐츠를 업데이트하고 패스를 추가한 기기에 변경 사항을 전달할 수 있습니다.
* 일회성 푸시, 패스 업데이트 또는 Customer Journey를 통해 패스 소지자에게 도달할 수 있습니다. [Apple Wallet 패스 소지자에게 메시지 보내기](/ko/product/messaging-channels/apple-wallet-passes/message-pass-holders/)를 참조하세요.

## 전제 조건

<Aside type="caution" icon="setting" title="개발자 지원 필요">
Apple Wallet 패스를 발급하려면 Apple Developer 계정과 서명 인증서가 필요합니다. 일회성 설정을 완료하려면 이 섹션을 개발팀과 공유하세요.
</Aside>

첫 번째 패스를 디자인하기 전에 다음을 확인하세요:

* **Apple Developer Program:** Pass Type ID를 등록하고 서명 인증서를 만들려면 활성 멤버십이 필요합니다. [계정 등록 또는 관리](https://developer.apple.com/programs/)
* **iOS 플랫폼:** 패스 서명 인증서를 추가하려면 애플리케이션에 iOS가 Pushwoosh에 연결되어 있어야 합니다. [iOS 설정](/ko/developer/first-steps/connect-messaging-services/ios-configuration/)

## Apple Wallet 패스 작업 시작하기

[전제 조건](#prerequisites)이 충족된 후 다음 흐름을 따르세요:

<Steps>

1. **Pushwoosh에서 Wallet 패스 구성**

   패스를 디자인하기 전에 Pushwoosh에 애플리케이션에 대한 Apple 서명 인증서가 있어야 합니다. 개발팀이 Apple Developer에서 이를 생성하고 Pushwoosh에 업로드합니다. 이는 애플리케이션당 일회성 설정입니다.

   [서명 인증서 설정 방법](/ko/developer/first-steps/connect-messaging-services/ios-configuration/ios-wallet-pass-configuration/)

2. **패스 디자인**

   [패스 빌더](/ko/product/messaging-channels/apple-wallet-passes/pass-builder/)에서 패스 스타일을 선택하고 필드와 브랜딩을 설정한 후 실시간 미리보기를 확인하세요.

3. **서명된 `.pkpass` 생성**

   패스를 생성하고 유효성을 검사한 후 [패스 빌더](/ko/product/messaging-channels/apple-wallet-passes/pass-builder/#generate-the-pass)에서 **생성**을 선택합니다. Pushwoosh는 필요한 해상도로 이미지를 준비하고 인증서로 파일에 서명합니다.

4. **패스 배포**

   사용자에게 `.pkpass` 파일, 설치 링크 또는 QR 코드를 보냅니다. [Pushwoosh 채널을 통해 사용자와 패스 공유](#share-the-pass-with-users-via-pushwoosh-channels)를 참조하세요. 사용자가 Wallet에 패스를 추가하면 해당 기기는 향후 업데이트를 위해 등록됩니다.

5. **패스 콘텐츠 업데이트**

   패스 빌더 또는 API를 통해 패스를 편집하고 저장합니다. Pushwoosh는 등록된 기기에 알림을 보내고 iOS는 백그라운드에서 새 버전을 다운로드합니다. 사용자는 패스를 다시 설치할 필요가 없습니다.

6. **패스 소지자에게 메시지 보내기**

   사용자가 Wallet에 패스를 추가하면 일회성 푸시, 패스 업데이트 또는 자동화된 Customer Journey를 통해 사용자에게 도달할 수 있습니다.

   [Apple Wallet 패스 소지자에게 메시지 보내기](/ko/product/messaging-channels/apple-wallet-passes/message-pass-holders/)

</Steps>

## 기존 패스 보기 및 관리

Control Panel에서 **Campaigns → Wallet Passes**로 이동하여 **Apple Wallet** 탭을 엽니다. **All passes** 테이블에는 애플리케이션의 모든 패스가 이름, 스타일, 연관된 [User ID](/ko/product/pushwoosh-knowledge-hub/users-userids/), 마지막 업데이트 날짜 및 시간과 함께 나열됩니다.

패스 목록에서 작업 메뉴(⋮)를 열어 다음을 수행할 수 있습니다:

* **편집:** 패스 이름 및 설명, 필드 값 및 레이블, 메시지, 색상, 바코드 메시지, 만료 및 상태, 위치를 변경합니다. 패스 스타일과 이미지는 생성 후 잠깁니다. 저장하면 패스를 추가한 모든 기기가 업데이트를 받습니다.

<Aside type="note" title="업데이트는 자동 푸시로 전달됩니다">
변경 사항을 저장하면 Pushwoosh는 패스를 다시 서명하고 등록된 모든 기기에 콘텐츠 없는 푸시로 알림을 보냅니다. iOS는 재설치 없이 자체적으로 새 버전을 가져옵니다.
</Aside>

* **다운로드:** 서명된 `.pkpass` 파일을 다운로드합니다.
* **QR 코드:** 사용자가 스캔하여 Wallet에 패스를 추가하고 업데이트를 위해 기기를 등록할 수 있는 설치 QR 코드를 표시합니다. 이 창에서 QR 아래의 **설치 링크 복사**를 사용할 수도 있습니다.
* **설치 링크 복사:** 메시징 채널에서 패스를 공유하기 위해 설치 URL을 복사합니다. [자세히 알아보기](#share-the-pass-with-users-via-pushwoosh-channels).
* **메시지 보내기:** 패스 소지자에게 메시지를 보내기 위해 일회성 푸시 작성기를 엽니다. 목록에서 열면 [User ID](/ko/product/pushwoosh-knowledge-hub/users-userids/)로 패스 소유자를 타겟팅합니다. 사용자에게 도달하는 모든 방법에 대해서는 [Apple Wallet 패스 소지자에게 메시지 보내기](/ko/product/messaging-channels/apple-wallet-passes/message-pass-holders/)를 참조하세요.
* **삭제:** 패스를 제거합니다. 기기에 이미 설치된 사본은 업데이트 수신을 중지하고 다음 새로고침 시 유효하지 않게 됩니다.

## Pushwoosh 채널을 통해 사용자와 패스 공유

빌더에서 복사하는 설치 링크(**설치 링크 복사**)는 일반 URL입니다. iPhone에서 열면 Apple Wallet에 패스가 추가됩니다. 이미 잠재고객에게 도달하는 데 사용하는 동일한 Pushwoosh 채널에서 이 링크를 사용할 수 있습니다:

* **이메일:** [이메일 편집기](/ko/product/content/email-content/drag-and-drop-email-editor/)에서 버튼이나 텍스트 링크에 링크를 추가합니다(예: "Apple Wallet에 추가" 클릭 유도 문안).
* **푸시 알림:** 알림의 [열기 액션](/ko/product/messaging-channels/push-notifications/send-push-notifications/one-time-push/#define-what-happens-when-the-push-is-clicked)으로 링크를 설정하여 탭하면 패스가 열리도록 합니다.
* **SMS:** [SMS 콘텐츠](/ko/product/messaging-channels/sms/send-sms/send-sms-via-customer-journey/#configure-sms-content)에 링크를 포함합니다.

<Aside type="note" title="패스당 하나의 링크">
각 설치 링크는 단일 패스에 연결되어 있으므로(해당 패스의 일련 번호와 토큰을 전달함) 하나의 링크는 공유된 하나의 패스에 대해 작동하며, 이는 공통 쿠폰이나 이벤트 티켓에 유용합니다. 모든 수신자에게 자신의 패스를 제공하려면 [PassKit API](/ko/developer/api-reference/apple-wallet-passkit-api/)를 사용하여 사용자별로 패스를 생성하고 각 사용자에게 자신의 링크를 보냅니다. Wallet 패스는 Apple 기기(iPhone 및 Apple Watch)에만 설치됩니다.
</Aside>

## API를 통한 패스 관리

패스 빌더가 수행하는 모든 작업은 PassKit Designer API를 통해 프로그래밍 방식으로도 사용할 수 있습니다: 패스 생성, 업데이트, 목록 조회, 다운로드 및 삭제.

<LinkCard title="Apple Wallet PassKit API" href="/developer/api-reference/apple-wallet-passkit-api/" />

## User Explorer에서 패스 소지자 보기

사용자가 Wallet에 패스를 추가하면 Pushwoosh는 [User Explorer](/ko/product/audience-data-and-segmentation/user-explorer/)의 **Devices and platforms** 탭에 이를 나열합니다.

1. **Audience → User Explorer**로 이동하여 사용자 프로필을 엽니다.
2. **Devices and platforms** 탭을 엽니다.
3. 사이드바에서 **Apple Wallet**을 선택합니다.

플랫폼 프로필에서 다음을 검토할 수 있습니다:

* **구독 상태:** 예: **SUBSCRIBED**
* **플랫폼 식별자:** 플랫폼 이름 아래에 표시되는 패스 식별자
* **메타데이터:** **First subscription**, **Timezone** 및 사용 가능한 경우 기타 필드
* **태그:** 패스 발급 시 설정한 태그를 포함한 플랫폼 태그

[자세히 알아보기](/ko/product/audience-data-and-segmentation/user-explorer/#devices-and-platforms-tab)