PKPASS нельзя корректно обрабатывать как обычную картинку или офисный документ, которому достаточно поменять расширение. Apple Wallet работает с подписанным пакетом: внутри находятся данные пропуска, изображения, сведения для штрихкода, манифест и криптографическая подпись. При переводе PKPASS в PDF эти компоненты нужно прочитать и отрисовать либо сначала получить визуальную копию пропуска, а уже затем собрать из неё PDF. Поэтому рабочие способы заметно различаются: одни действительно разбирают исходный .pkpass, другие создают PDF из уже отображённого билета, третьи работают локально в браузере, а четвёртые передают файл веб-сервису.
Практические варианты делятся на несколько классов. Сначала рассмотрен PDF Commander: это не прямой парсер PKPASS, а способ для Windows, когда пропуск уже открыт на телефоне или в совместимом просмотрщике и требуется сохранить его визуальную копию в PDF. Pixillion даёт настольный интерфейс с последовательностью PKPASS→PDF, но поддержку конкретного .pkpass нужно сначала проверить на одном файле: общий перечень входных форматов программы PKPASS не содержит. Для локальной командной строки подходит D3SOX pkpass-to-pdf; в браузере работают WalletWallet и SysFenix с обработкой на устройстве, а также веб-сервисы Docpose и 101Convert. На iPhone, iPad и Android отдельный путь даёт OSS Card Wallet с импортом .pkpass и экспортом passbook в PDF.
Перед работой сохраните исходный PKPASS отдельно. PDF — статический документ: он не становится Apple Wallet pass, не получает будущие обновления от эмитента и сам по себе не подтверждает подлинность билета. Если в пропуске меняется выход на посадку, время, баланс, статус бронирования или другой динамический параметр, распечатанный или сохранённый PDF останется в состоянии на момент конвертации. Для поездок, мероприятий и пропускного режима исходный Wallet-pass должен оставаться основным экземпляром, а PDF — резервной копией, если правила эмитента допускают её использование.
Что именно превращается в PDF внутри файла PKPASS
Распространяемый Wallet-pass — подписанный пакет. Сначала формируется структура с pass.json, изображениями и локализациями, затем для файлов создаётся manifest.json с SHA-1-хешами, манифест подписывается отделённой подписью PKCS#7, после чего каталог упаковывается в ZIP и получает расширение .pkpass. Поэтому формулировка «зашифрованный ZIP» некорректна: штатный Wallet-pass подписан, но не должен быть архивом, защищённым паролем.
| Компонент | Что хранит | Что важно при создании PDF |
|---|---|---|
pass.json | Тип pass, организация, подписи полей, значения, цвета, сведения о barcode и другие данные | Прямой конвертер должен прочитать структуру и решить, какие поля и в каком порядке отрисовать |
logo.png, icon.png, strip.png и варианты плотности | Графическое оформление пропуска | Нельзя считать отдельную картинку готовым пропуском: большая часть текста и barcode может находиться не в PNG |
manifest.json | Список файлов и их контрольные хеши | Нужен для механизма целостности исходного pass, но обычно не отображается на странице PDF |
signature | Криптографическая подпись манифеста | Служит частью проверки исходного Wallet-pass; обычный PDF-конвертер не переносит эту роль в итоговый документ |
| папки локализаций | Переведённые строки и локализованные ресурсы | Конвертер может выбрать не ту локаль или показать меньше полей, поэтому готовый документ нужно сверять с Wallet |
Прямая и косвенная конвертация — это разные операции
Прямая конвертация начинается с исходного файла .pkpass. Инструмент распаковывает пакет, читает JSON, извлекает нужные изображения и формирует PDF. Так работают D3SOX pkpass-to-pdf, WalletWallet, SysFenix, Docpose и 101Convert. У Pixillion есть отдельный PKPASS→PDF-сценарий, но общий перечень входных форматов программы не содержит PKPASS, поэтому перед пакетной работой требуется тест одного файла. Между методами есть принципиальные различия: часть выполняет обработку локально, часть передаёт файл веб-сервису, а набор поддерживаемых barcode и сложных полей различается.
Косвенная конвертация начинается не с контейнера, а с уже отрисованного пропуска. Пользователь открывает pass в Apple Wallet или совместимом viewer, получает качественный снимок экрана и затем создаёт PDF из изображения. Именно так в этой инструкции используется PDF Commander. Этот подход предсказуем для визуальной копии: в PDF попадёт ровно то, что видно на изображении. Но он не извлекает скрытые поля с обратной стороны pass и не интерпретирует структуру pass.json.
Что обычно сохраняется, а что теряется
PDF хорошо подходит для фиксированного текста, логотипа и напечатанного barcode. Если конвертер отрисовал код без искажений, документ можно увеличить, архивировать, отправить на печать или приложить к другим бумагам. При этом итог не становится «тем же PKPASS в другом контейнере». Исчезает связь с механизмом Wallet, а обновления от эмитента не переносятся в уже созданный файл.
- Сохраняется визуальная информация, которую конкретный конвертер перенёс на страницу: название, дата, место, номер, логотип, поля билета и barcode.
- Не сохраняется поведение Wallet. PDF не меняет поля после обновления pass и не заменяет уведомления или автоматическую актуализацию.
- Не переносится статус оригинальной подписи Apple Wallet. В SysFenix подпись внутри PKPASS игнорируется, поэтому результат рендеринга не подтверждает подлинность исходного pass.
- Может измениться представление barcode. SysFenix формирует QR, PDF417, Aztec и Code 128 как соответствующие графические коды, тогда как D3SOX генерирует QR из извлечённых barcode-данных. Это важно, если контролирующая система ожидает конкретную символику.
- Могут потеряться дополнительные поля. Снимок экрана захватывает только видимую сторону; прямой парсер способен отрисовать больше данных, но только если реализовал чтение соответствующих полей.
Когда PDF действительно нужен
Наиболее понятные сценарии — резервная бумажная копия, архив для отчётности, передача видимого содержимого человеку без совместимого Wallet-приложения и объединение билета с другими документами. Для каждого из них сначала определите, нужна ли только внешняя сторона pass или полный набор полей. Если требуется юридически или организационно значимое подтверждение действительности билета, статический PDF сам по себе недостаточен: проверяющая сторона ориентируется на правила эмитента и действующий код, а не на факт наличия файла PDF.
Как быстро выбрать способ конвертации
| Способ | Платформа | Тип | Где обрабатывается PKPASS | Пакетная работа | Работа с barcode | Когда выбирать |
|---|---|---|---|---|---|---|
| PDF Commander | Windows | Косвенный: визуальная копия → PDF | Локально на компьютере | Можно собрать несколько изображений в один PDF | Barcode остаётся частью изображения; качество зависит от исходного снимка и масштаба | Когда pass уже отображён и нужен контролируемый PDF, который можно дополнительно редактировать |
| Pixillion | Windows, macOS | PKPASS → PDF с обязательным тестом входного файла | Локально | Пакетная обработка есть для поддерживаемых входов; сначала проверьте один PKPASS | Перечень символик для PKPASS не задан; результат нужно сканировать после конвертации | Для настольного GUI, если тестовый .pkpass успешно добавляется в программу |
| D3SOX pkpass-to-pdf | Windows, macOS, Linux при установленном Bun | Прямой CLI | Локально | Один путь к PKPASS передаётся за один стандартный вызов | Генерирует QR из barcode-данных | Для терминала, автоматизации и локальной работы без веб-загрузки |
| WalletWallet | Современный браузер | Прямой | Локально в браузере | Страница ориентирована на один PKPASS за операцию | Перерисовывает barcode payload как QR или 1D-код | Когда важна приватность и не нужна установка программы |
| SysFenix | Современный браузер | Прямой | Локально в браузере | Да, несколько PKPASS за один запуск | QR, PDF417, Aztec, Code 128; неизвестный формат выводится текстом | Для нескольких билетов и сохранения исходной символики распространённых barcode |
| Docpose | Браузер | Прямой серверный | На сервере сервиса | Без входа форма показывает до 2 файлов | Поддерживаемые символики отдельно не описаны | Для небольшой разовой задачи, когда допустима серверная загрузка |
| 101Convert | Браузер | Прямой веб-конвертер | Через веб-интерфейс; не используйте его как способ с гарантированной локальной обработкой только на устройстве | Форма показывает до 3 файлов, до 15 МБ каждый и до 45 МБ суммарно | Нужно проверять готовый PDF сканированием | Для работы без установки на компьютере или телефоне |
| OSS Card Wallet | iPhone, iPad, Android | Прямой мобильный экспорт | В мобильном приложении | Есть массовый экспорт выбранных карточек; отдельного лимита именно для PKPASS → PDF нет | Показывает passbook и barcode; после экспорта в PDF код требуется проверить | Когда исходный PKPASS находится на телефоне и нужен PDF без компьютера |
Выбор лучше начинать не с обещания «конвертировать за секунду», а с двух вопросов. Первый: можно ли передавать билет стороннему серверу? Если нет, остаются PDF Commander, Pixillion после проверки входного файла, D3SOX, WalletWallet и SysFenix. Второй: критично ли сохранить исходный тип barcode? SysFenix отдельно обрабатывает PDF417, Aztec и Code 128; D3SOX, напротив, формирует QR из извлечённых данных и потому не является эквивалентной заменой для каждого пропуска.
Если задача состоит только в том, чтобы получить печатную визуальную копию уже открытого билета, прямой парсер не обязателен. Тогда снимок отображённого pass плюс PDF Commander даёт наиболее контролируемый результат: пользователь сам видит, что именно попадёт на страницу. Если же нужно извлечь данные из сырого .pkpass, используйте прямой вариант и обязательно сравнивайте PDF с исходным pass.
Как сохранить PKPASS в PDF в Windows
PDF Commander : создать PDF из визуальной копии pass
PDF Commander открывает первый практический способ для Windows. Он используется не для разбора сырого .pkpass, а для создания PDF из уже отрисованной визуальной копии pass. Рабочий процесс двухэтапный: сначала получить качественное изображение билета в Wallet или совместимом просмотрщике, затем собрать из него PDF. Такой путь полезен для резервной копии, печати и дальнейшего оформления документа.
Подготовка. Откройте билет в Apple Wallet или совместимом viewer и выведите на экран сторону, где видны основные поля и barcode. Сделайте снимок без обрезки кода. Если важные сведения находятся на дополнительной стороне pass, сохраните её отдельным изображением. Не уменьшайте исходный снимок перед созданием PDF: исходное разрешение полезнее сохранить, а размер страницы настроить уже в документе.
Шаг 1. Откройте создание PDF из изображений
Запустите PDF Commander. На стартовом экране выберите «Создать PDF», затем вариант «PDF из изображений». В интерфейсе также доступен путь через меню «Файл» → «Создать» → «PDF из изображений». Это принципиально: исходником для этого способа служит PNG/JPG-снимок открытого pass, а не сам контейнер PKPASS.

