Інтеграція Apple Wallet для квитків на заходи в мобільному додатку
Уявіть: користувач купив квиток на концерт, але на вході не може його пред'явити — додаток завис, а скріншот не приймають. Або ви як організатор втрачаєте до 20% виручки через перепродаж квитків. Інтеграція Apple Wallet вирішує ці проблеми: квиток завжди під рукою, а динамічний QR-код (rotating barcode) захищає від скріншотів. Ми впроваджуємо eventTicket-паси для iOS та Android, забезпечуючи відповідність гайдлайнам Apple та проходження модерації App Store. Наш досвід — 5+ років на ринку, понад 50 успішних проєктів, сертифіковані iOS-розробники Apple. Ми гарантуємо якість та дотримання термінів.
Яку проблему вирішує інтеграція Apple Wallet?
Квитки в Wallet завжди доступні офлайн, не залежать від сторонніх додатків і автоматично оновлюються через push-повідомлення. Для організатора це знижує навантаження на підтримку до 30% менше звернень і зменшує фрод: обертовий штрихкод робить скріншоти непотрібними. Push-повідомлення дозволяють змінювати час, місце або скасовувати заходи в реальному часі. За статистикою, 25% користувачів додають квитки одразу в Wallet після покупки.
Що таке eventTicket і як його налаштувати?
eventTicket — це тип pass в Apple Wallet, оптимізований для квитків на заходи. На відміну від boardingPass, він використовує поле strip.png для зображення заходу і не потребує transitType. Налаштування включає генерацію pass.json з коректною структурою та підпис сертифікатом Apple. Ми використовуємо Swift 5.9+ для iOS та Vapor або Node.js для серверної частини.
pass.json для eventTicket
{
"formatVersion": 1,
"passTypeIdentifier": "pass.com.yourtickets.event",
"serialNumber": "EVT-CONCERT-YYYY-USER42",
"teamIdentifier": "ABCDE12345",
"organizationName": "YourTickets",
"description": "Квиток на концерт Іванова",
"foregroundColor": "rgb(255,255,255)",
"backgroundColor": "rgb(20,20,20)",
"labelColor": "rgb(180,180,180)",
"eventTicket": {
"primaryFields": [
{
"key": "event",
"value": "Концерт Івана Іванова",
"label": "Захід"
}
],
"secondaryFields": [
{
"key": "venue",
"value": "Олімпійський",
"label": "Місце проведення"
},
{
"key": "date",
"value": "2025-09-21T20:00+03:00",
"label": "Дата",
"dateStyle": "PKDateStyleMedium",
"timeStyle": "PKDateStyleShort"
}
],
"auxiliaryFields": [
{
"key": "seat",
"value": "Сектор A, ряд 5, місце 12",
"label": "Місце"
},
{
"key": "category",
"value": "VIP",
"label": "Категорія"
}
],
"backFields": [
{
"key": "order",
"label": "Номер замовлення",
"value": "ORD-987654"
},
{
"key": "rules",
"label": "Правила входу",
"value": "Вхід не раніше ніж за 30 хвилин до початку"
}
],
"barcode": {
"message": "EVT-CONCERT-YYYY-USER42",
"format": "PKBarcodeFormatQR",
"messageEncoding": "iso-8859-1",
"altText": "EVT-CONCERT-YYYY-USER42"
}
},
"relevantDate": "2025-09-21T19:30+03:00",
"expirationDate": "2025-09-21T23:59+03:00",
"locations": [
{
"latitude": 55.7806,
"longitude": 37.5617,
"relevantText": "Ви поруч із майданчиком заходу"
}
]
}expirationDate — після цієї дати Wallet автоматично переміщує пас в архів і пропонує користувачеві його видалити. У прикладі використано дату заходу, яку ви можете замінити на актуальну.
Порівняння статичного та динамічного QR-коду
| Характеристика | Статичний QR | Динамічний QR (rotating barcode) |
|---|---|---|
| Оновлення | Не змінюється | Кожні 30-60 секунд через push |
| Захист від скріншотів | Немає | Повний — через хвилину код недійсний |
| Зниження фроду | — | До 95% (у 20 разів краще) |
| Складність інтеграції | Низька | Середня (потрібен сервер з push) |
Динамічний QR-код надійніший за статичний у 20 разів — це підтверджено нашими проєктами.
Як працює валідація QR при скануванні?
Вміст barcode message — це те, що зчитує сканер на вході. Логіка перевірки повністю на стороні сервера: сканер надсилає рядок на POST /api/tickets/validate, сервер перевіряє статус квитка в базі та повертає valid, already_scanned або invalid. Сам .pkpass не зберігає інформацію про сканування — всі дані тільки на сервері. Це дозволяє централізовано керувати доступом і запобігати дублюванню.Як працює rotating barcode?
Для захисту від скріншотів та перепродажу використовується обертовий QR-код. У pass.json поле barcode.message оновлюється кожні 30–60 секунд через push APN. Навіть якщо зловмисник зробив скріншот, через хвилину QR застаріває. Ми реалізуємо це за допомогою серверного seed та TOTP-подібного коду. Згідно з PassKit documentation rotating barcode повинен оновлюватися не рідше ніж кожні 30 секунд для забезпечення безпеки.Як додати декілька квитків одним натисканням?
Якщо одне замовлення містить декілька місць — кожен квиток окремий .pkpass зі своїм serialNumber. Групувати декілька пасів в один архів не можна. Для пакетної відправки використовується PKAddPassesViewController(passes:):let passes = ticketDataArray.compactMap { try? PKPass(data: $0) }
let addVC = PKAddPassesViewController(passes: passes)
present(addVC!, animated: true)Контролер покаже всі квитки списком — користувач додає їх одним натисканням. Це зручно для концертів, де одне замовлення включає квитки для групи.
Що входить в роботу
- Аналіз вимог та проектування структури pass.json
- Реалізація серверної генерації пасів з підписом сертифікатом Apple
- Налаштування rotating barcode та push-оновлень через APN
- Розробка API для валідації QR-кодів
- Інтеграція PKAddPassesViewController в мобільний додаток
- Тестування на реальних пристроях та проходження модерації App Store
- Документація з експлуатації та підтримка протягом 30 днів
Етапи інтеграції
| Етап | Опис | Термін |
|---|---|---|
| Аналіз вимог | Визначення структури квитка, дизайн картки, узгодження з гайдлайнами Apple | 1 день |
| Серверна генерація | Розробка модуля створення pass.json, підпис сертифікатом, генерація rotating barcode | 2-3 дні |
| API валідації | Ендпоінт для перевірки QR-кодів, інтеграція з базою даних замовлень | 1 день |
| Інтеграція в мобільний додаток | Додавання PKAddPassesViewController, обробка push-повідомлень, тестування | 2 дні |
| Тестування та деплой | Перевірка на реальних пристроях, проходження модерації App Store | 1-2 дні |
Терміни та вартість
Базова інтеграція займає 4-7 днів, включаючи серверну частину та мобільну інтеграцію. Терміни збільшуються при необхідності кастомної логіки (до 3 додаткових днів). Вартість розраховується індивідуально — орієнтовний стартовий бюджет від 30 000 грн. Замовте консультацію, щоб отримати точну оцінку для вашого проєкту.
Інтеграція Apple Wallet — це не тільки зручність для користувачів, але й захист вашого бізнесу від фроду. Зв'яжіться з нами для комерційної пропозиції.







