Apple Wallet. Что это такое и как интегрировать в него свою карту

Фанаты “яблочной” продукции отлично знают, что iPhone – не только имиджевое (и очень дорогое) устройство, но и превосходное защищенное хранилище для различной финансовой информации. Сохранность обеспечивает фирменное приложение Wallet. Что это за штука и как ею пользоваться? Попробуем дать ответы на эти вопросы.

Несмотря на непростое время, многие из нас все равно вынуждены перемещаться между городами и странами. Понятно, что причины сейчас для этого веские: одни едут на учебу или работу, другие уезжают, чтобы поправить здоровье, третьи пытаются вернуться домой. Понятно, что каждому пользователю хотелось бы максимально облегчить свое путешествие, и благо смартфон позволяет нам это сделать. Как вы уже догадались, я говорю про добавление Авиа и ЖД билетов в Wallet на iPhone. В статье предлагаю раз и навсегда разобраться в этой фиче и обсудить все детали.

Рассказываем, как добавить билет в Wallet.

6 функций iPhone, которыми я никогда не пользовался.

8 мин

58K

Принято считать, что Wallet – не самый популярный сервис в СНГ. Но уже во втором проекте подряд заказчик ставит задачу «Сделать интеграцию с Wallet». Поэтому я решил написать эту статью, чтобы рассказать о сервисе в целом и показать, как интегрировать в него свой продукт.

Что такое Wallet? Он позволяет держать в телефоне различного вида карты (билеты, скидочные карты и т.п.), облегчая жизнь пользователям продукта. Более того, есть возможность актуализировать информацию о карте посредством push-уведомлений, но это тема для отдельной статьи. Но если у вас есть карта/билет/абонемент, которые можно интегрировать в телефон, то для этого есть решение! Как это сделать – читайте ниже.

Как правило, за создание карты отвечает ваш сервер. Приложение получает карту в виде .pkpass файла и уже через приложение пользователь может добавить карту в Wallet.

Что такое Wallet?

Стоит отметить, что ранее приложение Wallet называлось Passbook. Оно впервые появилось в iOS в 2012 году и предназначалось для хранения карт лояльности, посадочных талонов, билетов в кино в электронном виде. Доступна такая прелесть была исключительно в США. На отечественные просторы такая опция вышла только через пару лет. Однако и Apple не дремала. К 2014 году в США запустили сервис Apple Pay (возможность оплаты покупок с помощью iPhone). И Wallet-passbook получил опцию для добавления карт оплаты. Также в приложении хранились данные о платежных реквизитах.

Не стоит и упоминать о том, что до России Apple Pay и обновленный Wallet добрались только к 2016 году. Лучше поздно, чем никогда. Однако и теперь далеко не везде есть возможность оплатить покупку с помощью айфона. А с картами лояльности ситуация и вовсе критическая. Но некоторые опции Wallet для iPhone доступны и у нас. Поэтому нужно их рассмотреть и описать. Стоит начать с самого простого и очевидного.

Apple Wallet – одно из тех приложений, которые есть у всех нас, но не многие из нас фактически используют. Тем не менее, он становится все более важной частью экосистемы Apple, и не зря.

По мере того, как все больше приложений присоединяется к Apple Wallet, возможно, вам пора наконец узнать, что это такое и как заставить его работать на вас.

В 2012 году Apple выпустила Apple Passbook. Разработано как приложение-кошелек, в котором пользователи iPhone могут хранить все, что они положат в свою физическую сберегательную книжку. Хотя для того времени это была новая идея, компании и люди еще не были готовы к переходу на цифровые технологии.

В 2014 году Apple запустила Apple Pay, которая является основой бесконтактной технологии во всех устройствах Apple. Он поддерживает основные кредитные и специальные карты, такие как Visa, MasterCard и American Express.

Это открыло множество возможностей для поставщиков кредитных карт перейти на цифровые технологии, не имея собственного приложения. После интеграции с Apple Wallet пользователи Apple почувствовали, насколько это удобно для всех.

С запуском iOS 9 в 2015 году Apple Passbook сменила название на Apple Wallet. В то же время приложение также начало поддерживать различные дисплеи, такие как Aztec, PDF и штрих-коды.

С тех пор Apple добавила множество новых розничных продавцов, которые принимают карты Apple Pay и Apple Wallet каждый год. Кроме того, Apple также расширила стратегическое партнерство с университетами, производителями автомобилей и другими приложениями.

В настоящее время Apple Wallet позволяет хранить купоны, посадочные талоны, удостоверения личности, билеты, ключи и даже кредитные карты в одном приложении. Пропусками или цифровыми купонами и билетами можно легко делиться с другими пользователями благодаря Apple Wallet.

