> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Usar o DICT com o Pix Lerian

> Gerencie chaves Pix, reivindicações, MED 2.0, marcadores de fraude e VSync em uma integração de teste Pix Lerian v1.0.0.

O DICT gerencia o diretório de chaves Pix e os fluxos de disputa relacionados. Use a API pública para as ações do cliente; o plugin coordena as chamadas ao provedor e o estado local.

## Registrar e resolver uma chave

1. Crie uma entrada com [Criar entrada](/pt/reference/interfaces/pix-lerian/dict/create-entry). Envie o escopo da conta, o motivo obrigatório e os cabeçalhos de idempotência.
2. Salve o identificador da entrada e leia-a com [Obter entrada](/pt/reference/interfaces/pix-lerian/dict/get-entry).
3. Resolva uma chave com [Consultar chave](/pt/reference/interfaces/pix-lerian/dict/lookup-key) antes de um pagamento baseado em chave ou use [Verificar existência de chaves](/pt/reference/interfaces/pix-lerian/dict/check-keys-existence) para uma verificação em lote.
4. Atualize ou exclua somente pelas rotas públicas do ciclo de vida da entrada. Não trate uma consulta como prova de titularidade de outra conta.

A criação e a atualização de entradas podem falhar de forma fechada quando o armazenamento de replay estiver indisponível. Um `503` nessa condição não é um sinal seguro para repetir a ação de negócio com uma nova chave.

## Mover uma chave por meio de uma reivindicação

As reivindicações cobrem titularidade e portabilidade. Um fluxo do cliente é:

1. Abra a reivindicação com [Criar reivindicação](/pt/reference/interfaces/pix-lerian/dict/create-claim).
2. Leia-a com [Obter reivindicação](/pt/reference/interfaces/pix-lerian/dict/get-claim).
3. Use a transição correspondente ao papel e ao estado da reivindicação: [confirmar](/pt/reference/interfaces/pix-lerian/dict/confirm-claim), [concluir](/pt/reference/interfaces/pix-lerian/dict/complete-claim), [reconhecer](/pt/reference/interfaces/pix-lerian/dict/acknowledge-claim) ou [cancelar](/pt/reference/interfaces/pix-lerian/dict/cancel-claim).

A maioria das mutações de reivindicação fica indisponível enquanto o VSync concilia o escopo afetado. O cancelamento da reivindicação é intencionalmente separado: ele continua sendo uma saída para uma reivindicação ativa, não uma nova fonte de divergência do diretório.

## Trabalhar em um caso de MED 2.0

Uma recuperação de fundos abre um caso acompanhado; ela não prova, por si só, que os fundos foram devolvidos.

1. Abra-o com [Criar recuperação de fundos](/pt/reference/interfaces/pix-lerian/dict/create-funds-recovery) e mantenha o identificador interno retornado.
2. Leia o caso, os relatórios de infração relacionados e o grafo de rastreamento por meio das operações de referência correspondentes.
3. Atualize somente os campos mutáveis de contato ou relatório com o contrato documentado de merge patch.
4. Quando o caso chegar ao estado que permite a ação, inicie a devolução por meio da operação documentada de devolução da recuperação de fundos. Leia o caso novamente para observar o novo estado.
5. Cancele somente quando o estado atual permitir o cancelamento.

O plugin limita as recuperações de fundos ao participante autenticado. Uma resposta de não encontrado não deve ser usada para distinguir o recurso de outro participante de um identificador desconhecido.

## Registrar e cancelar um marcador de fraude

Use [Criar marcador de fraude](/pt/reference/interfaces/pix-lerian/dict/create-fraud-marker) com uma identidade de requisição criada pelo chamador. Um replay com a mesma identidade e o mesmo payload retorna o mesmo marcador; um payload diferente é rejeitado. Use [Listar marcadores de fraude](/pt/reference/interfaces/pix-lerian/dict/list-fraud-markers) ou [Obter marcador de fraude](/pt/reference/interfaces/pix-lerian/dict/get-fraud-marker) para inspecioná-lo e [Cancelar marcador de fraude](/pt/reference/interfaces/pix-lerian/dict/cancel-fraud-marker) quando o marcador não dever mais se aplicar.

## Deixar o VSync proteger a consistência das chaves

O VSync concilia o estado local das chaves com o diretório por escopo. Ele avança da verificação para a sincronização de eventos e, quando necessário, para a conciliação de arquivos. O VSync é uma superfície operacional interna na v1.0.0; aplicações clientes observam seu efeito pelo bloqueio `503` nas mutações protegidas e não chamam suas rotas de estado, job, log ou ação de conciliação.

Enquanto um escopo é conciliado, o DICT recusa mutações protegidas com `503`, em vez de aceitar uma alteração que poderia adicionar uma nova divergência. Aguarde o escopo ficar disponível; peça ao operador que inspecione o estado do VSync se o bloqueio persistir. Não contorne o bloqueio com callbacks do adaptador ou alterações diretas no armazenamento.

Para retenções e devoluções de pagamentos em disputa, continue com [SPI e o Block Balancer](/pt/interfaces/pix-lerian/pix-lerian-spi).
