월렛 패스 업데이트는 패스 도구나 API에서 패스를 수정하는 것으로 끝납니다. 그러면 플랫폼이 패스를 저장한 모든 기기에서 카드를 다시 그리며, 고객이 패스를 다시 설치할 필요는 없습니다. Apple에서는 변경 메시지(change message)가 설정된 필드가 바뀔 때만 잠금 화면 알림이 뜹니다. Google은 멤버십(loyalty), 이벤트 티켓, 항공권 패스에만 자체 알림을 보냅니다.
이 글은 업데이트의 실무 편입니다. 내부 작동 원리는 월렛 패스 업데이트는 어떻게 작동할까에서 다룹니다. 예시는 Pushwoosh 월렛 패스 기준이며, 모든 패스가 User ID에 연결되어 빌더, 캠페인, API 어디서든 업데이트할 수 있습니다. 이커머스 앱의 포인트 카드, 게임 앱의 이벤트 티켓, 추석 시즌 쿠폰처럼 한국 팀이 자주 운영하는 패스를 떠올리며 읽어 보세요.
무엇을 바꿀 수 있나요
거의 전부입니다. Pushwoosh의 Apple Wallet 패스에서는 패스 이름과 설명, 필드 값과 레이블, 변경 메시지, 색상, 바코드 메시지, 만료일과 상태, 위치와 비콘을 수정할 수 있습니다. 이미지는 고정됩니다. Google 패스에서는 여기에 더해 로고와 히어로 이미지, 바코드, 링크, 앱 링크도 바꿀 수 있습니다.
바꿀 수 없는 것은 1가지, 패스 스타일 또는 유형입니다. 스토어 카드를 쿠폰으로 바꿀 수 없고, Google 멤버십 패스를 오퍼로 바꿀 수도 없습니다. 형식 자체를 바꿔야 한다면 새 패스를 발급하세요.
| 변경 항목 | 예시 | 고객에게 보이는 것 |
|---|---|---|
| 필드 값 | 포인트 120점에서 180점으로 | 카드가 다시 그려지고, 변경 메시지가 있으면 알림 |
| 날짜 또는 시간 | 공연 시작이 오후 8시로 변경 | 카드가 다시 그려지고, 변경 메시지가 있으면 알림 |
| 게이트, 좌석, 승강장 | B12 게이트에서 B20으로 | 카드가 다시 그려지고, 변경 메시지가 있으면 알림 |
| 색상(Google은 이미지도) | 추석이나 연말 시즌 디자인 | 카드가 다시 그려지고, 알림 없음 |
| 위치 | 신규 매장 오픈 | 잠금 화면 표시 조건이 바뀌고, 알림 없음 |
| 만료 또는 무효화 | 멤버십 종료 | 카드가 회색으로 바뀌거나 만료된 패스로 이동 |
패스 1장씩, 또는 전체를 한 번에
Pushwoosh의 모든 패스는 1개의 User ID에 속합니다. 그래서 업데이트 방식도 2가지입니다.
패스 1장씩 바꾸는 것이 일상적인 경우입니다. 구매 1건이 고객 1명의 잔액을 바꾸면, 그 고객의 카드가 바뀝니다. 이 작업은 직접 클릭하기보다 거의 항상 API나 태그 동기화로 자동화하게 됩니다.
일괄 업데이트는 프로그램 전체가 대상일 때입니다. 모든 보유자에게 새 약관을 적용하거나, 빼빼로데이 같은 시즌 디자인을 입히는 경우죠. Pushwoosh에서는 Wallet Pass Campaign(월렛 패스 캠페인)으로 처리합니다. 공유(shared)로 지정한 필드는 캠페인에서 발급된 모든 패스에서 바뀌고, 개인(personal) 필드는 고객마다 자기 값을 유지합니다. 저장하기 전에 수정 사항이 몇 장의 패스에 영향을 주는지도 캠페인에서 보여 줍니다.
한국 팀이라면 일괄 업데이트를 시즌 캘린더에 맞춰 미리 잡아 두세요. 12월 설날, 5월 가정의 달, 910월 추석, 11월 블랙프라이데이가 이커머스 앱의 대표적인 대목입니다. 시즌마다 새 패스를 발급할 필요 없이 공유 필드의 디자인과 혜택 문구만 바꾸면 되고, 같은 시점에 프로모션 푸시는 별도 채널로 내보내면 됩니다.
Google Wallet 패스에서는 필드에 사용자 태그를 넣을 수 있습니다. Pushwoosh는 패스를 만들 때 태그 값을 채우고 업데이트할 때마다 새로 고치므로, 카드에는 항상 지금 프로필에 있는 값이 표시됩니다. 캠페인에서는 태그 동기화가 두 플랫폼 모두에서 별도 수정 없이 이 일을 합니다. 필드에 연결된 태그가 바뀌면 다음 확인 시점에 패스가 새 값을 받으며, 기본 확인 주기는 60분입니다.
변경 메시지: 누구에게 알림을 띄울까
모든 업데이트가 고객을 방해할 필요는 없습니다. 어떤 업데이트에 알림을 띄울지는 직접 정합니다.
Apple에서는 필드에 변경 메시지를 붙입니다. 예를 들어 “탑승 게이트가 %@(으)로 변경되었습니다”처럼요. 해당 필드가 바뀌면 iOS가 이 메시지를 잠금 화면에 표시합니다. 변경 메시지가 없는 필드는 조용히 업데이트됩니다.
Google에서는 패스 유형이 Google 자체 알림 여부를 결정합니다. 멤버십, 이벤트 티켓, 항공권 패스만 알림을 받고, 문구는 Google이 작성합니다. 이벤트 티켓과 항공권은 시작 시간까지 3시간 미만 남았을 때만 알림이 갑니다. 유형과 상관없이 API나 캠페인으로 업데이트에 맞춤 알림을 붙일 수도 있습니다. Google은 패스당 24시간 동안 알림을 3회까지만 허용하며, 그 이후의 업데이트는 조용히 반영됩니다.
저희의 원칙은 이렇습니다. 고객이 행동해야 하는 변경, 즉 새 게이트, 바뀐 시간, 소멸 예정 포인트에만 알림을 띄우세요. 디자인 변경이나 신규 매장 위치에는 알림이 필요 없습니다.
게임 앱이라면 이벤트 종료 시각이나 복귀 보상처럼 유저가 지금 행동해야 하는 필드에만 변경 메시지를 붙이세요. 핀테크 앱에서는 거래와 잔액에 관한 필드가 그 대상입니다. 알림이 꼭 필요한 순간에만 뜨면 고객은 잠금 화면 알림을 신뢰하게 되고, 이는 DAU와 리텐션을 지키는 데도 도움이 됩니다.
변경 메시지는 마케팅 채널이 아닙니다
필드 변경으로 세일 소식을 밀어 넣고 싶을 수 있습니다. 하지 마세요. Apple과 Google은 잔액, 상태, 일정처럼 패스와 관련된 알림만 허용하며, 이 규칙을 어기는 것이 카드가 삭제되는 가장 빠른 길입니다.
프로모션은 같은 고객에게 앱 푸시, 이메일, SMS로 보내세요. 모든 패스가 User ID에 연결되어 있으므로 패스 보유자는 이미 오디언스 안에 있습니다. 개인정보에 민감한 한국 고객에게는 광고와 패스 정보를 분리하는 것 자체가 신뢰의 신호이기도 합니다. 준비된 리워드처럼 패스 자체에 관한 소식을 전해야 한다면 패스 보유자에게 메시지 보내기 문서에서 방법을 확인하세요.
API로 업데이트하기
POS, 예약 시스템, 포인트 원장처럼 변경이 자체 시스템에서 발생한다면 빌더 대신 API를 쓰세요. 핀테크 앱의 잔액이나 이커머스 앱의 적립금처럼 값이 자주 바뀌는 패스라면 더욱 그렇습니다. 흐름은 두 플랫폼이 같습니다. 패스를 식별하고, 새 값을 보내고, 동기화는 플랫폼에 맡깁니다.
메서드와 파라미터는 Apple Wallet PassKit API와 Google Wallet API 레퍼런스에 있습니다.
만료, 무효화, 복원
패스에도 수명 주기가 있고, 깔끔하게 끝내는 것은 시작만큼 중요합니다. 고객 Wallet에 남은 오래된 카드는 카드가 없는 것보다 나쁩니다.
Apple에서는 만료일을 설정하면 그 이후 패스가 회색으로 바뀝니다. 쿠폰을 사용한 뒤처럼 패스를 무효화(voided)로 표시할 수도 있습니다. Google에서는 패스를 무효화(invalidate)하면 고객의 Expired passes로 이동하고, 나중에 다시 활성화할 수 있습니다. Google 패스를 삭제하면 Google에서 무효화되고 Pushwoosh의 기록도 제거됩니다.
업데이트가 도착하지 않을 때
대부분은 4가지 원인 중 하나입니다.
Apple 인증서가 만료되었습니다. Apple 패스는 Pass Type ID 인증서로 서명되며, 인증서가 만료되면 패스를 서명하거나 업데이트할 수 없습니다. 인증서를 업로드한 날, 갱신일을 캘린더에 넣어 두세요.
고객이 패스를 삭제했습니다. 업데이트는 패스가 아직 저장된 기기에만 도착합니다.
업데이트는 도착했지만 알림이 없습니다. Apple에서는 해당 필드에 변경 메시지가 있는지 확인하세요. Google에서는 패스 유형, Notify about changed fields 체크박스, 일일 한도를 확인하세요.
고객이 패스를 추가한 적이 없습니다. 발급만 되고 저장되지 않은 패스는 업데이트를 받지 않습니다. 설치 링크를 다시 보내세요. 링크는 일반 URL이므로 이메일, SMS, 푸시뿐 아니라 카카오톡 채널 메시지처럼 고객이 이미 쓰는 채널에도 붙여 넣을 수 있습니다.
Pushwoosh로 모든 패스를 최신 상태로
Pushwoosh는 빌더, 캠페인, API로 네이티브 Apple Wallet과 Google Wallet 패스를 업데이트하며, 각 패스는 푸시, 이메일, SMS와 같은 User ID에 연결됩니다. 잔액 1건이든 프로그램 전체든 바꿀 수 있고, 어떤 변경에 알림을 띄울지도 직접 고릅니다. 고객 데이터는 ISO 27001:2022와 SOC 2 Type 2 인증을 받은 인프라에서 GDPR을 준수해 처리되며, 데이터센터는 EU와 미국에 있습니다.
고객에게 정보를 잘 전한다는 것은 더 많이 보내는 일이 아닙니다. Wallet 속 카드가 언제나 정확한 것입니다.
