Pular para o conteúdo principal
A gem oficial da Didit para Ruby. Requer Ruby 3.1 ou posterior e usa o net/http da biblioteca padrão. Consulte a visão geral dos SDKs de servidor para ver o que todos os SDKs têm em comum.

Instalação

A gem está disponível como didit-sdk no RubyGems. O código-fonte e o changelog estão em didit-protocol/sdk-ruby no GitHub. Ou adicione gem "didit-sdk" ao seu Gemfile e execute bundle install. Carregue-a com require "didit".

Configurar o cliente

Didit::Client.new lê DIDIT_API_KEY do ambiente. Passe argumentos nomeados para substituí-la ou para definir os ids da organização e da aplicação exigidos pelas chamadas no escopo da aplicação (casos, redes, relatórios regulatórios). Os campos da requisição são argumentos nomeados com os mesmos nomes da API; as respostas são objetos com um método leitor para cada campo, [:field] e to_h.

Criar uma sessão

Crie uma sessão de verificação para um workflow e envie seu usuário para a URL dela.

Ler a decisão

Quando o usuário terminar (ou quando o webhook chegar), leia a decisão. O resultado de cada recurso é uma lista com uma entrada por nó do fluxo.

Verificar um webhook

Passe o corpo bruto, exatamente como foi recebido, e os cabeçalhos da requisição. verify lança Didit::WebhookVerificationError se a entrega não for válida ou recente e, caso contrário, retorna um evento tipado.
No Rails, chame handle_webhook(request.raw_post, request.headers). Durante a rotação do segredo, passe os dois: [new_secret, old_secret]. Consulte Webhooks para ver os eventos e o esquema de assinatura.

Analisar uma transação

Envie um pagamento, um saque ou uma transferência de cripto para o monitoramento de transações; a resposta traz o status e a pontuação de risco.

Verificar tokens de Authentication

Didit::Authentication verifica os tokens de acesso assinados pelo seu emissor de Authentication, no seu backend, sem fazer uma requisição à Didit a cada requisição. Ele também troca códigos, renova tokens, verifica e revoga sessões e executa step-ups.
A verificação de tokens realiza as verificações descritas em Verificar um token no seu servidor, com base no emissor e nas chaves de assinatura da sua aplicação.

Erros

Listas e arquivos

As páginas dos endpoints de servidor da referência da API têm um exemplo em Ruby para a respectiva operação, exceto os endpoints e campos que ainda não estão presentes em nenhuma versão 1.0.1, listados na visão geral.
Última modificação em 1 de novembro de 2026