> ## 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 com o Pix Lerian. 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](https://docs.lerian.studio/pt/reference/interfaces/pix-lerian/dict/create-entry.md). 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](https://docs.lerian.studio/pt/reference/interfaces/pix-lerian/dict/get-entry.md). 3. Resolva uma chave com [Consultar chave](https://docs.lerian.studio/pt/reference/interfaces/pix-lerian/dict/lookup-key.md) antes de um pagamento baseado em chave ou use [Verificar existência de chaves](https://docs.lerian.studio/pt/reference/interfaces/pix-lerian/dict/check-keys-existence.md) 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. Uma conta-salário (`SLRY`) não pode receber uma nova chave: a API a recusa com `422` (`PIX-0176`). Se o diretório tiver a chave registrada para outra pessoa, a API responde `409` (`PIX-0177`), e uma reivindicação de titularidade é o próximo passo usual. Se o diretório tiver a chave registrada para o mesmo titular em outro participante, a API responde `409` (`PIX-0178`), e uma reivindicação de portabilidade é o próximo passo usual. 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](https://docs.lerian.studio/pt/reference/interfaces/pix-lerian/dict/create-claim.md). 2. Leia-a com [Obter reivindicação](https://docs.lerian.studio/pt/reference/interfaces/pix-lerian/dict/get-claim.md). 3. Use a transição correspondente ao papel e ao estado da reivindicação: [confirmar](https://docs.lerian.studio/pt/reference/interfaces/pix-lerian/dict/confirm-claim.md), [concluir](https://docs.lerian.studio/pt/reference/interfaces/pix-lerian/dict/complete-claim.md), [reconhecer](https://docs.lerian.studio/pt/reference/interfaces/pix-lerian/dict/acknowledge-claim.md) ou [cancelar](https://docs.lerian.studio/pt/reference/interfaces/pix-lerian/dict/cancel-claim.md). As mutações de reivindicação, exceto o cancelamento, ficam indisponíveis enquanto o VSync concilia. 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](https://docs.lerian.studio/pt/reference/interfaces/pix-lerian/dict/create-funds-recovery.md) e mantenha o identificador interno retornado. Uma resposta `202` significa que o BACEN ainda não resolveu a criação, e a recuperação fica `PENDING`. Leia-a de novo mais tarde: ela passa a `CREATED` ou responde `404` (`PIX-0110`) quando o BACEN não aplicou a criação. 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. Você não deve usar uma resposta de não encontrado para distinguir o recurso de outro participante de um identificador desconhecido. ## Registrar e cancelar um marcador de fraude Use [Criar marcador de fraude](https://docs.lerian.studio/pt/reference/interfaces/pix-lerian/dict/create-fraud-marker.md) 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](https://docs.lerian.studio/pt/reference/interfaces/pix-lerian/dict/list-fraud-markers.md) ou [Obter marcador de fraude](https://docs.lerian.studio/pt/reference/interfaces/pix-lerian/dict/get-fraud-marker.md) para inspecioná-lo e [Cancelar marcador de fraude](https://docs.lerian.studio/pt/reference/interfaces/pix-lerian/dict/cancel-fraud-marker.md) 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. Aplicações clientes observam seu efeito pelo bloqueio `503` nas mutações protegidas. Elas 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](https://docs.lerian.studio/pt/interfaces/pix-lerian/pix-lerian-spi.md). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.