# Wallet

Como funciona a exportação da Carteira, de conectar até resolver problemas.

## Conectar

Aperte “Conectar” ao lado da Carteira na tela Início do Exporter e depois “Abrir Pasta Passes”. O painel abre na pasta onde o macOS guarda os seus passes, `~/Library/Passes`: aperte “Selecionar esta pasta”. Depois escolha para onde vão os arquivos e aperte “Usar esta pasta”.

Pegue a pasta Passes em si, não a pasta `Cards` dentro dela. O Exporter lê os passes de `Cards`, e o `passes23.sqlite` ao lado para uma coisa só: o dia em que um passe foi assinado, a única data que muitos passes antigos têm.

## Onde os arquivos ficam

Um arquivo Markdown por passe, numa única pasta, com o nome da data e do que o passe é: `2026-09-17 united airlines SFO-EWR.md`, `2026-09-11 the sf database meetup.md`. Um passe sem data nenhuma leva só o nome (`apple store.md`). Uma pasta direto na sua pasta de usuário, como `~/Documents`, ganha uma pasta `wallet-export` dentro; uma mais funda, como `~/Documents/wallet`, é usada como está.

## O que é exportado

Todo passe marcado no cartão: cartões de embarque, passagens de trem e de ônibus, ingressos, cartões de loja, cupons e passes genéricos. As pílulas só filtram a lista: passes (todos), voos (incluindo trem e ônibus), eventos e cartões.

Dois passes que dariam o mesmo nome de arquivo ganham cada um um sufixo curto do seu id, então nenhum sobrescreve o outro. Desmarcar um passe remove o arquivo dele na próxima sincronização; marcar de novo traz de volta.

## Formato

Sempre Markdown: o front matter do passe, um título e uma linha com o onde e o quando, depois os campos exatamente como o cartão os mostra, o verso sob um título `Back` e o número do código de barras.

## O arquivo

| chave | contém |
| --- | --- |
| `title`, `id` | como o passe se chama, e o id que a Wallet dá a ele |
| `kind` | `flight`, `transit`, `event`, `card` ou `other` |
| `date`, `date_source` | quando o passe vale, e se essa é a data do emissor, o vencimento ou o dia da assinatura |
| `organization`, `pass_type` | o emissor e o identificador de tipo do passe |
| `expires`, `voided` | quando vence, e se a Wallet marcou o passe como usado |
| `coordinates` | o ponto do local, quando o passe leva um |

Uma seção `Details` leva os campos tipados da Apple que o cartão já não mostra: terminais, o portão de chegada, fusos horários, a classe tarifária. Uma seção `Where` nomeia o local. Um código de barras cuja mensagem é binária diz isso, em vez de escrever caracteres de controle no arquivo.

```markdown
---
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
```

## Datas, mesmo sem data

Um passe é arquivado no dia dele, no fuso que o emissor escreveu: um voo que sai de Denver às 23:25 é aquele dia em Denver, não o seguinte onde você está lendo. Ingressos antigos muitas vezes não têm data nenhuma; esses são arquivados no dia da assinatura, e `date_source: signed` diz isso no arquivo.

## Passes em outros idiomas

Um passe pode guardar as palavras dele num arquivo `pass.strings` dentro do pacote e deixar só as chaves no passe. O Exporter resolve tudo no idioma do seu Mac, então um ingresso mostra o nome do evento e não `EVENT_NAME`.

## Grátis e desbloqueado

Os seus 20 passes mais recentes são grátis, e continuam assim. Desbloquear a Carteira exporta o resto ([preços](https://exporter.dev/pricing)).

## Sincronização e ressincronização completa

Depois do primeiro “Sincronizar agora”, o Exporter reescreve o arquivo de um passe quando aquele passe muda, no máximo uma vez por minuto. Portões, assentos e horários de embarque mudam no dia da viagem, e cada mudança reescreve só o arquivo daquele passe.

“Ressincronização completa” pergunta antes, depois remove os arquivos de passes que o Exporter escreveu e escreve de novo cada passe marcado. Todo o resto na pasta fica.

## Problemas e soluções

- “nenhum passe nessa pasta (escolha a pasta Passes na sua biblioteca)”: aperte “Conectar” de novo e selecione a pasta em que o painel abre
- falta um passe: ele está desmarcado no cartão, ou os 20 grátis acabaram. Desbloqueie a Carteira e aperte “Sincronizar agora”
- um passe está sem data no nome: ele não tem nenhuma e o banco de dados da Wallet não pôde ser lido. Conecte `~/Library/Passes` em vez de `Cards`
- os números dos cartões não estão lá: eles não estão no Mac. A Wallet guarda os cartões de pagamento no Secure Element, e o Exporter nunca os vê

## Related

- [Carteira](https://exporter.dev/pt-br/wallet): Cada passe como um arquivo Markdown
- [Primeiros passos](https://exporter.dev/pt-br/docs/getting-started): Instalar, conectar, primeira exportação
- [Servidor MCP](https://exporter.dev/pt-br/docs/mcp): Conecte o Claude e outros agentes

---

human version: https://exporter.dev/pt-br/docs/wallet
every page: https://exporter.dev/llms.txt