В настоящее время Apple Wallet работает практически на всех устройствах Apple, включая Mac, iPhone, iPad и даже Apple Watch.

К устройствам, совместимым с Apple Pay, относятся iPhone 6, iPad Air 2, iPad mini 3, iPad Pro, Apple Watch 3 или более поздние версии. Кроме того, с ним также работают компьютеры Mac с Touch ID или используемые в тандеме с iPhone с Touch ID.

Многие владельцы iPhone каждый день пользуются приложением Wallet на своих смартфонах, хотя зачастую и не подозревают об этом. Ведь в первую очередь эту программу запускают для активации оплаты с помощью Apple Pay, и с тех пор, как платежная система стала доступна, свои карты к ней привязали миллионы пользователей. Однако возможности Apple Wallet выходят далеко за пределы оплаты покупок в магазине.

Содержание

• 1 Первым делом самолеты
• 2 Поездом комфортнее
• 3 Поселитесь в люксе
• 4 Без очередей в кино и ресторан
• 5 Новое слово в бизнесе

Первым делом самолеты

Сейчас большинство авиакомпаний, будь то «Аэрофлот» или S7, позволяют осуществить посадку на рейс при помощи электронной карточки Wallet. Она заменяет собой полноценный билет: во многих аэропортах мира это позволяет попасть на самолет, отсканировав карточку (после этого открывается специальный турникет). Как правило, авиакомпании дают возможность отправить карточку в Wallet сразу после онлайн-регистрации на рейс.

Поездом комфортнее

Да, с наземным транспортом дела обстоят точно так же. Достаточно воспользоваться сервисом (приложением) вроде Tutu.ru или TicketNow, где можно купить билет на поезд, сохранить его в виде карточки Wallet и в большинстве случаев попасть с ее помощью в вагон, когда проводник специальным сканером «прочтет» код с карточки. С поездами дальнего следования иногда могут случаться накладки (некоторые проводники до сих пор делают круглые глаза при слове «электронная регистрация»), но в том же «Сапсане» или «Ласточке» система отлажена на твердую пятерку. В Wallet также можно загрузить билет на аэроэкспресс после покупки в одноименном приложении.

Поселитесь в люксе

При заезде в отель необходимо, как правило, распечатывать подтверждение, показывать на ресепшене при въезде — в общем, не самое удобное начало отпуска. Но если заранее сохранить карточку с бронированием в Apple Wallet, можно ограничиться ее показом, в крупных отелях это снизило временные затраты на регистрацию постояльца в несколько раз. Сохранение бронирования в виде карточки Wallet поддерживают все крупные сервисы по бронированию отелей — Booking.com, Ostrovok.ru и другие.

Без очередей в кино и ресторан

Этим наверняка наши читатели пользуются чаще всего, ведь, по статистике, более 30% билетов, купленных онлайн, попадают именно в Wallet. Но на всякий случай напомним для тех, кто до сих пор приходит за 40 минут до начала сеанса постоять в очереди за билетами. Сейчас сохранение билетов в кино в виде карточки Wallet поддерживают все билетные системы, а именно Rambler, Parter, Tickets, Яндекс.Касса, Кинопоиск и Киноход. После покупки приложения сами формируют билеты в кино в виде карточки Wallet и штрихкода, причем даже если вы покупали 4-5 билетов на компанию, карточка все равно одна, что очень удобно. При входе в залы в кинотеатрах сейчас установлены специальные автоматы, которые сканируют QR-код на карточке и пускают на сеанс.

Аналогично это работает и с ресторанами. Забронировали онлайн, сохранили карточку в Wallet, показали ее хостес при входе. И можно наслаждаться ужином!

Надо ли говорить, что и этим возможности Apple Wallet не ограничиваются. Карточки, например, можно применять для хранения страховых полисов из «Тинькофф Страхование», «ВТБ страхование», «АльфаСтрахование», «Ингосстрах» (в поездках за границу пригодится), а также для такого направления, как карты лояльности.

Новое слово в бизнесе

Сейчас карты лояльности в Apple Wallet реализуют многие компании, в том числе своими силами, но зачастую такие карточки бесполезны: они содержат мало информации, не могут обновляться, так как отсутсвует интеграция с внутренними бизнес системами, не имеют push-уведомлений и обратной связи. Поэтому существуют специальные сервисы электронных карт, предоставляющие комплексные решения по автоматизации бизнеса. Одним из них является компания OSMICards — сервис, который с 2012 года работает на базе Wallet для iOS и WalletUnion для Android, помогая компаниям и пользователям максимально выгодно использовать все преимущества данной технологии.

