# Uso pessoal: leia seus próprios dados com Meu Pluggy

Se você é uma pessoa que deseja ler **suas próprias** contas bancárias com código — um script de finanças pessoais, uma planilha, um aplicativo que só você usa — o caminho é **Meu Pluggy** mais o **conector MeuPluggy**. É gratuito, não precisa de diligência prévia e não expira com o teste. É apenas para uso pessoal (até 5 conexões, sem uso comercial).

Empresas que estão construindo um produto para seus usuários seguem a integração regular em vez disso ([Início rápido](/docs/quickstart)) e falam com [Vendas](/docs/get-started/contact).

O guia oficial do Meu Pluggy está em [meu.pluggy.ai/api-guide](https://meu.pluggy.ai/api-guide). Esta página mostra os mesmos quatro passos com as telas do Dashboard do Pluggy.

## Passo 1 — Conecte seus bancos no Meu Pluggy

Inscreva-se em [meu.pluggy.ai](https://meu.pluggy.ai) e conecte seus bancos lá. É aqui que cada banco é autorizado (CPF, o aplicativo do banco, aprovação). **Cada banco é autorizado separadamente**, e um banco que você adicionar depois precisa de sua própria autorização.

## Passo 2 — Adicione o conector MeuPluggy no Dashboard

1. Faça login no [Dashboard do Pluggy](https://dashboard.pluggy.ai) **com a mesma conta** que você usa no Meu Pluggy.
2. Se você usar uma seleção de conector personalizada, certifique-se de que **MeuPluggy** está ativado: **Customização → Conectores**, pesquise `MeuPluggy` e abra a aba **Conectores Diretos** do grupo *Pessoal* ([como](/docs/guides/dashboard-connectors#1-choose-which-connectors-pluggy-connect-shows)).
3. Abra **Aplicações → sua aplicação → Demo** e clique em **Conectar Conta**.
4. No widget, escolha **MeuPluggy** — não seu banco, e não o Sandbox — e faça login com sua conta do Meu Pluggy.

![Escolhendo o conector MeuPluggy no Pluggy Connect](/docs/images/dashboard/meupluggy-connector.png)

Cada banco que você conectou no Meu Pluggy se torna um **item** nesta aplicação. Esses itens refletem a conexão do Meu Pluggy: eles refletem cada atualização automaticamente (Meu Pluggy atualiza a cada 24 horas), não podem ser atualizados manualmente e enviam webhooks como qualquer item.

<Callout variant="warning" title="O erro mais comum">
Se o Dashboard pedir seu CPF e uma aprovação do banco novamente, você escolheu o conector próprio do banco em vez de **MeuPluggy**. Volte e escolha MeuPluggy.
</Callout>

## Passo 3 — Copie o itemId e suas credenciais

- **itemId:** na mesma página **Demo**, clique no item em **Itens Conectados** e copie seu id ([como](/docs/guides/dashboard-connectors#3-find-the-itemid)). Guarde-o — `GET /v2/items` não está disponível para contas do Meu Pluggy.
- **Client ID / Client Secret:** o Client ID está em **Aplicações**, na linha da sua aplicação. O Client Secret é mostrado apenas uma vez, quando é gerado — se você não o armazenou, gere um novo na página da aplicação ([como](/docs/guides/dashboard-connectors#4-client-id-and-client-secret)).

## Passo 4 — Leia seus dados

```bash
# 1. Troque suas credenciais por uma chave de API
curl -X POST https://api.pluggy.ai/auth \
  -H "Content-Type: application/json" \
  -d '{"clientId": "<client id>", "clientSecret": "<client secret>"}'
# → { "apiKey": "..." }

# 2. Liste as contas de uma conexão
curl "https://api.pluggy.ai/accounts?itemId=<item id>" \
  -H "X-API-KEY: <api key>"

# 3. Transações de uma conta (seu id vem do passo 2)
curl "https://api.pluggy.ai/transactions?accountId=<account id>" \
  -H "X-API-KEY: <api key>"
```

Os SDKs ([Node, Python e mais](/docs/developer-tools/server-sdks)) fazem as mesmas chamadas.

## A autorização expira após um ano

Quando você faz login no Meu Pluggy no Passo 2, você autoriza sua aplicação a ler as conexões que você tem lá. Essa autorização é o que os itens MeuPluggy leem através dela, e **dura um ano** a partir do momento em que você a concede. Cada conexão bancária dentro do Meu Pluggy mantém seu próprio consentimento com o banco; esta é separada e fica acima delas.

Você pode ver quando termina no próprio item: [GET /items/\{id\}](/reference/items-retrieve) retorna isso como `consentExpiresAt`.

### O que acontece quando expira

- **As leituras param.** Contas, transações e as outras listas desse item voltam vazias.
- **A próxima atualização falha com um erro de login.** O item muda para `LOGIN_ERROR` com o código `USER_AUTHORIZATION_EXPIRED`, e o webhook `item/error` é acionado. Se você escuta webhooks, esse é seu sinal.

Até que essa próxima atualização ocorra, o item ainda pode mostrar seu último status — `UPDATED`, sem erro — enquanto as leituras voltam vazias. Verifique `consentExpiresAt`: uma leitura vazia com uma data passada significa que a autorização expirou, não que suas conexões bancárias pararam de sincronizar.

### Como renová-la

Repita o Passo 2: abra **Aplicações → sua aplicação → Demo**, clique em **Conectar Conta**, escolha **MeuPluggy** e faça login com sua conta do Meu Pluggy. Conceder isso inicia um novo período de um ano.

Uma atualização acionada pela API ou pela sincronização automática não pode renová-la, porque ninguém está lá para fazer login: termina em `USER_AUTHORIZATION_EXPIRED`, como acima.

<Callout variant="warning" title="Não assuma o mesmo itemId">
Após autorizar novamente, verifique em qual item seus dados estão antes de continuar lendo. Se você armazenar transações do seu lado, reconcilie-as por seus próprios ids em vez de assumir que o item manteve seu id.
</Callout>

Excluir sua conta do Meu Pluggy encerra a autorização imediatamente.

## Testando sem dados reais

Para tentar o fluxo sem suas próprias contas, use o conector **Sandbox** com suas [credenciais de teste](/docs/guides/sandbox). Sua conexão do Meu Pluggy é dados reais, nunca um sandbox.

## Perguntas

Para um problema com sua conta ou uma de suas conexões, escreva para [meu-suporte@pluggy.ai](mailto:meu-suporte@pluggy.ai) do e-mail da sua conta do Meu Pluggy. Perguntas sobre uso pessoal vão para o mesmo endereço.