Шаг 2. Добавьте снимок пропуска
В окне выбора файлов укажите изображение с отображённым pass и нажмите «Открыть». Если сохранены две стороны или несколько билетов, выделите все нужные изображения. Перед продолжением проверьте порядок: первая страница должна содержать основную сторону с идентификационными данными и barcode, а дополнительные листы — сведения, которые невозможно было уместить на первом снимке.

Шаг 3. Проверьте страницу до сохранения
После добавления не растягивайте изображение непропорционально. Для barcode важны геометрия модулей и контраст. Если код занимает небольшую часть страницы, разумнее оставить вокруг него свободное место, чем пытаться заполнить весь лист ценой деформации. При необходимости поверните страницу так, чтобы билет читался в естественной ориентации. Важно, чтобы в кадре оставались подписи полей, дата, номер, имя или маршрут — те сведения, по которым можно сверить PDF с Wallet.

Шаг 4. При необходимости добавьте или замените изображение
Для уже созданного документа используйте инструмент «Изображение» на панели редактора PDF Commander, затем выберите файл в стандартном окне Windows. Этот путь полезен, если основной pass уже находится в PDF, но нужно добавить отдельную страницу с дополнительной стороной, схемой или вторым билетом.

Шаг 5. Сохраните документ
Откройте «Файл» и выберите «Сохранить как…». Задайте понятное имя, например с датой и назначением билета. Исходный .pkpass не удаляйте и не заменяйте PDF-файлом: это два разных объекта с разной функциональностью.
Шаг 6. Проверьте barcode
Откройте сохранённый PDF в просмотрщике на компьютере и покажите код другому телефону. Сканирование следует выполнять с экрана при масштабе 100% и, если документ предназначен для бумаги, ещё раз после пробной печати. Если камера не распознаёт код, вернитесь к исходному снимку экрана: причиной часто оказывается слишком сильное уменьшение, размытие при масштабировании или обрезанная зона вокруг barcode.
Плюсы:
- визуальная копия полностью контролируется пользователем: в PDF попадает именно выбранное изображение;
- исходный билет не нужно отправлять в сторонний онлайн-конвертер;
- несколько снимков можно собрать в один PDF и расставить в нужном порядке;
- после создания документ остаётся в PDF-редакторе, где можно проверить страницы и добавить поясняющие элементы.
Минусы:
- этот сценарий в PDF Commander не использует прямой импорт
.pkpass; - качество barcode ограничено качеством снимка экрана;
- скрытые и обратные поля pass не попадут в PDF, если их не снять отдельно;
- динамические обновления Wallet не переносятся.
Когда выбрать другой способ. Если на компьютере есть только сырой файл .pkpass и нет корректно отрисованного pass, используйте WalletWallet или SysFenix; Pixillion имеет смысл пробовать только после успешного добавления одного тестового PKPASS. Если требуется автоматизация, удобнее D3SOX. Если приоритет — сохранение PDF417, Aztec или Code 128 как соответствующего типа кода, сначала рассмотрите SysFenix и затем обязательно протестируйте готовый результат.
Pixillion : настольный PKPASS→PDF с обязательным тестом поддержки
Pixillion работает на Windows и macOS и имеет отдельный рабочий сценарий PKPASS→PDF с обычным графическим интерфейсом: добавление файла, выбор выходной папки, PDF и запуск Convert. Однако общий список входных форматов Pixillion расширение PKPASS не содержит. Поэтому поддержку нельзя считать безусловной для любой установки: сначала добавьте один тестовый pass и переходите к пакетной обработке только после успешного чтения файла.
Шаг 1. Добавьте PKPASS
Откройте Pixillion и нажмите зелёную кнопку Add File(s) на основной панели. Для первой проверки выберите один PKPASS и нажмите Open. Файлы также можно перетащить в окно приложения. Если тестовый pass появился в списке без ошибки загрузки, добавьте остальные файлы и используйте пакетную обработку.

