Skip to main content
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. 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.
  3. Resolva uma chave com Consultar chave antes de um pagamento baseado em chave ou use Verificar existência de chaves 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.
  2. Leia-a com Obter reivindicação.
  3. Use a transição correspondente ao papel e ao estado da reivindicação: confirmar, concluir, reconhecer ou cancelar.
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 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 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 ou Obter marcador de fraude para inspecioná-lo e Cancelar marcador de fraude 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.