Клиенты ЦУМа, например, уже успели оценить удобство карты лояльности торгового центра в AppleWallet, которые были разработаны в сотрудничестве с OSMICards. Очень удобно, например, иметь возможность контролировать свой бонусный счет и статус карты, а также получать push-уведомления о предстоящих акциях и распродажах прямо в Wallet, без необходимости нагружать свой iPhone еще одним приложением. Кроме того, поскольку карточки работают с геолокацией пользователя, Wallet известит о распродаже обуви в том же Hugo Boss, если владелец карты лояльности окажется неподалеку от магазина.

Бизнес может дарить своим покупателям электронные ссертификаты в AppleWallet, что значительно упрощает их распространение. Ну и не стоит забывать о продвинутой обратной связи — можно с помощью Wallet общаться с магазином и высказывать свое мнение об обслуживании.

С точки зрения маркетологов преимуществ от использования технологии AppleWallett значительно больше. В первую очередь — отсутствие необходимости выделять внушительные бюджеты на SMS-оповещение, рассылки по электронной почте и работу сотрудников кол-центра. Сервис позволяет взаимодействовать с покупателями при помощи push-уведомлений и геотаргетинга: управлять всем этим можно в Личном кабинете, где компания создает электронные карты клиента, или же непосредственно из бизнес-системы (1С, ManzanaLoyalty, 1C-Битрикс, LuxeRetail, Universoft, R-keeper, iiko и многие другие). Есть возможность размещения до 10 активных геометок, с помощью которых осуществляется информирование клиента о ближайших точках продаж. Также сервис AppleWallet позволяет заменить заполнения неудобных бумажных анкет покупателями в магазине на электронный формат, тем самым моментально и без искажения получать данные в CRM-системе, проверять номер указанного телефона, экономить время продавцов, а также отказаться от ведения архива бумажных анкет для ФАС.

Персональному подходу к покупателю также способствует отслеживание количества выданных карт и установок, активности использования карты и даже моделей смартфонов клиентов. Но самый, пожалуй, очевидный плюс продвинутых карт лояльности — отсутствие необходимости в разработке собственного мобильного приложения, а это экономия до миллиона рублей на дизайне, написании кода и дальнейшей поддержке программы.

Наглядно результат использования карт лояльности от OSMICards описала торговая сеть «TimeCode»: она ранее эмитировала пластиковые карты лояльности, но затем решила использовать свою базу клиентов для выпуска электронных карт в Wallet. После этого торговая сеть стимулировала своих покупателей к установке электронного подарочного купона на фиксированную сумму.

В результате сеть получила небывалый скачок повторных продаж, а если учесть, что она занимается продажей швейцарских часов, можно представить, как подобная схема будет работать в других товарных категориях. За первые 14 дней акции клиентами было установлено в смартфоны около 10 000 электронных купонов, из которых около 50% — это совершенно новые клиенты, а денежный поток вырос в 3-5 раз. Компании также оценят, что на оборотной стороне электронной карты можно размещать любые ссылки — например, на свои социальные сети, сайт, онлайн-магазин, мобильное приложение, а при желании и проводить опросы, разместив на обороте карты кнопки ответов, являющиеся ссылками.

Преимущества внедрения Wallet в бизнесе очевидны, и поскольку Apple постоянно развивает свой сервис, покупатели вскоре смогут получить больше функций в электронных картах лояльности и дополнительные возможности использования Wallet, а ритейл — улучшенные каналы коммуникации с пользователями за счет новых трендов в сфере электронных карт.

WalletОбзоры приложений для iOS и MacОбзоры техники Apple

Советы и хитрости Apple Wallet

Если вы, наконец, решили использовать Apple Wallet, вот несколько способов улучшить его.

Всплывающее уведомление

Настройка push-уведомлений – отличный способ отслеживать важные новости, обновления бронирования и эксклюзивные акции. Push-уведомления отлично подходят для срочных напоминаний, таких как время просмотра фильмов и время посадки на рейс.

Они также полезны для геолокационных предложений, которые могут появиться на ваших зарегистрированных бонусных картах.

Чтобы включить push-уведомления для Apple Wallet на вашем iPhone, перейдите в « Настройки»> «Уведомления»> «Apple Wallet» . Затем включите параметр « Разрешить уведомления» .

Для дальнейшей настройки уведомлений Apple Wallet прокрутите вниз и коснитесь « Настройки уведомлений кошелька» .

Галерея изображений (3 изображения)