Шаг 2. Назначьте папку результата
В нижней части главного окна найдите поле Output Folder. Путь можно выбрать кнопкой Browse. Для билетов удобно создавать отдельную папку конвертации, чтобы PDF не смешивались с исходными .pkpass. Это также упрощает проверку соответствия имён и количества файлов после пакетной операции.

Шаг 3. Установите PDF как выходной формат
Откройте список Output Format и выберите PDF. Это отдельный обязательный шаг: добавление PKPASS само по себе ещё не задаёт формат результата. В интерфейсе Pixillion список находится в нижней части основного окна рядом с настройками выходной папки.

Шаг 4. Запустите конвертацию
Нажмите Convert в правой нижней части окна или используйте одноимённую команду основной панели. Если выделен один элемент, преобразуется он; для пакетной обработки выберите несколько файлов или запустите операцию для всего списка. Столбец состояния показывает ход обработки.

Шаг 5. Разберите ошибку по статусу
В Pixillion статусы Save failed и Load failed требуют разных действий. Save failed относится к сохранению результата: выберите другую доступную папку и повторите операцию. Load failed означает, что исходный файл не удалось прочитать; причиной может быть повреждение или фактически другой формат под неподходящим расширением. Для PKPASS это одновременно проверка совместимости конкретной установки: если заведомо рабочий Wallet-pass получает Load failed, не запускайте пакетную обработку и выберите другой метод.

