Wallet

Kết nối

Bấm “Kết nối” bên cạnh Ví trên trang chính của Exporter, rồi “Mở thư mục Passes”. Bảng chọn mở ra trong thư mục nơi macOS giữ các thẻ của bạn, ~/Library/Passes: bấm “Chọn thư mục này”. Sau đó chọn nơi lưu tệp và bấm “Dùng thư mục này”.

Hãy lấy chính thư mục Passes, không phải thư mục Cards bên trong. Exporter đọc các thẻ từ Cards, còn passes23.sqlite bên cạnh chỉ vì một điều: ngày thẻ được ký, cũng là ngày duy nhất mà nhiều thẻ cũ có.

Tệp nằm ở đâu

Mỗi thẻ một tệp Markdown, trong cùng một thư mục, đặt tên theo ngày và theo loại thẻ: 2026-09-17 united airlines SFO-EWR.md, 2026-09-11 the sf database meetup.md. Thẻ hoàn toàn không có ngày thì chỉ mang tên của nó (apple store.md). Thư mục nằm ngay trong thư mục cá nhân, như ~/Documents, sẽ có thêm thư mục wallet-export bên trong; thư mục sâu hơn, như ~/Documents/wallet, được dùng nguyên như vậy.

Những gì được xuất

Mọi thẻ được đánh dấu trên thẻ nguồn: thẻ lên máy bay, vé tàu và vé xe khách, vé sự kiện, thẻ cửa hàng, phiếu giảm giá và thẻ dạng chung. Các nút lọc chỉ lọc danh sách: thẻ (tất cả), chuyến bay (gồm cả tàu và xe khách), sự kiện và thẻ cửa hàng.

Hai thẻ cho ra cùng một tên tệp sẽ mỗi thẻ nhận một hậu tố ngắn lấy từ id, nên không thẻ nào ghi đè thẻ nào. Bỏ đánh dấu một thẻ sẽ xóa tệp của nó ở lần đồng bộ sau; đánh dấu lại thì tệp quay về.

Định dạng

Luôn là Markdown: front matter của thẻ, một tiêu đề và một dòng cho biết ở đâu và khi nào, rồi đến các trường đúng như thẻ hiển thị, mặt sau của thẻ dưới tiêu đề Back, và số của mã vạch.

Tệp

khóa	chứa
title, id	thẻ tên là gì, và id mà Ví đặt cho nó
kind	flight, transit, event, card hoặc other
date, date_source	khi nào thẻ có giá trị, và đó là ngày của bên phát hành, ngày hết hạn hay ngày ký
organization, pass_type	bên phát hành và mã định danh loại thẻ của họ
expires, voided	khi nào hết hạn, và Ví đã đánh dấu thẻ là đã dùng hay chưa
coordinates	tọa độ địa điểm, khi thẻ có mang

Mục Details mang các trường có kiểu của Apple mà thẻ chưa hiển thị: nhà ga, cửa đến, múi giờ, hạng vé. Mục Where nêu tên địa điểm. Mã vạch có nội dung nhị phân sẽ nói rõ điều đó thay vì ghi ký tự điều khiển vào tệp.

---
title: "United Airlines SFO-EWR"
kind: flight
date: 2026-09-17T18:20:00
date_source: relevant
organization: "United Airlines"
---
# United Airlines SFO-EWR

San Francisco (SFO) → Newark (EWR) · 17 Sep 2026

- FLIGHT: UA 274
- GATE: F19
- SEAT: 34D

## Back

- CONFIRMATION: GGCLMQ

Ngày, kể cả khi không có

Thẻ được xếp theo ngày của chính nó, trong múi giờ mà bên phát hành ghi: chuyến bay rời Denver lúc 23:25 là ngày đó ở Denver, không phải ngày hôm sau nơi bạn đang đọc. Vé sự kiện cũ thường không có ngày nào cả; những thẻ đó được xếp theo ngày ký, và date_source: signed nói rõ điều đó trong tệp.

Thẻ bằng ngôn ngữ khác

Một thẻ có thể giữ chữ của nó trong tệp pass.strings bên trong gói và chỉ để lại các khóa trong thẻ. Exporter phân giải chúng theo ngôn ngữ máy Mac của bạn, nên vé hiện tên sự kiện chứ không phải EVENT_NAME.

Miễn phí và mở khóa

20 thẻ mới nhất của bạn là miễn phí, và vẫn luôn miễn phí. Mở khóa Ví sẽ xuất phần còn lại (giá).

Đồng bộ và đồng bộ lại toàn bộ

Sau lần “Đồng bộ ngay” đầu tiên, Exporter chỉ ghi lại tệp của một thẻ khi thẻ đó thay đổi, nhiều nhất mỗi phút một lần. Cửa ra, chỗ ngồi và giờ lên máy bay thay đổi trong ngày bạn đi, và mỗi thay đổi chỉ ghi lại tệp của riêng thẻ đó.

“Đồng bộ lại toàn bộ” sẽ hỏi trước, rồi xóa các tệp thẻ mà Exporter đã ghi và ghi lại mọi thẻ được đánh dấu. Mọi thứ khác trong thư mục vẫn giữ nguyên.

Sự cố và cách khắc phục

• “không có thẻ nào trong thư mục đó (hãy chọn thư mục Passes trong thư viện của bạn)”: bấm “Kết nối” lần nữa và chọn thư mục mà bảng chọn mở ra
• thiếu một thẻ: nó bị bỏ đánh dấu trên thẻ nguồn, hoặc 20 thẻ miễn phí đã dùng hết. Hãy mở khóa Ví rồi bấm “Đồng bộ ngay”
• một thẻ không có ngày trong tên: thẻ không mang ngày nào, và cơ sở dữ liệu của Ví cũng không đọc được. Hãy kết nối chính ~/Library/Passes thay vì Cards
• không thấy số thẻ ngân hàng: chúng hoàn toàn không nằm trên máy Mac. Ví giữ thẻ thanh toán trong Secure Element, và Exporter không bao giờ thấy chúng