Автоматические обновления

Когда дело доходит до того, чтобы быть в курсе дел, Apple Wallet выполняет большую часть работы за вас. Apple Wallet удобен, когда поставщики услуг или организаторы мероприятий меняют детали в последнюю минуту. Эту функцию лучше всего использовать вместе с push-уведомлениями.

Например, Apple Wallet не просто автоматически извлекает сведения о рейсах или событиях из интегрированных приложений. Он также настраивается непосредственно в приложении при любых внезапных изменениях. С Apple Wallet случайное попадание не в те ворота в аэропорту уйдет в прошлое.

Вам когда-нибудь приходилось путешествовать с легкомысленным другом, у которого просто нет вещей вместе? С помощью Apple Wallet вы можете сохранить все их проездные на всю поездку, в том числе и ваш.

Apple Wallet отслеживает детали бронирования, такие как билеты, посадочные талоны и бронирование отелей. Затем он также позволяет отправлять их напрямую людям, которых вы знаете, через AirDrop, почту, сообщения или отправляя ссылку.

Билеты на самолеты и поезда

Мало кто знает, но при помощи сервиса Apple Pay в связке с Wallet (что это такое, мы разобрали чуть выше) можно приобретать билеты на поезда и самолеты и легко использовать их электронные версии для посадки. Это весьма удобно и уже довольно давно используется в Европе и США. В России же такая возможность появилась относительно недавно. Тем более нужно ее попробовать. “Аэрофлот” и другие перевозчики уже могут порадовать клиента новой опцией. То же самое и с поездами. Хотя некоторые проводники все еще выпучивают глаза на смартфон при попытке сесть в вагон. Но это ненадолго. Скоро все придет в норму.

Как использовать Apple Wallet

Хотя Apple Wallet поставляется с большинством устройств Apple, его нужно немного настроить перед работой. Вот несколько быстрых способов подготовить свой Apple Wallet к использованию.

Настроить Apple Pay

С помощью Apple Pay пользователи Apple Wallet могут совершать безопасные покупки для розничных продавцов-партнеров. Чтобы использовать Apple Pay, вы должны находиться в поддерживаемом регионе, иметь подходящее устройство, войти в iCloud и использовать карту участвующего эмитента.

Apple Pay позволяет пользователям добавлять на устройство до 12 карт. Для старых устройств Apple ограничение составляет восемь карт. При использовании Apple Pay на нескольких устройствах имейте в виду, что вам необходимо вручную добавлять каждую карту на каждое устройство.

В 2021 году Apple представила варианты оплаты криптовалютой посредством интеграции с BitPay через Apple Wallet. Помимо оплаты вещей, Apple Pay также позволяет отправлять и запрашивать деньги у других пользователей Apple Pay в США.

Интегрируйте свои идентификаторы

Apple сотрудничает с сотнями школ, чтобы интегрировать бесконтактные идентификаторы учащихся с Apple Wallet, как было объявлено в Apple Newsroom . Вместо физического удостоверения личности студенты могут использовать свой цифровой студенческий билет в своем Apple Wallet для доступа к различным частям кампуса, таким как общежития и библиотеки.

Галерея изображений (3 изображения)

Для некоторых университетских партнеров Apple Wallet также работает для различных платежей в кампусе их кафе или магазинов. При этом все, что вам нужно, – это ваш iPhone в кармане, когда вы выходите из общежития.

Добавьте ключи от машины

С помощью Apple Wallet вы также можете использовать свой iPhone или Apple Watch, чтобы разблокировать и завести автомобиль.

В 2021 году Apple объявила о совместимости автомобильных ключей с несколькими моделями BMW и, вероятно, в ближайшие годы увеличит это число. Эта функция доступна для iPhone XS, Apple Watch Series 5 и новее.

Чтобы добавить ключи от машины в приложение Apple Wallet, вы должны использовать приложение производителя автомобиля для сопряжения с устройством. В зависимости от производителя это соединение может быть подтверждено по электронной почте или в текстовом сообщении.

Ключи визуального оформления

Структура карты

Что же представляет собой карта с точки зрения разработчика? Карта – это архив с расширением .pkpass. Он содержит в себе все данные, необходиимые для отображения и работы карты. Содержимое архива – в таблице ниже.

Существуют следующие типы карт:

• Посадочный билет: на самолет или поезд. Обычно купон работает на одну поездку;
• Купон: для купонов и специальных предложений;
• Билет на событие: может работать как для одного события, так и для целого сезона;
• Скидочная карта: карты лояльности, скидочные или подарочные карты;
• Карта общего вида: если ничего из вышеперечисленного не подходит под ваш случай: например, карта для поездок на метро или пропуск в спортзал.

