Інтеграція 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 — це не тільки зручність для користувачів, але й захист вашого бізнесу від фроду. Зв'яжіться з нами для комерційної пропозиції.