Saltar 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 saber o que todos os SDKs têm em comum.

Instalação

A gem é didit-sdk no RubyGems. O código-fonte e o registo de alterações 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 a partir do ambiente. Passe argumentos nomeados para a substituir, ou para definir os IDs da organização e da aplicação de que precisam as chamadas com âmbito de aplicação (casos, redes, relatórios regulamentares). Os campos do pedido são argumentos nomeados com os nomes da própria API; as respostas são objetos com um acessor para cada campo e podem ser acedidas através de [:field] e to_h.

Criar uma sessão

Crie uma sessão de verificação para um fluxo e envie o seu utilizador para o respetivo URL.

Ler a decisão

Quando o utilizador concluir (ou quando o webhook chegar), leia a decisão. Cada resultado de funcionalidade é uma lista com uma entrada por nó do fluxo.

Verificar um webhook

Passe o corpo bruto, exatamente como recebido, e os cabeçalhos do pedido. verify lança Didit::WebhookVerificationError para qualquer entrega que não seja válida e recente, e devolve um evento tipado caso contrário.
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.

Fazer triagem de uma transação

Envie um pagamento, um levantamento ou uma transferência de cripto-ativos para a monitorização de transações; a resposta inclui o respetivo estado e a pontuação de risco.

Verificar tokens do Authentication

Didit::Authentication verifica, no seu backend, os tokens de acesso assinados pelo emissor da sua Authentication, sem chamar a Didit em cada pedido. Também troca códigos, atualiza tokens, verifica e revoga sessões, e executa autenticações adicionais.
A verificação de tokens faz as validações indicadas em Verificar um token no seu servidor, com base no emissor e nas chaves de assinatura da sua aplicação.

Erros

Listas e ficheiros

As páginas de endpoints de servidor da referência da API têm um exemplo em Ruby para a respetiva operação, exceto nos endpoints e campos que ainda não foram incluídos numa versão 1.0.1, indicados na visão geral.
Última modificação em 7 de novembro de 2026