Рассмотрим схематично внешний вид разных карт. Картинки лучше называть так, как это указано в таблице выше.

Посадочный билет

Купон

Билет на событие

Общая карта

Скидочная карта

Ключи для связанных приложений

Получите максимум от Apple Wallet сегодня

Хотя рост Apple Wallet был медленным, это лишь вопрос времени, когда пользователи iPhone увидят его роль в экосистеме Apple. Фактически, Apple Wallet, без сомнения, уже является неотъемлемой частью iPhone.

С помощью Apple Wallet пользователи могут получить максимальную отдачу от портфеля продуктов, услуг и интеграции приложений Apple. По мере того, как с ним работают все больше разработчиков и розничных продавцов, приложения, интегрированные с Apple Wallet, со временем будут только улучшаться и становиться более функциональными.

Как добавить билет на самолет в Wallet

Добавить билет в Wallet на iPhone весьма просто. Достаточно следовать простой инструкции:

• Откройте приложение авиакомпании, сообщение в электронной почте или любой другой источник, где может находиться штрихкод билета.
• Затем нажмите на значок Добавить в Apple Wallet.
• Далее следуйте инструкциям на экране.

Процедура добавления билета авиакомпании S7 Airlines

Я добавляю билеты в Wallet на свой iPhone уже несколько лет. Фишка очень удобная: вместо того, чтобы стоять в очереди на регистрацию, быстро проходишь в зал ожидания и не стоишь по полчаса. И вот вчера столкнулся с проблемой, которая вывела меня из состояния равновесия. Оказывается, далеко не все авиакомпании позволяют добавить билет в кошелек.

Когда я летал Аэрофлотом, например, вообще не проходил регистрацию и воспользовался штрихкодом в приложении. Заплатил 300 рублей за удобные места, прошел регистрацию и готово. А вот с Победой пришлось повозиться, что, в прочем, не удивительно.

На официальном сайте Apple написано, что в случае, если кнопки Добавить в Wallet нет, необходимо обратиться к авиакомпании. Но звонки в Победе платные! Дальше я попробовал зайти в личный кабинет через приложение Победы, как то мне выдало неизвестную ошибку. Покумекав пару минут понял, что в этот раз видимо обойдемся без билета.

Позже вспомнил, что раньше для покупки билетов я использовал разные приложения: Тинькофф, OneTwoTrip, Tutu. Они-то мне и предлагали добавить билет в Wallet. А напрямую я это делал только через Аэрофлот. Рекламы здесь никакой нет. Никогда бы не подумал, что это напишу, но брать билеты лучше через сторонние программы.

Подписывайтесь на нас в Яндекс.Дзен, там вы найдете много полезной информации из мира Apple.

Проверка на уникальность

Поскольку в вашем сервисе, как правило карта привязана к аккаунту, в приложении скорее всего придется как-то определять принадлежность карты к текущему пользователю. Предлагаю делать это через serialNumber. Например, задавать в качестве serialNumber id пользователя или номер карты.

Получение информации о добавленных картах

Чтобы получить информацию о картах, имеющихся в Wallet и относящихся к вашему приложению, необходимо обратиться к объекту PKPassLibrary.

let passLibrary = PKPassLibrary()
let passes = passLibrary.passes()

Таким образом, можно понять, добавлена карта или нет, а также обновить интерфейс. Кроме того, через PKPassLibrary карты можно обновлять и удалять. Обновлять карты можно и через веб-сервисы, но в этой статье мы не будем рассматривать такой вариант.

Установка сторонних приложений

Чтобы максимально использовать Apple Wallet, лучше использовать его в тандеме со сторонними приложениями. По мере того, как Apple диверсифицирует свои продуктовые линейки и предложения, увеличение числа владельцев устройств Apple способствует более широкому распространению Apple Wallet. Таким образом, у разработчиков появляется больший стимул делать свои приложения совместимыми с Apple Wallet.

При покупке у поддерживаемых продавцов через Apple Pay пропуски автоматически добавляются в ваш Apple Wallet. Кроме того, карты вознаграждений, связанные с вашим Apple Wallet, также будут обновлены.

Например, после совершения покупки в Walgreens с помощью Apple Pay на вашей карте Walgreens будут зарегистрированы любые вознаграждения.

Тестирование

