Как подписать карты в wallet
Управление картами, используемыми в Apple Pay
Изменение настроенной по умолчанию карты
Первая добавленная в Wallet карта выбирается для использования по умолчанию. Если вы добавили несколько карт и хотите изменить карту по умолчанию, выполните следующие действия.
iPhone или iPad
На устройстве iPhone можно также открыть приложение Wallet, коснуться карты и, удерживая ее, перетащить в начало списка карт.
Apple Watch
Модели компьютеров Mac с Touch ID
Перейдите в меню «Системные настройки» > «Wallet и Apple Pay». Выберите новую карту во всплывающем меню «Карта по умолчанию».
Обновление платежной и контактной информации
Узнайте, как изменять платежную информацию и адрес доставки для карт, используемых в Apple Pay. Сведения о просмотре и изменении платежной и контактной информации для карт Apple Card 4 приведены на этой странице.
iPhone или iPad
Модели компьютеров Mac с Touch ID
Несмотря на то что номер карты или дату окончания срока ее действия изменить невозможно, такие данные должны обновиться автоматически при получении новой карты. Если эмитент карты не поддерживает обновления, может потребоваться удалить карту, а затем добавить ее снова.
Удаление карты
При необходимости можно удалить карту с устройства. Сведения о процедуре закрытия счета для карт Apple Card 4 приведены на этой странице. Apple Cash 3 : чтобы закрыть счет Apple Cash или отключить Apple Cash на определенном устройстве, выполните следующие действия.
iPhone или iPad
Apple Watch
Можно также нажать значок Wallet на экране «Домой» часов Apple Watch, нажать нужную карту и удерживать ее, а затем нажать кнопку «Удалить».
Модели компьютеров Mac с Touch ID
Чтобы удалить карту, которая используется на компьютере Mac, перейдите в меню «Системные настройки» > «Wallet и Apple Pay», выберите нужную карту и нажмите значок минуса (–).
Управление картами магазинов или бонусными картами
Если для карты магазина включен параметр «Автоматический выбор», такая карта будет предлагаться при оплате в соответствующем магазине вместо используемой по умолчанию карты. Если для бонусной карты включен параметр «Автоматический выбор», в соответствующем магазине при использовании Apple Pay будет отображаться информация о бонусах.
При добавлении карты магазина или бонусной карты в Wallet может отображаться запрос на автоматический выбор карты. Чтобы включить или отключить параметр «Автоматический выбор», выполните следующие действия.
Помощь при потере или краже устройства
Для использования Apple Pay необходимо авторизовать каждую покупку по кредитной, дебетовой или предоплаченной карте с помощью Face ID, Touch ID или пароля. На Apple Watch при включенном режиме «Распознавание запястья» нужно вводить пароль каждый раз, когда часы надеваются на руку. Такие функции помогают предотвратить доступ других пользователей к Apple Pay на вашем устройстве iPhone, iPad, Apple Watch или компьютере Mac.
Чтобы приостановить или навсегда отключить возможность оплаты с помощью Apple Pay с устройства, перейдите на страницу идентификатора Apple ID или воспользуйтесь приложением «Найти iPhone». Войдите в систему на странице учетной записи Apple ID и выберите свое устройство. На открывшейся странице со сведениями перейдите к разделу Apple Pay и нажмите «Удалить» или «Удалить все». В Apple Pay можно приостановить обслуживание карт либо полностью удалить их, даже если устройство находится в автономном режиме и не подключено к сотовой сети или сети Wi-Fi.
Можно также приостановить обслуживание карт в Apple Pay или удалить их, просто позвонив эмитенту карты. Дополнительные сведения о действиях в случае потери или кражи iPhone см. в этой статье.
Дополнительная информация
Информация о продуктах, произведенных не компанией Apple, или о независимых веб-сайтах, неподконтрольных и не тестируемых компанией Apple, не носит рекомендательного или одобрительного характера. Компания Apple не несет никакой ответственности за выбор, функциональность и использование веб-сайтов или продукции сторонних производителей. Компания Apple также не несет ответственности за точность или достоверность данных, размещенных на веб-сайтах сторонних производителей. Обратитесь к поставщику за дополнительной информацией.
Добавление и использование посадочных талонов, билетов и других карт в Apple Wallet
С помощью приложения Wallet можно добавлять и использовать курортные карты, посадочные талоны, билеты в кино, купоны, бонусные карты и многое другое. Вы также можете поделиться некоторыми абонементами и билетами.
Как добавить посадочный талон, билет или другой талон в Apple Wallet на iPhone
Если вы не видите вариант добавления посадочного талона, билета или другого абонемента в приложение Wallet, обратитесь к продавцу или компании, выпустившей его, чтобы убедиться, что он поддерживает использование карт в приложении Wallet.
Когда вы добавляете посадочный талон, билет или другой талон в приложение Wallet на iPhone, вы автоматически добавляете его в приложение Wallet на сопряженных часах Apple Watch.
Использование посадочного талона, билета или другого талона в Apple Wallet
После добавления посадочного талона, билета или другого абонемента в приложение Wallet их можно использовать на iPhone или Apple Watch.
Как использовать посадочный талон, билет или другой талон на iPhone
Как использовать посадочный талон, билет или другой талон на Apple Watch
Возможно, вам потребуется разблокировать устройство, чтобы показать карту или билет перед сканированием или касанием.
Как поделиться картой или билетом в Apple Wallet
Некоторыми абонементами и билетами в приложении Wallet можно поделиться с другими пользователями iPhone или Apple Watch.
Если значок общего доступа не отображается, это значит, что продавец или компания, выпустившая абонемент или билет, не включила общий доступ в приложении Wallet. Проверьте в приложении или на веб-сайте, есть ли у них возможность поделиться картой или билетом.
Информация о продуктах, произведенных не компанией Apple, или о независимых веб-сайтах, неподконтрольных и не тестируемых компанией Apple, не носит рекомендательного или одобрительного характера. Компания Apple не несет никакой ответственности за выбор, функциональность и использование веб-сайтов или продукции сторонних производителей. Компания Apple также не несет ответственности за точность или достоверность данных, размещенных на веб-сайтах сторонних производителей. Обратитесь к поставщику за дополнительной информацией.
Как переименовать карту в apple pay
После добавления карточки в кошелек, можно заменить карту по умолчанию, обновить информацию, либо удалить карту. 1
Управление вашей карты работает по-разному в зависимости от устройства вы используете. 2
Заменить карту по умолчанию
Первая карта, которую вы добавляете в кошельке карты по умолчанию. Если вы добавить больше карт, и хотите изменить настройки по умолчанию карты, выполните следующие действия.
iPhone или iPad
На вашем iPhone, вы также можете открыть бумажник, коснитесь и удерживайте карту, затем перетащите его в передней части вашей карты.
Apple Часы
Модели Mac с сенсорным ID
Перейдите в Системные настройки > бумажник и Apple платить. Выбрать новую карту из умолчанию всплывающее меню.
Человека к человеку платежей с Apple Pay и Яблоко наличными недоступны на macOS. 3
Обновите свою платежную и контактную информацию
Узнайте, как обновить платежную информацию и данные доставки на карты, которые вы используете с Apple платить.
iPhone или iPad
Модели Mac с сенсорным ID
Хотя вы не можете изменить свой номер карты или срок годности, он должен обновиться автоматически, когда вы получаете новую карту. В случае, если эмитент не поддерживает обновления, вам может понадобиться, чтобы удалить карту, а затем добавить его снова.
Удалить карту
Если вам нужно, вы можете удалить карту из вашего устройства. Для Apple, наличные деньги, 3 Используйте следующие шаги, чтобы закрыть ваш Apple денежного счета или выключить Яблоко наличные на определенном устройстве.
iPhone или iPad
Apple Часы
Или коснитесь элемента кошелек на главном экране вашего Apple наблюдать, коснитесь карты, прижмите его, а затем коснитесь удалить.
Модели Mac с сенсорным ID
Чтобы удалить карты, которые вы используете на вашем компьютере, перейдите в Системные настройки > кошелек и платить Apple, нажмите на карты, которые вы хотите удалить, затем нажмите кнопку минус ( – ), чтобы удалить карты.
Управлять вашим магазином или скидочные карты
Если вы включите автоматический выбор в магазине карты, магазин карты будут представлены вместо вашей карты по умолчанию, когда вы платите в соответствующем магазине. Если вы включите автоматический выбор на карты, ваши данные награды будут представлены на связанного магазина, когда с помощью Apple платить.
При добавлении карточки магазина или награды карты на кошелек, вам может быть предложено, если вы хотите, чтобы карта выбирается автоматически. Чтобы включить автоматический выбор вкл или выкл:
Вам помочь, если ваше устройство потеряно или украдено
Чтобы использовать Apple, платить, вам необходимо авторизоваться каждой кредитной, дебетовой или предоплаченной карты купить С лицо удостоверение, сенсорный ID, и пароль. Или на Apple наблюдать, когда распознавание запястья, вы должны ввести пароль каждый раз, когда вы поставить на вашем Apple наблюдать. Эти функции помогают предотвратить других людей от использования Apple, платное на вашем iPhone, iPad и Apple наблюдать, или Mac.
Вы также можете позвонить своему эмитента заморозить или удалить ваши карты от Apple платные. Узнайте больше о Что делать, если ваш iPhone будет потерян или украден.
Apple Wallet. Что это такое и как интегрировать в него свою карту
Принято считать, что Wallet – не самый популярный сервис в СНГ. Но уже во втором проекте подряд заказчик ставит задачу «Сделать интеграцию с Wallet». Поэтому я решил написать эту статью, чтобы рассказать о сервисе в целом и показать, как интегрировать в него свой продукт.
Что такое Wallet? Он позволяет держать в телефоне различного вида карты (билеты, скидочные карты и т.п.), облегчая жизнь пользователям продукта. Более того, есть возможность актуализировать информацию о карте посредством push-уведомлений, но это тема для отдельной статьи. Но если у вас есть карта/билет/абонемент, которые можно интегрировать в телефон, то для этого есть решение! Как это сделать – читайте ниже.
Структура карты
Файл | Назначение |
---|---|
background.png | Фоновая картинка для карты. |
footer.png | Картинка рядом со штрихкодом |
icon.png | Иконка для уведомлений и писем |
logo.png | Логотип карточки. Отображается слева сверху |
manifest.json | Реестр всех включанымх файлов |
signature | PKCS7 подпись |
pass.json | Внешний вид и информация на карте |
strip.png | Картинка, находящаяся сзади основного описания карточки |
thumbnail.png | Дополнительная картинка (уточнить) |
Существуют следующие типы карт:
Рассмотрим схематично внешний вид разных карт. Картинки лучше называть так, как это указано в таблице выше.
Посадочный билет
Купон
Билет на событие
Общая карта
Скидочная карта
Структура pass.json
Обязательные поля. Содержат Pass Type ID, Team ID, название организации и т.п.
Ключи для связанных приложений. Нужны для отображения приложений, которые нужно «ассоциировать» с картой.
Ключи «срока годности» карточки.
Ключи актуальности. Например, координаты местности, где карта может быть использована, или начало события, для которого она предназначена.
Ключ стиля. В начале статьи были перечислены 5 видов карт для Wallet. Каждому из них соответствует свой стиль. Такой ключ должен быть строго один.
Ключи визуального оформления карты. Помимо очевидного, содержат в себе информацию о штрихкоде, отображаемом на карте.
Ключи web-сервисов. Вы можете использовать web-сервисы для взаимодействия с картой, например, автоматически ее обновлять.
NFC-ключи. Содержат дополнительную информацию для Apple Pay транзакции.
Теперь обо всем подробнее.
Обязательные поля
description | String. Локализуемое | Краткое описание карты. Локализуемое. |
formatVersion | Int | Версия формата файла. Значение должно быть 1. |
String. Локализуемое | Название организации, которая выдает карты. | |
String | Pass Type ID и кабинете разработчика. | |
String | Серийный номер отдельной карты | |
String | Team ID команды разработчика |
Ключи для связанных приложений
[Int] | Опционально. ID приложений, ассоциированных с картой. Берется всегда первое, совместимое с текущим устройством. |
String | URL, который передается в приложение при открытии |
Ключи стиля
[JSON] | Основная информация о карте. |
[JSON] | Второстепенная информация. |
[JSON] | Поля для дополнительной информации. Опциональное |
[JSON] | Заголовок карты. Отображается даже в том случае, когда карты видны списком. |
[JSON] | Основная информация о карте. |
String | Тип транспорта для карт-билетов. Может принимать следующие значения: PKTransitTypeAir, PKTransitTypeBoat, PKTransitTypeBu`, PKTransitTypeGeneric, `PKTransitTypeTrain`. |
[JSON] | Массив полей, отвечающий за обратную сторону карты |
JSON в данном случае имеет следующий вид:
Значение по ключу value может быть как числовым, так и строковым. Однако currencyCode вместе со строковым значением использовать не получится. Что касается auxiliaryFields и secondaryFields, их может быть несколько, и стоит следить за длиной строк, которые в них используются.
Ключи визуального оформления
[JSON] | Информация для баркода (см. ниже). |
color as string | Цвет фона.(#fa32e4) |
color as string | Цвет лейблов со значениями |
String | Опционально для билетов на события и билетов на транспорт. Карты с одинаковым стилем ― passTypeIdentifier и groupingIdentifier ― будут группироваться |
color as string | Текст лейблов с названиями полей |
Localizable string | Текст, отображаемый рядом с логотипом |
Баркод
Самая важная часть карты. В него зашивают идентификационный номер карты (например, номер физической карты или номер билета). Важно чтобы сканер или любой другой инструмент умели считывать коды в нужной кодировке.
String | Опциональный текст, отображаемый рядом с баркодом в том случае, если баркод не считывается. |
String | Формат баркода. Может принимать значения: PKBarcodeFormatQR, PKBarcodeFormatPDF417, PKBarcodeFormatAztec, PKBarcodeFormatCode128 |
String | Код или номер карты, зашифрованный в баркод. |
String | Кодировка сообщения. Обычно iso-8859-1 |
Локация
Эти ключи отвечают за локацию, в пределах которой карта может быть использована.
String | Опциональный текст, отображаемый рядом с баркодом в том случае, если баркод не считывается. |
Долгота | Широта |
Double | Широта |
String | Опциональный текст, который отображается на экране блокировки в тот момент, когда пользователь входит в радиус действия карты. |
Оборотная сторона
На оборотной информационной части можно разместить дополнительную информацию: условия использования, политику автообновления, контактные данные и ссылку на приложение, к которому относится карта. На рисунке представлено соответствие полей в pass.json и внешнего вида обратной стороны карты. Если в value-поле есть ссылки, номера телефона и т.п., они подсветятся автоматически.
Создание карты. Часть 2
Итак, картинки готовы, pass.json сформирован, осталось собрать все это вместе. Для этого заполним manifest.json (см. таблицу 1), куда необходимо включить все картинки и pass.json. Получается примерно так:
С этого момента менять ничего не нужно, поскольку SHA будет некорректным, в случае изменений необходимо сгенерировать SHA заново.
Далее нужно создать Pass Type ID в кабинете разработчика и сделать для него сертификат. Процедура должна быть более-менее знакомая, если ранее вы создавали, например, Provisioning профили.
Теперь мы готовы к генерации подписи. Сделаем это командой:
Итак, у нас все готово, осталось только собрать архив, делаем это командой:
В целом структура должна выглядеть примерно так:
Далее выполняем команду:
Wallet — это название папки, в которой лежат все ресурсы. На выходе получаем файл wallet.pkpass. Его содержимое можно посмотреть, разархивировав wallet.pkpass.
Интеграция с приложением
Для того чтобы приложение имело возможность добавлять карты в Wallet, необходимо включить эту возможность в App ID и также включить эту возможность в Capabilities в проекте.
Это необходимо для полноценной корректной работы с Wallet. В противном случае не получится считывать карты с Wallet и, например, не будет возможности понять, добавлена наша карта или нет. Также важно отметить, что team id в pass.json должен совпадать c team id, либо придется добавлять их вручную в entitlements и это может исправить ситуацию, но это я не проверял.
Добавление карты
Добавлять карты очень просто:
Получение информации о добавленных картах
Чтобы получить информацию о картах, имеющихся в Wallet и относящихся к вашему приложению, необходимо обратиться к объекту PKPassLibrary.
Таким образом, можно понять, добавлена карта или нет, а также обновить интерфейс. Кроме того, через PKPassLibrary карты можно обновлять и удалять. Обновлять карты можно и через веб-сервисы, но в этой статье мы не будем рассматривать такой вариант.
Проверка на уникальность
Тестирование
Apple предоставляет примеры pkpass для разных типов, можно ориентироваться на них.
Apple Wallet samples
Чтобы увидеть то, как выглядит карта, можно, добавить pkpass в проект (см. «Добавление карты»). Процесс добавления/удаления уже рассмотрен выше, осталось только напомнить, что приложение не будет видеть уже добавленные карты, если карта для Wallet создавалась на одном аккаунте разработчика, а сама разработка велась с другого аккаунта (актуально для аутсорс-компаний). При этом добавлять карты можно без проблем.
Проверить, корректно ли закодирована информация в штрихкоде, можно с помощью любого сканера QR-кодов. И точно необходимо проверить корректность работы с настоящим сканером.
Заключение
В статье был рассмотрен процесс создания и дизайна карты, а также процесс интеграции c приложением и проблем, которые могут возникнуть. Я намерено не касался вопросов интеграции с веб-сервисами и обновления карт, и надеюсь сделать это в следующей статье.
Используемые материалы:
Отдельное спасибо mehdzor за аккаунт разработчика для тестов.