Шаг 6. Проверьте результат, а не только статус Converted
Для PKPASS→PDF в Pixillion не задан отдельный перечень символик barcode. Поэтому успешный статус не заменяет визуальную и сканирующую проверку. Откройте PDF, сравните основные поля с Wallet и попробуйте считать код вторым устройством. Если на исходном pass был PDF417 или Aztec, убедитесь, что получившийся код имеет ожидаемую структуру и не был превращён в нечитабельное изображение.
Плюсы:
- есть понятная настольная последовательность Add File(s) → Output Folder → PDF → Convert;
- графический интерфейс не требует командной строки;
- можно добавить несколько файлов и выполнить пакетную конвертацию;
- работа идёт локально, без обязательной отправки билета веб-сервису;
- есть понятные статусы ошибок загрузки и сохранения.
Минусы:
- общий список входных форматов Pixillion не содержит PKPASS, поэтому совместимость нужно проверять на одном рабочем pass;
- для PKPASS не задан отдельный перечень поддерживаемых символик barcode;
- результат необходимо сверять с исходным pass, особенно для нестандартного оформления и локализованных полей;
- настольная программа требует установки и менее удобна, если исходный файл находится только на телефоне.
Локальная конвертация на macOS, Linux и Windows через D3SOX pkpass-to-pdf
D3SOX pkpass-to-pdf — небольшой открытый CLI-инструмент на TypeScript для Apple Wallet .pkpass. Он распаковывает пакет, читает организацию, описание, основные и дополнительные поля и barcode, добавляет логотип и метаданные, после чего формирует PDF. Инструмент использует Bun; Bun доступен на macOS, Linux и Windows, поэтому метод применим на всех трёх настольных системах.
Этот вариант стоит выбирать не из-за самой командной строки, а когда нужен локальный воспроизводимый процесс. В отличие от серверного конвертера, билет остаётся на компьютере. В отличие от графической программы, вызов легко повторить для другого файла или встроить в собственный сценарий. Важное ограничение: D3SOX генерирует QR code from the barcode data. Данные barcode извлекаются, но итоговая символика формируется как QR, даже если исходный pass использовал другой формат.
Подготовка
Установите Bun способом, подходящим вашей системе, и проверьте командой bun --version, что runtime доступен в терминале. В каталоге проекта выполните установку зависимостей:
bun installДля распаковки D3SOX использует jszip, для PDF — pdf-lib, для создания QR — qrcode, а для интерактивного ввода — prompts. Поэтому инструмент не делает снимок экрана: он программно извлекает данные из пакета и собирает новый документ.
Интерактивный режим
Для разовой операции запустите:
bun run startПосле запуска CLI запрашивает путь к .pkpass. Укажите файл и дождитесь завершения. PDF сохраняется в том же каталоге и получает то же базовое имя с расширением .pdf. Такой режим удобнее, если не хочется каждый раз печатать полный путь непосредственно в команде.
Прямой вызов с путём к файлу
Для повторяемой работы используйте команду:
bun run src/cli.ts path/to/your/pass.pkpassПуть можно заменить абсолютным или относительным путём к своему файлу. После выполнения проверьте, что рядом с исходным PKPASS появился одноимённый PDF.
Standalone-сборка
При необходимости можно собрать самостоятельный бинарный файл:
bun run buildПосле неё пример вызова выглядит так:
./pkpass-to-pdf path/to/your/pass.pkpassПреимущество сборки — для последующих запусков самого бинарника Bun уже не нужен как отдельный runtime. При этом сам процесс создания и использование готового файла остаются задачей пользователя: готовый бинарник нужно хранить вместе с понятной версией исходного проекта, если операция должна быть воспроизводимой.
Как проверить результат D3SOX
Сначала сравните организацию, описание и все видимые поля. Затем отдельно изучите barcode. Если исходный Wallet-pass показывает QR, проверка проста: отсканируйте QR из PDF и сравните значение с исходным. Если исходник использует PDF417, Aztec или Code 128, не воспринимайте QR в PDF как визуально эквивалентный код. Даже при одинаковой строке данных контрольная система может ожидать другую символику или иной формат полезной нагрузки. Для билета, где тип barcode критичен, используйте конвертер, который явно сохраняет соответствующий вид, например SysFenix.
Плюсы:
- специализированная работа с
.pkpass, а не универсальный шаблон «любой файл в PDF»; - локальная обработка без загрузки билета на сторонний сервер;
- одинаковый принцип запуска на Windows, macOS и Linux при поддерживаемой установке Bun;
- есть интерактивный режим, прямой CLI-вызов и standalone-сборка;
- исходный код открыт, а используемые библиотеки и последовательность обработки доступны для технического аудита.
Минусы:
- нужны терминал и первоначальная установка зависимостей;
- barcode выводится как QR; сохранение PDF417, Aztec или Code 128 в исходной символике этот инструмент не обеспечивает;
- пакетная обработка нескольких путей одной командой в обычном режиме не описана;
- для нетипичного pass результат всё равно требуется визуально сверять.
Онлайн-конвертеры PKPASS в PDF
Веб-инструменты нельзя объединять в одну категорию только потому, что они открываются в браузере. WalletWallet и SysFenix выполняют конвертацию на стороне клиента: исходный pass не отправляется на их сервер в рамках преобразования. Docpose, напротив, принимает файл на сервер и хранит загруженные данные до 24 часов, если пользователь не удалит их раньше. 101Convert также предоставляет веб-форму PKPASS→PDF, но политику обработки нужно оценивать отдельно от локальных инструментов.
WalletWallet: PDF формируется внутри браузера
WalletWallet использует специализированный интерфейс PKPASS to PDF Converter. В нём есть область Drop your .pkpass file here, выбор файла через браузер, состояние Converting…, затем Your PDF is ready и кнопка Download PDF. Исходный файл разбирается и рендерится в браузере, без загрузки PKPASS на сервер.
Как конвертировать PKPASS в WalletWallet
- Сохраните исходный
.pkpassкак отдельный файл на устройстве. - Откройте страницу WalletWallet PKPASS to PDF и перетащите pass в область загрузки либо выберите его через файловый диалог.
- Дождитесь сообщения Your PDF is ready.
- Откройте предварительный просмотр и сравните видимые поля с оригиналом.
- Нажмите Download PDF.
- Отсканируйте barcode из сохранённого PDF вторым устройством.
Браузер распаковывает пакет с JSZip, читает pass.json, декодирует изображения, повторно формирует barcode из payload и собирает одностраничный A4 PDF библиотекой jsPDF. Результат рассчитан на печатное представление основных данных, а не на пиксельное воспроизведение интерфейса Apple Wallet.
После первоначальной загрузки веб-страницы конвертация WalletWallet продолжает работать без сети: страницу можно оставить открытой, отключить интернет и затем обработать pass. Это полезный способ дополнительно исключить сетевую передачу конкретного билета.
Плюсы:
- сырой PKPASS не требуется отправлять серверу;
- не нужна установка настольного приложения;
- конвертер специально разбирает
pass.jsonи ресурсы PKPASS; - результат сразу ориентирован на печатную страницу A4;
- для базовой операции не требуется регистрация, водяной знак на готовый PDF не добавляется.
Минусы:
- страница ориентирована на один файл за операцию;
- макет намеренно не повторяет интерфейс Wallet один в один;
- barcode перерисовывается как QR или 1D-код; сохранение всех исходных символик Wallet-pass не гарантируется;
- PDF остаётся статической копией и не получает будущие изменения pass.
SysFenix: локальная обработка и четыре распространённых типа barcode
SysFenix также выполняет работу полностью в браузере и отдельно обрабатывает распространённые типы barcode и несколько файлов за один запуск. В интерфейсе есть область Drop your files here (.pkpass), кнопка Choose files и команда Convert PKPASS to PDF. Можно выбрать несколько pass одновременно.
Как конвертировать PKPASS в SysFenix
- Добавьте один или несколько файлов через Choose files либо перетащите их в область загрузки.
- Нажмите Convert PKPASS to PDF.
- Дождитесь построения документа.
- Скачайте результат. Один входной файл сохраняет базовое имя: например,
flight.pkpassпревращается вflight.pdf. Два и более pass объединяются вwallet-passes.pdf. - Перед печатью не уменьшайте документ командой Fit to page без необходимости: сам сервис рекомендует печатать в полном размере.
- Отсканируйте напечатанный barcode камерой телефона до поездки или мероприятия.
Сильная сторона SysFenix — отдельный механизм отрисовки распространённых штрихкодов. QR обрабатывается QR-кодировщиком, а PDF417, Aztec и Code 128 формируются библиотекой, поддерживающей эти символики. Для старых pass читается и прежнее одиночное поле barcode, а не только современный список. Если формат barcode не указан корректно, инструмент не угадывает тип, а выводит закодированные данные как текст. Такой отказ безопаснее, чем создание красивого, но неверного кода.
Сервис не проверяет криптографическую подпись. Он читает и визуализирует содержимое, но не утверждает, что pass действительно выпущен организацией, имя которой находится внутри. Если архив защищён паролем, SysFenix рассматривает это как признак нестандартного/перепакованного файла: штатный Apple Wallet pass подписан, но не шифруется паролем.
При пакетной операции есть практическая особенность: если один файл вызывает ошибку, повторите конвертацию по одному. Внутренний обработчик различает причины вроде отсутствующего pass.json или неверного JSON, тогда как внешний интерфейс может показать более общее сообщение. Последовательная обработка позволяет найти проблемный PKPASS.
Плюсы:
- локальная обработка исходного билета;
- можно выбрать несколько PKPASS и получить объединённый PDF;
- поддерживаются QR, PDF417, Aztec и Code 128;
- неизвестный barcode не подменяется предположением;
- в PDF выводятся поля и обратная сторона pass, а не только изображения архива.
Минусы:
- цифровая подпись исходного pass не валидируется;
- готовый PDF не обновляется вместе с Wallet-pass;
- ошибка одного файла при пакетной обработке удобнее диагностируется повторной обработкой по одному;
- итог всё равно нужно сканировать и сравнивать с оригиналом.
Docpose: серверная конвертация с небольшими гостевыми лимитами
Docpose имеет отдельный режим PKPASS→PDF. Без входа форма принимает до 2 файлов и до 1 МБ на файл; загруженные данные автоматически удаляются в течение 24 часов. Это принципиально отличается от WalletWallet и SysFenix: здесь pass передаётся сервису, поэтому билеты с персональными данными следует загружать только когда такая обработка допустима.
Как использовать Docpose
- Нажмите Select Files или перетащите PKPASS в область загрузки.
- Проверьте, что файл укладывается в гостевой лимит формы.
- В выходном формате выберите pdf.
- Нажмите Convert.
- После завершения сохраните получившийся PDF.
- Если использовался личный кабинет, при необходимости удалите загруженный файл вручную через раздел хранения, не дожидаясь автоматической очистки.
Для Docpose нет отдельного перечня символик barcode, которые воспроизводятся при PKPASS→PDF. Поэтому контроль должен включать не только открытие документа, но и реальное чтение кода. Не переносите на Docpose характеристики SysFenix: разные сервисы используют разные механизмы рендеринга.
Плюсы:
- есть отдельный маршрут PKPASS→PDF;
- не требуется устанавливать программу;
- форма прямо показывает текущие ограничения до загрузки;
- загрузки автоматически удаляются в пределах 24 часов.
Минусы:
- исходный pass отправляется внешнему сервису;
- гостевой лимит в 1 МБ может отсечь pass с тяжёлыми изображениями;
- поддержка конкретных barcode для этого преобразования не раскрыта;
- для нескольких крупных билетов удобнее локальный или настольный вариант.
101Convert: до трёх PKPASS через браузер
101Convert имеет отдельную форму Free online PKPASS to PDF converter. Она принимает до 3 файлов, каждый не более 15 МБ, при суммарном объёме до 45 МБ. Регистрация для базового преобразования не требуется.
Как использовать 101Convert
- Перетащите
.pkpassв область Drop up to 3 .PKPASS files here or click to browse либо откройте системный выбор файла. - Перед началом проверьте число и общий размер выбранных pass.
- Дождитесь обработки и появления результата.
- Сохраните PDF на устройство.
- Сравните текстовые поля и barcode с исходным Wallet-pass.
PKPASS — контейнер с JSON, изображениями и данными barcode, поэтому обычная печать произвольного файла не заменяет его рендеринг. На iPhone для pass доступно действие Share, когда распространение разрешено эмитентом. Универсальная команда Wallet → Print → Save PDF для любого pass не является штатным маршрутом, поэтому её не следует считать гарантированным системным способом.