Apple предоставляет примеры pkpass для разных типов, можно ориентироваться на них.
Apple Wallet samples
Чтобы увидеть то, как выглядит карта, можно, добавить pkpass в проект (см. «Добавление карты»). Процесс добавления/удаления уже рассмотрен выше, осталось только напомнить, что приложение не будет видеть уже добавленные карты, если карта для Wallet создавалась на одном аккаунте разработчика, а сама разработка велась с другого аккаунта (актуально для аутсорс-компаний). При этом добавлять карты можно без проблем.
Проверить, корректно ли закодирована информация в штрихкоде, можно с помощью любого сканера QR-кодов. И точно необходимо проверить корректность работы с настоящим сканером.

Приобретение билетов в кино

Мало кто знает, но, приобретя билеты на каком-нибудь популярном онлайн-сервисе, можно добавить их в Wallet и спокойно использовать их электронные копии для прохода в кино. Пока в России не особо много сервисов поддерживают эту опцию. Но “Киноход”, Rambler, Parter, Tickets, “Яндекс.Касса”, “Кинопоиск” точно поддерживают. Можно смело приобретать билеты в кино, на концерты и другие мероприятия и использовать их электронные копии из Wallet при входе.

Однако не стоит забывать, что далеко не во всех городах нашей необъятной Родины работники развлекательных заведений знают, что такое Apple Wallet и с чего это вдруг им вместо билета суют телефон с какой-то невразумительной информацией на экране. В глубокой провинции такие новшества пока еще вызывают шок. Так что не стоит нервировать людей. В провинциальный кинотеатр пока еще лучше ходить, имея при себе классический бумажный билет. Так будет надежнее и не возникнет глупых и неприятных вопросов.

Другие возможности Wallet

Если разобраться, то Wallet – уникальное приложение. Ничего подобного в ОС “Андроид” и близко нет. Хотя в “Гугл” пытались создать копию бумажника от “яблочников”. Но оригинальный Wallet обладает сложной многоступенчатой защитой и приятным интерфейсом. В принципе, все основные опции приложения были рассмотрены выше, но есть еще несколько функций, которые появились относительно недавно в Wallet. Обзор был бы неполным без их упоминания. К примеру, студенты могут сделать электронный студенческий билет и использовать его вместо бумажного или пластикового. Однако такая крутая фишка пока доступна только студентам из Штатов. И то не всем. А о том, когда такая функция придет в Россию, история умалчивает.

В 2018 году в Wallet была добавлена возможность бесконтактного использования всех карт (платежных, бонусных, различных билетов, студенческих пропусков и так далее). Но опять же. Доступна данная опция только жителям Соединенных Штатов Америки, использующим Wallet. Что это? Отголоски санкций? Нет. Просто в РФ все новинки не всегда можно внедрить по причине отсутствия аппаратных возможностей. Но в скором времени новые опции бумажника айфона будут доступны и пользователям из России. Правда, у Wallet к этому времени появятся новые. Вот так и живем.

Как добавить билет РЖД в Wallet

Низкий поклон Российским Железным Дорогам за простую и очень понятную процедуру добавления билетов в Apple Wallet. За 5 лет использования ни я, ни мои знакомые не сталкивались с трудностями при покупке билетов онлайн, все просто и понятно.

Чтобы добавить ЖД билет в Wallet, вам необходимо:

• Скачать приложение РЖД Пассажирам в App Store (ссылка).
• Приобрести нужный вам билет.
• Далее перейти в раздел Мои билеты.
• Тапнуть на билет, который хотите добавить в Кошелек.
• Пролистать до конца и нажать Добавить в Wallet.
• Далее вас перебросит в фирменное приложение, где вам останется нажать кнопку Добавить.

Добавить билет РЖД в iPhone легче легкого.

Причем инструкция работает буквально на все виды железнодорожного транспорта: электрички, ласточки, сапсаны, поезда. Ну и показывать билет потом тоже очень удобно. Подошел к проводнику, показал билет вместе с паспортом и готово.

Что делать, если приходят двойные уведомления на Айфон.

Друзья, очень прошу рассказать о своем опыте добавления авиабилетов Wallet. Какими приложениями вы пользуетесь? Может быть у кого-то получалось добавлять Победу через сообщение из электронной почты? В общем, жду вас в комментариях ниже или в нашем Телеграм-чате.

WalletОбзоры приложений для iOS и MacСоветы по работе с Apple

Оборотная сторона

На оборотной информационной части можно разместить дополнительную информацию: условия использования, политику автообновления, контактные данные и ссылку на приложение, к которому относится карта. На рисунке представлено соответствие полей в pass.json и внешнего вида обратной стороны карты. Если в value-поле есть ссылки, номера телефона и т.п., они подсветятся автоматически.

Используемые материалы

