# 패스 빌더에서 패스 디자인하기
Apple Wallet **패스 빌더**는 Control Panel에 있는 시각적 디자이너입니다. 패스 스타일을 선택하고, 브랜딩, 필드, 바코드를 채우고, 실시간 미리보기를 확인한 후, 서명된 `.pkpass`를 생성할 수 있습니다. `pass.json`을 직접 작성할 필요가 없습니다.
## 패스 생성하기
Control Panel에서 **Campaigns → Apple Wallet**으로 이동하여 **패스 생성(Create pass)**을 클릭합니다.
## 패스 구성하기
* **처음부터 만들기:** 빈 패스로 시작합니다. 패스 스타일을 선택한 다음, 아래 섹션에서 색상, 이미지, 필드, 바코드 및 기타 옵션을 직접 설정합니다.
* **템플릿에서 만들기:** **템플릿 로드(Load template)**를 클릭하고, **템플릿 선택(Select Template)**에서 내장된 패스(탑승권, 쿠폰, 이벤트 티켓, 일반 또는 스토어 카드)를 선택한 후 확인합니다. 양식에 패스 스타일, 색상, 이미지, 패스 필드, 바코드 및 기본 정보가 미리 채워집니다. 필요에 따라 값을 편집하거나 스타일을 변경할 수 있습니다. Pushwoosh는 템플릿의 팀 및 패스 유형 ID를 애플리케이션의 값으로 대체합니다.
### 패스 스타일 선택하기
**패스 스타일(PASS STYLE)**에서 5가지 Apple Wallet 패스 스타일 중 하나를 선택합니다. 스타일은 레이아웃과 사용 가능한 필드 영역 및 이미지를 제어합니다.
* **탑승권(Boarding Pass)**
* **쿠폰(Coupon)**
* **이벤트 티켓(Event Ticket)**
* **스토어 카드(Store Card)**
* **일반(Generic)**
처음부터 시작하는 경우, 필드와 이미지를 추가하기 전에 스타일을 선택하세요.
스타일을 전환하면 스타일에 특화된 필드가 초기화됩니다.
### 패스 이름 및 설명 추가하기
**기본 정보(BASIC INFORMATION)**에서 다음을 입력합니다.
| | |
| :---- | :---- |
| **패스 이름(Pass Name)** | 패스 제목이며, 업데이트 알림에 표시되는 소스 이름입니다. |
| **설명(Description)** | 패스에 대한 간략한 설명입니다. |
| **로고 텍스트(Logo Text)** | 로고 옆에 표시되는 텍스트입니다(로고 이미지가 업로드되지 않았을 때 사용됨). |
### 색상 및 이미지 설정하기
#### 색상
**색상(COLORS)**에서 다음을 설정합니다.
* **배경색(Background Color):** 패스 배경입니다.
* **전경색(Foreground Color):** 패스의 주요 텍스트 및 아이콘입니다.
* **레이블 색상(Label Color):** 필드 레이블의 색상입니다(예: `FROM`, `GATE`).
색상을 설정하거나 변경하려면 해당 필드를 클릭하고 색상 선택기에서 색상을 선택합니다.
#### 이미지
**이미지(IMAGES)**에서 **아이콘(Icon)**과 **로고(Logo)**를 업로드합니다(둘 다 필수). 선택적 이미지는 패스 스타일에 따라 다릅니다.
각 이미지 슬롯 옆의 **파일 선택(Choose file)**을 클릭합니다. PNG 또는 JPEG 파일을 업로드합니다. Pushwoosh는 패스를 생성할 때 각 이미지를 Apple이 요구하는 해상도(@1x, @2x, @3x)로 처리합니다.
### 패스 필드 채우기
**패스 필드(PASS FIELDS)**에서 패스에 표시되는 텍스트와 값을 추가합니다. 표시되는 그룹은 패스 스타일에 따라 다릅니다.
* **헤더 필드(패스 상단):** 탑승권, 이벤트 티켓
* **기본 필드(주요 콘텐츠):** 모든 스타일
* **보조 필드(지원 정보):** 모든 스타일
* **추가 필드(추가 세부 정보):** 모든 스타일
* **뒷면 필드(패스 뒷면):** 모든 스타일
필요한 각 그룹에서 **+ 필드 추가(+ Add Field)**를 클릭합니다.
각 필드에 대해 다음을 설정합니다.
| | |
| :---- | :---- |
| 키(ID) | 고유한 필드 식별자입니다(자동으로 생성됨). |
| 레이블 | 패스에 표시되는 짧은 레이블입니다(예: `FROM`). |
| 값 | 패스에 표시되는 값입니다(예: `SFO`). |
| 변경 메시지 | 이 값이 변경될 때 업데이트 알림에 표시되는 텍스트입니다. 값이 변경될 때만 표시됩니다. 새 값에는 `%@`를 사용합니다(예: `게이트가 %@(으)로 변경되었습니다`). |
필드 카드에서 **서식(Format)**을 클릭하여 서식 옵션을 표시합니다. 필드를 제거하려면 **X**를 클릭합니다.
#### 서식 옵션
* **값 형식:** 텍스트, 날짜 및 시간 또는 숫자/통화.
* **텍스트 정렬:** 기본값(자연스러움), 왼쪽, 가운데 또는 오른쪽.
* **데이터 탐지기** *(뒷면 필드만 해당):* 뒷면 필드의 전화번호, 링크, 주소, 캘린더 이벤트를 탭할 수 있는 콘텐츠로 전환합니다.
### 바코드 추가하기
**바코드(BARCODE)**에서 형식을 선택하고 인코딩할 데이터를 입력합니다.
1. **바코드 형식:** 바코드 모양과 어떤 유형의 스캐너가 읽을 수 있는지 선택합니다.
* **QR 코드(권장):** 대부분의 휴대폰과 스캐너가 쉽게 읽을 수 있는 정사각형 코드입니다. 쿠폰, 멤버십 카드 및 대부분의 패스에 가장 적합합니다.
* **PDF417:** 여러 줄의 선으로 구성된 넓은 바코드입니다. 항공사 또는 대중교통 탑승권에 종종 필요합니다.
* **Aztec:** QR과 유사한 소형 정사각형 코드입니다. 이벤트 및 대중교통 티켓에 일반적입니다.
* **Code 128:** 고전적인 수직선 바코드입니다. 스캐너나 POS 시스템에서 1D 바코드를 요구하는 경우에만 선택하세요.
2. **바코드 메시지:** 바코드에 인코딩된 값입니다(예: 티켓 또는 멤버십 번호).
3. **대체 텍스트(선택 사항):** 패스의 바코드 아래에 표시되는 텍스트입니다.
### 만료 및 상태 설정하기
**만료 및 상태(EXPIRATION & STATUS)**에서 패스가 표시되는 시점, 만료 시점, 유효 여부를 제어합니다.
* **관련 날짜(패스 표시 시점):** 패스가 잠금 화면에 나타날 수 있는 날짜 및 시간입니다.
* **만료 날짜(패스 만료 시점):** 이 날짜 및 시간 이후에는 Wallet에서 패스가 회색으로 표시됩니다.
* **무효로 표시(이 패스 무효화):** 패스를 더 이상 사용할 수 없도록 무효화하는 체크박스입니다.
### 스타일에 특화된 고급 옵션
* **교통 수단 유형** *(탑승권만 해당):* 항공, 기차, 버스, 보트 또는 일반.
* **그룹화 식별자:** 관련된 패스를 Wallet에서 함께 그룹화합니다.
### 위치 기반 관련성 *(선택 사항)*
**위치 기반 관련성(LOCATION-BASED RELEVANCE)**에서 사용자가 추가한 위치 근처에 있을 때 패스가 나타납니다. 각 위치에 대해 사용자가 근처에 있을 때 잠금 화면에 표시될 텍스트를 설정합니다. 최대 10개의 위치를 추가할 수 있습니다.
지도를 클릭하거나, 주소를 검색하거나, 좌표를 붙여넣거나, 지오존을 가져와 지점을 추가합니다. 마커를 드래그하여 위치를 미세 조정합니다.
**최대 거리**(미터 단위)는 패스가 관련성을 유지하기 위해 사용자가 얼마나 가까이 있어야 하는지를 제어합니다.
**사용 사례 예시**
* **소매:** 고객이 매장 근처에 있을 때 멤버십 카드나 쿠폰이 나타납니다. 잠금 화면 텍스트는 매장 근처에 있다는 것을 알리고 패스 사용을 상기시킬 수 있습니다.
* **이벤트:** 사용자가 행사장(경기장, 극장 또는 축제장) 근처에 있을 때 이벤트 티켓이 나타나 문 앞에서 패스를 빠르게 찾을 수 있습니다.
* **여행:** 출발 공항이나 터미널 근처에서 탑승권이 눈에 띄게 되어 승객이 Wallet을 열기 전에 잠금 화면에서 게이트나 항공편 세부 정보를 볼 수 있습니다.
* **호텔/식당:** 정의한 카페나 호텔 위치 근처에서 쿠폰이나 멤버십 패스가 나타날 수 있습니다.
### User ID 입력하기
이 패스를 받을 사람의 Pushwoosh [User ID](/ko/product/pushwoosh-knowledge-hub/users-userids/#how-are-users-and-devices-related)를 입력합니다. Pushwoosh는 해당 사용자에게 패스를 발급하고 **모든 패스(All passes)**의 **사용자(USER)** 아래에 목록으로 표시합니다.
### 미리보기 및 유효성 검사
**실시간 미리보기**는 편집하는 동안 업데이트되므로 Wallet에서 패스가 어떻게 보일지 대략적으로 확인할 수 있습니다.
패스를 생성하지 않고 Apple의 사양과 비교하여 확인하려면 **패스 유효성 검사(Validate pass)**를 클릭합니다. 빌더는 누락된 필수 이미지 및 기타 문제를 표시합니다.
## 패스 생성하기
**생성(Generate)**을 선택합니다. Pushwoosh는 패스의 유효성을 검사하고, 이미지를 처리하며, 패키지에 서명합니다. 생성에는 몇 초가 걸리며, 그 후 패스가 패스 목록에 나타납니다.
생성 후 패스 편집(일련 번호로 업데이트 포함), 다운로드, 공유 및 삭제에 대해서는 [기존 패스 관리하기](/ko/product/messaging-channels/apple-wallet-passes/#view-and-manage-existing-passes)를 참조하세요.
## API를 통해 패스 관리하기
패스 빌더가 수행하는 모든 작업은 [PassKit Designer API](/ko/developer/api-reference/apple-wallet-passkit-api/)를 통해서도 가능합니다: 패스 생성, 업데이트, 목록 조회, 다운로드 및 삭제.
## 패스 구성하기
* **처음부터 만들기:** 빈 패스로 시작합니다. 패스 스타일을 선택한 다음, 아래 섹션에서 색상, 이미지, 필드, 바코드 및 기타 옵션을 직접 설정합니다.
* **템플릿에서 만들기:** **템플릿 로드(Load template)**를 클릭하고, **템플릿 선택(Select Template)**에서 내장된 패스(탑승권, 쿠폰, 이벤트 티켓, 일반 또는 스토어 카드)를 선택한 후 확인합니다. 양식에 패스 스타일, 색상, 이미지, 패스 필드, 바코드 및 기본 정보가 미리 채워집니다. 필요에 따라 값을 편집하거나 스타일을 변경할 수 있습니다. Pushwoosh는 템플릿의 팀 및 패스 유형 ID를 애플리케이션의 값으로 대체합니다.
### 패스 스타일 선택하기
**패스 스타일(PASS STYLE)**에서 5가지 Apple Wallet 패스 스타일 중 하나를 선택합니다. 스타일은 레이아웃과 사용 가능한 필드 영역 및 이미지를 제어합니다.
* **탑승권(Boarding Pass)**
* **쿠폰(Coupon)**
* **이벤트 티켓(Event Ticket)**
* **스토어 카드(Store Card)**
* **일반(Generic)**
처음부터 시작하는 경우, 필드와 이미지를 추가하기 전에 스타일을 선택하세요.
스타일을 전환하면 스타일에 특화된 필드가 초기화됩니다.
### 패스 이름 및 설명 추가하기
**기본 정보(BASIC INFORMATION)**에서 다음을 입력합니다.
| | |
| :---- | :---- |
| **패스 이름(Pass Name)** | 패스 제목이며, 업데이트 알림에 표시되는 소스 이름입니다. |
| **설명(Description)** | 패스에 대한 간략한 설명입니다. |
| **로고 텍스트(Logo Text)** | 로고 옆에 표시되는 텍스트입니다(로고 이미지가 업로드되지 않았을 때 사용됨). |
### 색상 및 이미지 설정하기
#### 색상
**색상(COLORS)**에서 다음을 설정합니다.
* **배경색(Background Color):** 패스 배경입니다.
* **전경색(Foreground Color):** 패스의 주요 텍스트 및 아이콘입니다.
* **레이블 색상(Label Color):** 필드 레이블의 색상입니다(예: `FROM`, `GATE`).
색상을 설정하거나 변경하려면 해당 필드를 클릭하고 색상 선택기에서 색상을 선택합니다.
#### 이미지
**이미지(IMAGES)**에서 **아이콘(Icon)**과 **로고(Logo)**를 업로드합니다(둘 다 필수). 선택적 이미지는 패스 스타일에 따라 다릅니다.
각 이미지 슬롯 옆의 **파일 선택(Choose file)**을 클릭합니다. PNG 또는 JPEG 파일을 업로드합니다. Pushwoosh는 패스를 생성할 때 각 이미지를 Apple이 요구하는 해상도(@1x, @2x, @3x)로 처리합니다.
### 패스 필드 채우기
**패스 필드(PASS FIELDS)**에서 패스에 표시되는 텍스트와 값을 추가합니다. 표시되는 그룹은 패스 스타일에 따라 다릅니다.
* **헤더 필드(패스 상단):** 탑승권, 이벤트 티켓
* **기본 필드(주요 콘텐츠):** 모든 스타일
* **보조 필드(지원 정보):** 모든 스타일
* **추가 필드(추가 세부 정보):** 모든 스타일
* **뒷면 필드(패스 뒷면):** 모든 스타일
필요한 각 그룹에서 **+ 필드 추가(+ Add Field)**를 클릭합니다.
각 필드에 대해 다음을 설정합니다.
| | |
| :---- | :---- |
| 키(ID) | 고유한 필드 식별자입니다(자동으로 생성됨). |
| 레이블 | 패스에 표시되는 짧은 레이블입니다(예: `FROM`). |
| 값 | 패스에 표시되는 값입니다(예: `SFO`). |
| 변경 메시지 | 이 값이 변경될 때 업데이트 알림에 표시되는 텍스트입니다. 값이 변경될 때만 표시됩니다. 새 값에는 `%@`를 사용합니다(예: `게이트가 %@(으)로 변경되었습니다`). |
필드 카드에서 **서식(Format)**을 클릭하여 서식 옵션을 표시합니다. 필드를 제거하려면 **X**를 클릭합니다.
#### 서식 옵션
* **값 형식:** 텍스트, 날짜 및 시간 또는 숫자/통화.
* **텍스트 정렬:** 기본값(자연스러움), 왼쪽, 가운데 또는 오른쪽.
* **데이터 탐지기** *(뒷면 필드만 해당):* 뒷면 필드의 전화번호, 링크, 주소, 캘린더 이벤트를 탭할 수 있는 콘텐츠로 전환합니다.
### 바코드 추가하기
**바코드(BARCODE)**에서 형식을 선택하고 인코딩할 데이터를 입력합니다.
1. **바코드 형식:** 바코드 모양과 어떤 유형의 스캐너가 읽을 수 있는지 선택합니다.
* **QR 코드(권장):** 대부분의 휴대폰과 스캐너가 쉽게 읽을 수 있는 정사각형 코드입니다. 쿠폰, 멤버십 카드 및 대부분의 패스에 가장 적합합니다.
* **PDF417:** 여러 줄의 선으로 구성된 넓은 바코드입니다. 항공사 또는 대중교통 탑승권에 종종 필요합니다.
* **Aztec:** QR과 유사한 소형 정사각형 코드입니다. 이벤트 및 대중교통 티켓에 일반적입니다.
* **Code 128:** 고전적인 수직선 바코드입니다. 스캐너나 POS 시스템에서 1D 바코드를 요구하는 경우에만 선택하세요.
2. **바코드 메시지:** 바코드에 인코딩된 값입니다(예: 티켓 또는 멤버십 번호).
3. **대체 텍스트(선택 사항):** 패스의 바코드 아래에 표시되는 텍스트입니다.
### 만료 및 상태 설정하기
**만료 및 상태(EXPIRATION & STATUS)**에서 패스가 표시되는 시점, 만료 시점, 유효 여부를 제어합니다.
* **관련 날짜(패스 표시 시점):** 패스가 잠금 화면에 나타날 수 있는 날짜 및 시간입니다.
* **만료 날짜(패스 만료 시점):** 이 날짜 및 시간 이후에는 Wallet에서 패스가 회색으로 표시됩니다.
* **무효로 표시(이 패스 무효화):** 패스를 더 이상 사용할 수 없도록 무효화하는 체크박스입니다.
### 스타일에 특화된 고급 옵션
* **교통 수단 유형** *(탑승권만 해당):* 항공, 기차, 버스, 보트 또는 일반.
* **그룹화 식별자:** 관련된 패스를 Wallet에서 함께 그룹화합니다.
### 위치 기반 관련성 *(선택 사항)*
**위치 기반 관련성(LOCATION-BASED RELEVANCE)**에서 사용자가 추가한 위치 근처에 있을 때 패스가 나타납니다. 각 위치에 대해 사용자가 근처에 있을 때 잠금 화면에 표시될 텍스트를 설정합니다. 최대 10개의 위치를 추가할 수 있습니다.
지도를 클릭하거나, 주소를 검색하거나, 좌표를 붙여넣거나, 지오존을 가져와 지점을 추가합니다. 마커를 드래그하여 위치를 미세 조정합니다.
**최대 거리**(미터 단위)는 패스가 관련성을 유지하기 위해 사용자가 얼마나 가까이 있어야 하는지를 제어합니다.
**사용 사례 예시**
* **소매:** 고객이 매장 근처에 있을 때 멤버십 카드나 쿠폰이 나타납니다. 잠금 화면 텍스트는 매장 근처에 있다는 것을 알리고 패스 사용을 상기시킬 수 있습니다.
* **이벤트:** 사용자가 행사장(경기장, 극장 또는 축제장) 근처에 있을 때 이벤트 티켓이 나타나 문 앞에서 패스를 빠르게 찾을 수 있습니다.
* **여행:** 출발 공항이나 터미널 근처에서 탑승권이 눈에 띄게 되어 승객이 Wallet을 열기 전에 잠금 화면에서 게이트나 항공편 세부 정보를 볼 수 있습니다.
* **호텔/식당:** 정의한 카페나 호텔 위치 근처에서 쿠폰이나 멤버십 패스가 나타날 수 있습니다.
### User ID 입력하기
이 패스를 받을 사람의 Pushwoosh [User ID](/ko/product/pushwoosh-knowledge-hub/users-userids/#how-are-users-and-devices-related)를 입력합니다. Pushwoosh는 해당 사용자에게 패스를 발급하고 **모든 패스(All passes)**의 **사용자(USER)** 아래에 목록으로 표시합니다.
### 미리보기 및 유효성 검사
**실시간 미리보기**는 편집하는 동안 업데이트되므로 Wallet에서 패스가 어떻게 보일지 대략적으로 확인할 수 있습니다.
패스를 생성하지 않고 Apple의 사양과 비교하여 확인하려면 **패스 유효성 검사(Validate pass)**를 클릭합니다. 빌더는 누락된 필수 이미지 및 기타 문제를 표시합니다.
## 패스 생성하기
**생성(Generate)**을 선택합니다. Pushwoosh는 패스의 유효성을 검사하고, 이미지를 처리하며, 패키지에 서명합니다. 생성에는 몇 초가 걸리며, 그 후 패스가 패스 목록에 나타납니다.
생성 후 패스 편집(일련 번호로 업데이트 포함), 다운로드, 공유 및 삭제에 대해서는 [기존 패스 관리하기](/ko/product/messaging-channels/apple-wallet-passes/#view-and-manage-existing-passes)를 참조하세요.
## API를 통해 패스 관리하기
패스 빌더가 수행하는 모든 작업은 [PassKit Designer API](/ko/developer/api-reference/apple-wallet-passkit-api/)를 통해서도 가능합니다: 패스 생성, 업데이트, 목록 조회, 다운로드 및 삭제.