Плюсы:
- специализированная страница именно для PKPASS→PDF;
- базовая форма работает без регистрации;
- лимиты числа и объёма файлов показаны непосредственно перед загрузкой;
- подходит для Windows, macOS, Linux и мобильного браузера, если разрешена веб-обработка.
Минусы:
- это не локальный настольный инструмент;
- нельзя автоматически считать любой созданный barcode пригодным для контроля — его нужно сканировать;
- три файла за операцию уступают SysFenix при более крупном наборе;
- советы о системной печати нельзя автоматически переносить на Apple Wallet: доступность Share и других действий зависит от конкретного pass.
Как перевести PKPASS в PDF на iPhone, iPad и Android
OSS Card Wallet: импорт .pkpass и экспорт passbook в PDF
OSS Card Wallet — мобильное приложение, а не сайт внутри браузера. Оно поддерживает Passbook, импорт из .pkpass, просмотр passbook и экспорт/отправку passbook как .pkpass или PDF. Приложение доступно на Android и на iPhone/iPad, поэтому один и тот же подход закрывает обе мобильные платформы без дублирования карточки.
Подпись команды импорта может различаться между экранами и платформами, поэтому здесь фиксируется только сам порядок действий. После добавления pass для PDF используется экран PDF Preview, а действие Export запускает экспорт выбранных карточек.
Шаг 1. Передайте PKPASS в OSS Card Wallet
Откройте исходный файл .pkpass на телефоне через системное меню выбора приложения или воспользуйтесь импортом passbook внутри OSS Card Wallet. После добавления откройте карточку и сравните её с оригиналом: особенно имя, дату, маршрут, место, номер и barcode.

Шаг 2. Проверьте barcode до экспорта
Не переходите сразу к PDF. Убедитесь, что приложение показывает сам barcode, а не только текстовый номер. Это отделяет проблему импорта PKPASS от проблемы дальнейшего экспорта в PDF: если код уже отсутствует на карточке, повторное создание PDF его не восстановит.

Шаг 3. Сформируйте PDF и откройте предварительный просмотр
Запустите экспорт passbook в PDF. Перед сохранением проверьте экран PDF Preview: страница должна содержать читаемый текст и barcode без обрезки. После этого нажмите Export и выберите доступное системное действие — сохранение или передачу файла.

Шаг 4. Проверьте PDF на другом экране
Откройте файл не только внутри того же приложения. Передайте его на компьютер или откройте другим PDF-viewer и отсканируйте код вторым устройством. Эта проверка выявляет ошибки масштаба, которые незаметны в preview на небольшом экране.
Плюсы:
- не нужен компьютер;
- приложение импортирует
.pkpassи экспортирует passbook в PDF; - доступно на iPhone/iPad и Android;
- приложение также умеет работать с изображениями, PDF и barcode, поэтому экспорт можно проверить в одном рабочем процессе.
Минусы:
- мобильный экран хуже подходит для детального сравнения длинных полей и сложной многостраничной верстки;
- подпись команды импорта может отличаться между платформами и экранами, поэтому ориентируйтесь на действие добавления passbook, а не на одно заранее заданное название;
- после экспорта barcode всё равно необходимо проверять внешним сканированием;
- наличие PDF не возвращает функции Apple Wallet.
Apple Wallet: как получить исходный pass или визуальную копию
Apple Wallet нужен здесь не как конвертер PDF, а как эталонное отображение pass. Откройте Wallet, выберите билет и используйте Share, если эта кнопка доступна. Отсутствие Share означает, что распространение данного pass через Wallet не разрешено эмитентом. Универсальной команды печати, доступной для любого Wallet-pass, нет.