https://developer.apple.com/library/archive/documentation/UserExperience/Conceptual/PassKit_PG/Creating.html
https://developer.apple.com/library/archive/documentation/UserExperience/Reference/PassKit_Bundle/Chapters/TopLevel.html#//apple_ref/doc/uid/TP40012026-CH2-SW3
https://itechroof.wordpress.com/2015/11/30/apple-wallet-part-13/
https://developer.apple.com/library/archive/documentation/UserExperience/Conceptual/PassKit_PG/Updating.html

Отдельное спасибо mehdzor за аккаунт разработчика для тестов.

Интеграция с приложением

Для того чтобы приложение имело возможность добавлять карты в Wallet, необходимо включить эту возможность в App ID и также включить эту возможность в Capabilities в проекте.

Это необходимо для полноценной корректной работы с Wallet. В противном случае не получится считывать карты с Wallet и, например, не будет возможности понять, добавлена наша карта или нет. Также важно отметить, что team id в pass.json должен совпадать c team id, либо придется добавлять их вручную в entitlements и это может исправить ситуацию, но это я не проверял.

Работа с неплатежными картами

Так называемые карты лояльности предоставляются различными магазинами и другими торговыми точками. С помощью этих карт можно накапливать бонусы, получать скидки и прочие приятности. Но далеко не все представители отечественного бизнеса поддерживают карты для Wallet. Точно можно сказать, что в ближайшее время данная технология будет внедрена практически везде. Но пока список экстремально короткий. Обычно торговые сети оповещают своих клиентов о возможности создать бонусную карту в Wallet с помощью СМС-сообщений. Поэтому стоит следить за такими рассылками. Часто появляется возможность сделать карту. И не стоит ее упускать.

Структура pass. json

Обязательные поля. Содержат Pass Type ID, Team ID, название организации и т.п.
Ключи для связанных приложений. Нужны для отображения приложений, которые нужно «ассоциировать» с картой.
Ключи «срока годности» карточки.
Ключи актуальности. Например, координаты местности, где карта может быть использована, или начало события, для которого она предназначена.
Ключ стиля. В начале статьи были перечислены 5 видов карт для Wallet. Каждому из них соответствует свой стиль. Такой ключ должен быть строго один.
Ключи визуального оформления карты. Помимо очевидного, содержат в себе информацию о штрихкоде, отображаемом на карте.
Ключи web-сервисов. Вы можете использовать web-сервисы для взаимодействия с картой, например, автоматически ее обновлять.
NFC-ключи. Содержат дополнительную информацию для Apple Pay транзакции.

Теперь обо всем подробнее.

Обязательные поля

Ключи стиля

JSON в данном случае имеет следующий вид:

    "key"   : "value1",
    "label" : "value2",
    "value" : "value3"

Значение по ключу value может быть как числовым, так и строковым. Однако currencyCode вместе со строковым значением использовать не получится. Что касается auxiliaryFields и secondaryFields, их может быть несколько, и стоит следить за длиной строк, которые в них используются.

Создание карты. Часть 2

Итак, картинки готовы, pass.json сформирован, осталось собрать все это вместе. Для этого заполним manifest.json (см. таблицу 1), куда необходимо включить все картинки и pass.json. Получается примерно так:

. . . . . . 
   "pass.json" = 303c753abc39aa732ec74643d6db28348fe8a823;
   "strip.png" = 736d01f84cb73d06e8a9932e43076d68f19461ff;
   "strip@2x.png" = 468fa7bc93e6b55342b56fda09bdce7c829d7d46;
. . . . . .

С этого момента менять ничего не нужно, поскольку SHA будет некорректным, в случае изменений необходимо сгенерировать SHA заново.

Далее нужно создать Pass Type ID в кабинете разработчика и сделать для него сертификат. Процедура должна быть более-менее знакомая, если ранее вы создавали, например, Provisioning профили.

Далее заходим в ключницу (Keychain) и экспортируем оттуда Apple Worldwide Developer Relation Certificate (WWDR) как .pem.

Оттуда же экспортируем созданный Pass Type ID как .p12. На этом этапе ключница попросит вас ввести пароль для сертификата. При этом пароль вводить необязательно.
Обратите внимание, что все дальнейшие действия надо производить в одной папке, где уже должны лежать manifest.json, pass.json и картинки.

Теперь необходимо сгенерировать подпись, которой будем подписывать архив. Для начала экспортируем Pass Type ID и ключ к нему как .pem.

openssl pkcs12 -in certificate.p12 -clcerts -nokeys -out passcertificate.pem -passin pass: your_password

и

