Instalação
didit-protocol/sdk-php está disponível no Packagist. O código-fonte e o changelog ficam em didit-protocol/sdk-php no GitHub.
A verificação de tokens de Authentication também exige a extensão openssl.
Configurar o cliente
new DiditClient() lê DIDIT_API_KEY do ambiente. Passe argumentos nomeados para sobrescrever esse valor ou para definir os ids da organização e da aplicação que as chamadas no escopo da aplicação (casos, redes, relatórios regulatórios) exigem. Os campos da requisição formam um único array com os mesmos nomes de campo da API; as respostas são objetos somente de leitura com propriedades em camelCase e toArray().
Criar uma sessão
Crie uma sessão de verificação para um workflow e envie o 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 WebhookVerificationException para qualquer coisa que não seja uma entrega válida e recente e, caso contrário, retorna um evento tipado.
$request->getContent() e $request->headers->all(); com uma requisição PSR-7, passe a própria requisição como os cabeçalhos. Enquanto você faz a rotação do segredo, passe os dois: [$newSecret, $oldSecret]. Veja Webhooks para conhecer os eventos e o esquema de assinatura.
Analisar uma transação
Envie um pagamento, saque ou transferência de criptomoedas para o monitoramento de transações; a resposta contém seu status e sua pontuação de risco.Verificar tokens do Authentication
Authentication verifica os tokens de acesso que o seu emissor do Authentication assina, no seu backend, sem chamar a Didit a cada requisição. Passe um cache PSR-16 para que as chaves do emissor sejam buscadas uma única vez, e não 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 faz as checagens descritas em Verificar um token no seu servidor, usando o emissor e as chaves de assinatura da sua aplicação.