Если Share доступен и передаёт сам .pkpass, его можно отправить на компьютер и использовать в D3SOX, WalletWallet, SysFenix, Docpose или 101Convert; Pixillion добавляйте в этот маршрут только после успешного теста одного pass. Если нужно зафиксировать внешний вид, сохраните качественный снимок экрана и обработайте его в PDF Commander. Путь «Wallet → Print → PDF» нельзя считать универсальной системной функцией для всех pass.
Как вручную разобрать PKPASS, если конвертер не принимает файл
Ручная распаковка полезна прежде всего как диагностика. Она позволяет убедиться, что перед вами действительно Wallet-pass, найти данные и понять, почему универсальный PDF-конвертер не справляется. Но распакованный набор PNG нельзя автоматически считать готовым билетом: Apple Wallet собирает представление из JSON и ресурсов, а barcode может существовать как строка данных, а не отдельная картинка.
1. Сделайте копию исходника
Не экспериментируйте с единственным экземпляром. Создайте копию файла и оставьте оригинальное расширение .pkpass нетронутым. Любые действия с переименованием выполняйте только над копией.
2. Откройте пакет как ZIP
Поскольку распространяемый pass упакован как ZIP, копию можно переименовать из ticket.pkpass в ticket.zip либо открыть архиватором напрямую, если он позволяет выбрать файл независимо от расширения. После распаковки ожидайте увидеть pass.json, manifest.json, signature и набор изображений. Отсутствие pass.json — сильный признак, что файл не является корректно собранным Wallet-pass.
3. Не путайте подпись с шифрованием
Стандартный pass содержит подпись, но не должен требовать пароль для распаковки. Если архиватор запрашивает пароль, это не штатное свойство Apple Wallet pass. Такой файл мог быть повторно упакован сторонним приложением или вообще не соответствовать формату.
4. Проверьте pass.json
В pass.json находятся данные, которые Wallet использует для отображения: организация, описание, цвета, поля и сведения barcode. Современные pass могут содержать список barcode, а старые — одиночное поле. Если логотипы извлекаются, а код не находится среди PNG, это нормально: механизм отрисовки должен сгенерировать barcode из его сообщения и формата.
5. Проверьте manifest.json
manifest.json содержит хеши файлов. Для ручной печати его данные не нужны как видимый элемент, но сам манифест объясняет, почему нельзя без последствий отредактировать изображения или JSON и назвать результат тем же действительным pass: подпись исходного пакета связана с содержимым манифеста.
6. Извлеките изображения только как ресурсы
logo.png, strip.png, thumbnail.png и другие изображения полезны для диагностики, но не отражают весь макет. Если просто объединить их в PDF, в документе могут отсутствовать имя пассажира, дата, место, номер билета и barcode. Такой результат — набор ресурсов, а не полноценная визуализация pass.
7. Выберите дальнейший путь
- Если важна визуальная резервная копия, откройте pass в совместимом Wallet/viewer, сделайте качественный снимок и соберите PDF в PDF Commander.
- Если структура выглядит корректно и нужен прямой разбор исходного файла, используйте WalletWallet или SysFenix; Pixillion пробуйте после успешного теста одного PKPASS.
- Если важен локальный разбор и приемлем терминал, используйте D3SOX.
- Если файл повреждён и не открывается даже как ZIP, попросите эмитента повторно выдать PKPASS вместо попыток восстанавливать билет по случайным фрагментам.
Почему универсальный PDF-конвертер часто бесполезен
Страницы XPS→PDF, PPS→PDF, PUB→PDF, PAGES→PDF и универсальные «Convert to PDF» не подходят только из-за наличия слова PDF в названии. Сервис должен явно принимать .pkpass, либо пользователь должен сначала превратить pass в обычное изображение или документ. Иначе универсальный конвертер получает ZIP-контейнер, для которого у него нет правила отрисовки.
Как проверить PDF после конвертации PKPASS
Самая опасная ошибка — считать задачу законченной, когда файл просто открывается. Для билета ценность создают не расширение .pdf и не красивый логотип, а корректные данные и считываемый barcode. Контроль лучше выполнять одинаково независимо от выбранного конвертера.
Проверка 1. Сопоставьте основные поля
Положите рядом исходный pass и PDF. Сверьте имя или идентификатор владельца, дату, время, маршрут, место, номер заказа или билета, организацию и специальные пометки. Если часть информации доступна на обратной стороне Wallet-pass, убедитесь, что прямой механизм отрисовки вывел её в PDF либо сохраните отдельную страницу при визуальном способе.
Проверка 2. Определите тип barcode
QR выглядит квадратной матрицей. PDF417 — широкий многострочный код, часто встречающийся на посадочных талонах. Aztec — квадратная матрица с характерным центральным узором. Code 128 — линейный штрихкод. Если после конвертации внешний вид неожиданно сменился, выясните причину. Для D3SOX это может быть следствием предусмотренной генерации QR из извлечённых данных; для других инструментов неожиданная смена может означать упрощённый механизм отрисовки.
Проверка 3. Отсканируйте с другого устройства
Не используйте только визуальную оценку. Откройте PDF на экране ноутбука или планшета и наведите камеру второго телефона. Сканирование должно происходить без экстремального увеличения и без ручного растягивания страницы. Если код распознаётся только после увеличения в несколько раз, при печати на бумаге он может оказаться слишком маленьким.
Проверка 4. Сравните содержимое кода
Если у вас есть безопасный локальный decoder, сравните payload исходного pass и PDF. Совпадение строки особенно важно для инструментов, которые повторно генерируют barcode. Не публикуйте payload в общедоступных онлайн-декодерах без необходимости: он может содержать идентификатор билета, ссылку, номер бронирования или другой чувствительный токен.
Проверка 5. Сделайте пробную печать
Для бумажного резерва проверка с экрана недостаточна. Печатайте без чрезмерного уменьшения. SysFenix прямо рекомендует полный размер вместо автоматической подгонки, потому что уменьшение barcode ухудшает считывание. После печати снова отсканируйте код. Контролируйте резкость чёрных и белых элементов и отсутствие обрезки тихой зоны вокруг кода.
Проверка 6. Проверьте количество страниц
При пакетной конвертации число страниц должно соответствовать ожидаемой структуре. SysFenix объединяет несколько pass в один wallet-passes.pdf; PDF Commander может собрать несколько снимков экрана в один документ; Pixillion обрабатывает несколько читаемых входов пакетно. Не перепутайте семейные билеты и не отправляйте одному человеку PDF с чужим пропуском из того же набора.
Проверка 7. Откройте PDF другим просмотрщиком
Файл, который отображается только в приложении, где был создан, нельзя считать надёжным резервом. Откройте его системным viewer, браузером или другим PDF-reader. Это выявит повреждённый экспорт и проблемы встраивания ресурсов.
Проверка 8. Зафиксируйте момент создания
Для динамических билетов полезно включать дату создания PDF в имя файла или отдельную заметку рядом с документом. Это не делает копию актуальной, но предотвращает ситуацию, когда старый PDF принимают за свежий. Перед использованием сравните его с текущим Wallet-pass.
Проверка 9. Не удаляйте PKPASS
Исходник содержит больше функциональной информации, чем статическая страница. Даже идеальный PDF не является причиной удалять оригинал, пока билет, купон или пропуск ещё нужен.
Проверка 10. Учитывайте правила эмитента
Считываемый barcode не гарантирует, что организация обязана принять распечатку. Некоторые системы могут требовать действующий Wallet-pass, динамический код, удостоверение личности или собственное приложение. PDF создаёт техническую копию, а не изменяет правила допуска.
Конфиденциальность и подлинность: какой конвертер безопаснее для билета
PKPASS может содержать имя, маршрут, место, номер участника программы лояльности, идентификатор бронирования и barcode payload. Для некоторых билетов сочетание фамилии и номера брони уже чувствительно. Поэтому вопрос «где обрабатывается файл» должен стоять раньше удобства интерфейса.
Локальные варианты
- PDF Commander работает уже с визуальной копией локально на компьютере; сырой PKPASS в сторонний сервис не передаётся.
- Pixillion — настольная программа; если тестовый PKPASS успешно читается, дальнейшая конвертация выполняется локально без веб-загрузки файла.
- D3SOX запускается локально через Bun и разбирает pass на компьютере.
- WalletWallet распаковывает и рендерит PKPASS локально в браузере, не отправляя исходный файл на сервер.
- SysFenix выполняет обработку PKPASS локально в браузере без отправки pass на сервер.
Для наиболее чувствительных пропусков предпочтителен один из этих вариантов. У WalletWallet есть дополнительная практическая проверка: после полной загрузки страницы можно отключить сеть и выполнить конвертацию — операция продолжает работать внутри уже загруженной страницы.
Серверные варианты
Docpose принимает файл через веб-форму и хранит загруженные данные до 24 часов с возможностью более раннего удаления в личном разделе. Передача серверу — осознанный компромисс ради отсутствия установки. 101Convert также является веб-сервисом; для билетов с чувствительными данными локальный вариант проще оценивать, поскольку исходник не покидает устройство.
Почему PDF не подтверждает подлинность исходного pass
Подлинность Wallet-pass связана с его подписанным пакетом. Обычный PDF после рендеринга — новый документ. Даже если он визуально повторяет билет и содержит правильный barcode, он не становится Apple Wallet bundle с исходной подписью. В SysFenix подпись игнорируется, а проверка того, кем создан pass, не выполняется.
Из этого следует практическое правило: не используйте PDF как самостоятельное доказательство происхождения pass. Если нужно убедиться, что билет выпущен нужной организацией, используйте оригинальный Wallet-pass и проверку в системе эмитента.
Что делать с серверной копией
- не загружайте билеты в сервисы, которые не заявляют работу с PKPASS и не объясняют обработку;
- не используйте случайный «конвертер» только потому, что на его странице перечислены похожие расширения;
- после завершения удаляйте файл вручную, если сервис предоставляет такую функцию;
- не публикуйте barcode или его payload в скриншотах, форумах и открытых облачных ссылках;
- храните PDF и оригинал там же, где хранили бы сам билет или документ с персональными данными.
Типичные ошибки при переводе PKPASS в PDF и способы исправления
Конвертер пишет, что формат не поддерживается
Сначала убедитесь, что выбран именно специализированный PKPASS→PDF-инструмент. Большая часть универсальных PDF-сервисов работает с DOCX, JPG, PNG, XPS, PPTX и другими документами, но ничего не знает о Wallet bundle. Если используется Pixillion, повторно добавьте исходный файл через Add File(s). Сообщение Load failed в этой программе также может означать повреждённый файл или другой формат под неправильным расширением.
Файл переименовали из ZIP в PKPASS, но он не работает
Одного имени недостаточно. Валидный pass имеет определённую структуру и подпись. Если в случайном ZIP нет корректного pass.json, манифеста, подписи и необходимых ресурсов, переименование не превращает архив в Wallet-pass. Попросите эмитента повторно выдать исходный файл.
Архиватор просит пароль
Штатный PKPASS подписан, но не является password-protected ZIP. SysFenix специально отслеживает encrypted entries и считает такой пакет нестандартным. Не пытайтесь подбирать пароль как обязательную часть «расшифровки Wallet»: сначала выясните, кто и чем повторно упаковал файл.
После распаковки виден логотип, но нет билета
Это ожидаемо. PNG-файлы — только ресурсы. Поля билета находятся в JSON, а barcode часто нужно построить из сообщения и формата. Для полноценного PDF используйте механизм отрисовки, а не простое объединение картинок.
В PDF пропал barcode
Сравните два этапа. Если pass корректно открывается в Wallet, но в PDF код отсутствует, проблема в механизме отрисовки. Попробуйте SysFenix, который явно поддерживает четыре распространённых символики. Если barcode отсутствует уже в просмотрщике, проверьте сам pass.json и происхождение файла.
Barcode виден, но не сканируется
Не увеличивайте резкость фильтрами и не пересохраняйте снимок экрана в формат с сильными потерями. Для способа через PDF Commander лучше исходный PNG-снимок экрана, чем многократно пережатый JPEG. Для SysFenix печатайте в полном размере. Для любого варианта проверьте код с экрана и затем с бумаги.
После D3SOX вместо PDF417 появился QR
D3SOX генерирует QR code из barcode data. Если контролирующая система принимает только исходную символику, такой результат не подходит, даже если payload совпадает. Для сохранения PDF417 используйте рендерер с поддержкой этой символики, например SysFenix.
В PDF нет информации с обратной стороны
При способе со снимком экрана это происходит потому, что сохранена только лицевая сторона. Откройте дополнительную информацию pass и сделайте отдельный снимок, затем добавьте его второй страницей в PDF Commander. У прямых конвертеров отсутствие back fields означает ограничение конкретного механизма отрисовки; для сравнения используйте SysFenix или D3SOX, которые выводят дополнительные поля pass.
Локализованный pass показывает не тот язык
PKPASS может содержать отдельные папки локализации. Не каждый сторонний механизм отрисовки повторяет выбор языка Apple Wallet. Сравните текст с оригиналом. Если локаль критична, визуальная копия из Wallet через PDF Commander надёжнее передаст именно тот вариант, который отображается пользователю.
Docpose не принимает файл из-за размера
Гостевая форма текущей PKPASS→PDF-страницы ограничена 1 МБ на файл и двумя файлами. Не пытайтесь обходить это переименованием или сжатием содержимого pass: изменение пакета может нарушить его структуру и подпись. Выберите локальный инструмент либо сервис с более подходящим лимитом.
101Convert не принимает большой набор
Форма показывает до трёх файлов, максимум 15 МБ на каждый и 45 МБ суммарно. Для семейного набора из большего числа pass рациональнее SysFenix с пакетным объединением или настольная обработка.
SysFenix останавливает пакетную обработку на одном файле
Повторите обработку по одному. Это помогает найти проблемный PKPASS. Для валидного набора затем можно собрать рабочие файлы вместе, исключив повреждённый.
На iPhone нет кнопки Share
Доступность Share зависит от эмитента конкретного pass. Отсутствие кнопки не является поломкой Wallet. Проверьте приложение или сайт организации, которая выдала билет. Для резервной визуальной копии остаётся способ со снимком экрана; для прямой конвертации нужен сам файл .pkpass.
Получился PDF, но его нельзя добавить обратно в Apple Wallet
Это нормальное следствие преобразования. PDF не содержит подписанную структуру Wallet-pass. Обратная задача PDF→PKPASS требует создания нового pass с JSON, ресурсами и подписью; простое переименование PDF в .pkpass не работает.
Перепутаны PKPASS, PAS, PPS, PAGES или XPS
Похожие расширения не означают родство форматов. PAS обычно относится к исходному коду Pascal, PPS — к презентациям PowerPoint, PAGES — к документам Apple Pages, XPS — к фиксированному формату документов Microsoft. Инструкция PKPASS→PDF к ним неприменима.
Какой способ выбрать для конкретной задачи
| Сценарий | Рекомендуемый подход | Почему | Что проверить |
|---|---|---|---|
| Нужен Windows GUI и PDF из уже открытого билета | PDF Commander | Позволяет собрать PDF из одного или нескольких качественных снимков экрана и при необходимости отредактировать документ | Разрешение изображения, полноту полей и barcode после сохранения |
| Нужен настольный GUI для PKPASS→PDF | Pixillion после теста одного файла | Есть последовательность PKPASS→PDF и пакетный режим для читаемых входов; общий список форматов PKPASS не содержит | Успешное чтение тестового pass, barcode, локализованные поля и статус конвертации |
| Нельзя отправлять билет в интернет, установка программы нежелательна | WalletWallet | Конвертация выполняется в загруженной браузерной странице локально | Предварительный просмотр и считывание barcode |
| Нужны PDF417, Aztec или Code 128 и несколько pass | SysFenix | Обрабатывает эти типы и поддерживает несколько файлов за один запуск | Сканирование каждого кода и порядок объединённых pass |
| Нужен воспроизводимый CLI | D3SOX pkpass-to-pdf | Локальный TypeScript/Bun-инструмент с прямым командным вызовом | Не изменилась ли символика barcode на QR |
| Есть только телефон | OSS Card Wallet | Импортирует .pkpass и экспортирует passbook в PDF на iOS/Android | PDF Preview, Export и последующее сканирование |
| Нужен веб-сервис без установки и файл небольшой | Docpose | Специализированная серверная страница PKPASS→PDF | Лимит 1 МБ без входа, приватность и barcode |
| Нужно до трёх файлов через браузер | 101Convert | Форма принимает до 3 PKPASS по 15 МБ и до 45 МБ суммарно | Результат каждого файла и считывание barcode |
Для разовой резервной печати
Если билет уже открыт в Wallet и важна именно внешняя сторона, визуальная копия плюс PDF Commander проще прямого разбора пакета. Перед печатью дважды проверьте barcode: на экране и на бумаге. Если нужно сохранить дополнительные поля, сделайте отдельную страницу.
Для регулярной работы с несколькими pass
Для нескольких pass в первую очередь удобен SysFenix: он объединяет файлы в wallet-passes.pdf и сохраняет QR, PDF417, Aztec и Code 128 как соответствующие типы. Pixillion используйте для настольного GUI только после успешного чтения одного тестового PKPASS; затем можно переходить к пакетной обработке.
Для максимальной приватности
Исключите серверную загрузку. Подойдут PDF Commander, Pixillion, D3SOX, WalletWallet и SysFenix. Между ними выбор зависит от исходника: снимок экрана, исходный PKPASS, GUI, CLI или работа только в браузере.
Для Linux
D3SOX даёт локальный вариант для Linux с открытым исходным кодом и понятной командой запуска. Bun работает на Linux. Если терминал нежелателен, WalletWallet или SysFenix запускаются в современном браузере и не требуют отдельной настольной версии.
Для телефона
OSS Card Wallet предпочтительнее случайного мобильного сайта, потому что приложение импортирует .pkpass и экспортирует или отправляет passbook как PDF. На iPhone Apple Wallet остаётся эталоном для просмотра и Share исходного pass, когда эмитент разрешил эту функцию.
Практические сценарии: от билета до проверенного PDF
Сценарий 1. Посадочный талон открыт на iPhone, а нужен бумажный резерв
Сначала откройте посадочный талон в Apple Wallet и убедитесь, что он актуален. Сохраните качественную визуальную копию лицевой стороны. Если требуется информация из Pass Details или с обратной стороны, сохраните второй кадр. Перенесите изображения на Windows-компьютер, откройте PDF Commander, выберите «Создать PDF» → «PDF из изображений» и добавьте оба кадра. Перед печатью сохраните PDF, откройте его другим viewer и отсканируйте barcode вторым телефоном. Этот сценарий не зависит от того, удалось ли получить сам файл PKPASS.
Сценарий 2. В папке на Windows лежат несколько исходных .pkpass
Если нужен настольный графический интерфейс, сначала добавьте в Pixillion один PKPASS кнопкой Add File(s). Если файл читается, назначьте Output Folder, выберите PDF в Output Format, добавьте остальные pass и запустите Convert. После пакетной обработки не ограничивайтесь зелёными статусами: откройте каждый PDF и сопоставьте с соответствующим pass. Если тестовый PKPASS не читается, используйте SysFenix или D3SOX вместо попыток массовой загрузки.
Сценарий 3. Билет содержит персональные данные, устанавливать ПО нельзя
Используйте WalletWallet или SysFenix. Оба выполняют обработку PKPASS локально в браузере. Для WalletWallet можно заранее загрузить страницу, отключить сеть и только после этого добавить файл: конвертация продолжает работать после первоначальной загрузки интерфейса. Для нескольких билетов удобнее SysFenix.
Сценарий 4. Исходный код — PDF417 на авиабилете
Не выбирайте инструмент только по факту появления квадратного QR. Если нужно сохранить символику, используйте SysFenix: он формирует PDF417 как PDF417. После экспорта в PDF распечатайте страницу в полном размере и проверьте код. D3SOX для такого сценария хуже, потому что генерирует QR из barcode data.
Сценарий 5. Нужно автоматизировать локальную конвертацию
Подготовьте D3SOX и Bun. Для каждого файла запускайте bun run src/cli.ts path/to/pass.pkpass и собирайте список созданных PDF. Если процесс становится массовым, отдельно зафиксируйте проверку типов barcode: автоматизация не должна незаметно превращать разные символики в QR без контроля.
Сценарий 6. PKPASS находится на Android
Импортируйте его в OSS Card Wallet, откройте passbook, проверьте barcode, затем сформируйте PDF и оцените PDF Preview. После Export передайте PDF на другое устройство для независимой проверки. Если мобильный экспорт показывает не все поля, перенесите исходный PKPASS на компьютер и сравните результат с SysFenix или D3SOX; Pixillion используйте только после успешного теста входного файла.
Сценарий 7. Онлайн-конвертер не принимает файл
Проверьте лимит и структуру пакета. У Docpose без входа действует небольшой предел 1 МБ; у 101Convert — до 15 МБ на файл. Если размер допустим, откройте копию как ZIP и найдите pass.json. Если структура присутствует, попробуйте локальный специализированный механизм отрисовки. Если структуры нет, не продолжайте цепочку из случайных конвертеров: нужен новый исходник.
Частые вопросы о PKPASS и PDF
Можно ли просто переименовать .pkpass в .pdf?
Нет. PKPASS — ZIP-пакет с JSON, изображениями, manifest и подписью, а PDF имеет другую структуру. Переименование меняет только имя, но не содержимое. Нужен механизм отрисовки или промежуточная визуальная копия.
Почему PKPASS открывается архиватором?
Потому что распространяемый pass после подписи упаковывается как ZIP и получает расширение .pkpass. Это штатное устройство формата. Возможность распаковать файл не означает, что можно редактировать содержимое и сохранить исходную валидность подписи.
Сохраняется ли цифровая подпись Apple Wallet в PDF?
Нет в функциональном смысле Wallet. Подпись относится к исходному пакету и его манифесту. Новый PDF — отдельный документ. SysFenix, например, прямо игнорирует подпись при рендеринге и не проверяет подлинность pass.
Можно ли удалить исходный PKPASS после конвертации?
Не рекомендуется, пока билет или пропуск ещё нужен. PDF не получает обновления и может содержать меньше данных. Оригинал должен оставаться основным экземпляром, а PDF — резервной статической копией.
Можно ли добавить получившийся PDF обратно в Apple Wallet?
Нет простым импортом. Apple Wallet принимает pass в своей подписанной структуре. Чтобы создать новый PKPASS из PDF, нужно заново сформировать данные pass, ресурсы, manifest и корректную подпись; это обратная задача, а не восстановление исходника переименованием.
Какой сервис лучше сохраняет PDF417 и Aztec?
SysFenix формирует QR, PDF417, Aztec и Code 128 как соответствующие типы. Для Pixillion, Docpose и 101Convert отдельного перечня barcode для PKPASS→PDF нет, поэтому результат нужно проверять. D3SOX генерирует QR и не сохраняет исходную символику каждого кода.
Почему после распаковки нет картинки с QR-кодом?
Потому что barcode часто хранится как данные в JSON. Wallet или конвертер генерирует графический код при отрисовке. В архиве могут лежать логотипы и другие ресурсы, но не готовая картинка всего билета.
Можно ли конвертировать PKPASS полностью без интернета?
Да. D3SOX и PDF Commander работают локально на компьютере; Pixillion тоже выполняет локальную конвертацию, если конкретный PKPASS успешно читается программой. WalletWallet после загрузки страницы может продолжить преобразование при отключённой сети, а SysFenix выполняет обработку внутри браузера без отправки pass на сервер.
Нужно ли использовать Apple Wallet перед прямой конвертацией?
Нет, если у вас уже есть исходный файл .pkpass и выбран прямой конвертер. Wallet полезен как эталон для сравнения результата и как способ передать pass через Share, когда эмитент разрешает это действие.
Почему Share в Wallet не равен экспорту в PDF?
Share предназначен для передачи поддерживаемого pass другим пользователям или приложениям. Он помогает получить или передать исходный PKPASS, но не превращает pass в PDF и не считается самостоятельным PDF-конвертером.
Что важнее: внешний вид PDF или считывание кода?
Для билета важнее корректные данные и работающий barcode. Идеальное совпадение цветов с Wallet не компенсирует нечитабельный код. Сначала проверяйте поля и сканирование, затем оформление.
Что делать, если исходный pass обновляется?
Создавайте резервную PDF-копию как можно ближе к моменту использования и всё равно сравнивайте её с текущим Wallet-pass. Уже сохранённый PDF не изменится автоматически после переноса рейса, смены выхода или обновления другого поля.
Почему универсальный конвертер документов не видит PKPASS?
Потому что PKPASS не является обычной страницей или изображением. Поддержка PDF, DOCX, XPS, PNG и других форматов не подразумевает парсер пакета Apple Wallet. Нужна явная поддержка .pkpass либо предварительный рендеринг в изображение.
Итог: какой конвертер PKPASS в PDF выбрать
Для Windows, когда билет уже отображён и нужен редактируемый резервный PDF, используйте PDF Commander: сохраните качественный снимок pass, создайте PDF из изображений, не деформируйте barcode и обязательно проверьте его вторым устройством. Если нужен настольный GUI для сырого .pkpass, сначала добавьте один тестовый файл в Pixillion; при успешном чтении используйте Add File(s), Output Folder, Output Format: PDF и Convert. Если тестовый pass не читается, переходите к SysFenix или D3SOX.
Если файл нельзя передавать серверу, а устанавливать GUI не хочется, выбирайте WalletWallet или SysFenix. SysFenix особенно полезен для PDF417, Aztec и Code 128 и умеет объединять несколько pass. Для командной строки на Windows, macOS и Linux подходит D3SOX, но его QR-рендеринг нужно учитывать до использования результата. На iPhone, iPad и Android задачу напрямую закрывает OSS Card Wallet с импортом .pkpass и экспортом passbook в PDF.
Docpose и 101Convert оставляйте для случаев, когда работа через внешний веб-сервис приемлема и файл укладывается в лимиты формы. Для Docpose это означает серверную загрузку с хранением до 24 часов; 101Convert не следует приравнивать к WalletWallet и SysFenix, где обработка явно выполняется локально в браузере. Независимо от метода храните оригинальный PKPASS, сверяйте текст, проверяйте barcode с экрана и с пробной печати и не воспринимайте PDF как замену подписи и обновляемой логики Apple Wallet.