openssl pkcs12 -in certificates.p12 -nocerts -out passkey.pem -passin pass: -passout pass:new_password

Теперь мы готовы к генерации подписи. Сделаем это командой:

openssl smime -binary -sign -certfile WWDR.pem -signer passcertificate.pem -inkey passkey.pem -in manifest.json -out signature -outform DER -passin pass:пароль_из_предыдущей_команды

Итак, у нас все готово, осталось только собрать архив, делаем это командой:

zip -r nameOfPass.pkpass manifest.json pass.json signature logo.png logo@2x.png logo@3x.png icon.png icon@2x.png icon@3x.png

Обращаю внимание, что тут должны быть перечислены все файлы, в которые вы хотите включить архив данных для карты(.pkpass).
В итоге мы получим .pkpass файл, который можно открывать на компьютере. Мы увидим превью карты, внешний вид которой может отличаться от вида на телефоне.
Все это можно сделать чуть проще. Apple предоставляет утилиту signpass (Apple Wallet sample meterials), которая берет на себя все подсчеты SHA (файл manifest.json можно не делать самостоятельно) и работу по созданию подписей. Чтобы ей воспользоваться, нужно собрать проект и поместить файл signpass в папку со всеми необходимыми ресурсами.

В целом структура должна выглядеть примерно так:

Далее выполняем команду:

./signpass -p wallet

Wallet — это название папки, в которой лежат все ресурсы. На выходе получаем файл wallet.pkpass. Его содержимое можно посмотреть, разархивировав wallet.pkpass.

unzip wallet.pkpass

Не исключено, что создание pkpass будет вынесено на бэкенд, в таком случае надо будет передать разработчикам WWDR, сертификат для Pass Type ID в виде .p12 и пароль от него.

Работа с платежными картами

Итак, в предыдущей главе мы рассмотрели основные опции приложения Wallet. Что это – уже понятно. Теперь разберемся с самой актуальной (на данный момент) опцией приложения. Речь идет о возможности оплачивать покупки с помощью Apple Pay и Wallet. Первое представляет собой “инновационную” систему оплаты, а второе хранит в своей базе все необходимые платежные реквизиты. Включая данные банковской карты. Однако сначала требуется добавить платежную карту в базу Wallet. Но здесь есть нюансы. Далеко не все банки в РФ поддерживают такую возможность.

Если ваша карта относится к поддерживаемым, то добавить ее в приложение Wallet – пара пустяков. Достаточно нажать на кнопку “Добавить платежную карту”. А дальше придется только следовать инструкциям. Все они предельно просты. Да еще и на русском языке. Так что проблем не возникнет. После добавления можно будет использовать сервис Apple Pay “на полную” в тех местах, где он поддерживается. Теперь стоит рассмотреть и другие возможности Wallet. Что это за приложение всего с одной возможностью? Примерно так подумали в Apple и… добавили больше функционала.

Добавление карты

Добавлять карты очень просто:

guard let passPath = Bundle.main.path(forResource: "wallet", ofType: "pkpass") else { return }
        let error: ErrorPointer = ErrorPointer(nilLiteral: ())
        guard let passData = NSData(contentsOfFile: passPath) else { return }
        let pass = PKPass(data: passData as Data, error: error)

        let passLibrary = PKPassLibrary()
        passLibrary.addPasses([pass]) { (status) in
            print(passLibrary.containsPass(pass))

        }

Однако, опять же, чаще .pkpass файл надо будет скачивать с вашего сервера.
Стоит отметить, что PassKit выдает довольно читаемые ошибки, поэтому можно легко понять, что именно было сделано не так.

Локация

Эти ключи отвечают за локацию, в пределах которой карта может быть использована.

Баркод

Самая важная часть карты. В него зашивают идентификационный номер карты (например, номер физической карты или номер билета). Важно чтобы сканер или любой другой инструмент умели считывать коды в нужной кодировке.

Заключение

Итак, мы разобрали приложение Apple Wallet. Что это такое? Это своеобразный электронный бумажник, в котором можно хранить электронные версии карт и с успехом использовать их. Бумажник умеет работать с платежными картами, бонусными картами, студенческими билетами, билетами в кино, на поезд и на самолет. Так гораздо удобнее, чем вечно таскать с собой туго набитый кошелек. Не стоит пренебрегать возможностями этого сервиса.

Заключение

В статье был рассмотрен процесс создания и дизайна карты, а также процесс интеграции c приложением и проблем, которые могут возникнуть. Я намерено не касался вопросов интеграции с веб-сервисами и обновления карт, и надеюсь сделать это в следующей статье.