Saltar para o conteúdo principal
POST
curl

Suporte a KYC e KYB

Funciona tanto para sessões de Verificação de utilizadores (KYC) como de Verificação de empresas (KYB). A Didit procura o session_id em ambos os tipos de sessão e gera um token de partilha JWT que inclui:
Quando o parceiro destinatário importa o token, a Didit clona a sessão do tipo correspondente (KYC ou KYB) com as respetivas relações.

Requisitos

  • A sessão tem de estar num estado concluído (APPROVED, DECLINED, IN_REVIEW).
  • Tem de ter o privilégio write:sessions.
  • O for_application_id tem de ser uma aplicação Didit válida (normalmente a aplicação de um parceiro).

Exemplos

Resposta:

Limites do TTL

Relacionados

Autorizações

x-api-key
string
header
obrigatório

A chave de API da sua aplicação, a partir de Programadores -> Chaves de API na Business Console. A chave principal tem acesso total. Uma chave nomeada pode ter o âmbito definido: nenhum, leitura ou escrita por recurso, limitada a alguns fluxos ou a sessões aprovadas, a uma lista de endereços IP e a uma data de validade. 401 significa que a chave está incorreta, revogada ou expirada; 403 significa que nenhuma chave foi enviada, que a chave não tem acesso a este recurso ou ação, ou que o pedido veio de um endereço fora da sua lista de IP; 404 numa rota de sessão significa que a sessão está fora dos fluxos ou estados da chave. Uma chave sem acesso a multimédia recebe URLs de imagens, vídeos e PDFs como nulos, e uma chave sem permissão de escrita em sessões recebe ligações de sessão e tokens como nulos. Consulte https://docs.didit.me/console/api-keys.

Parâmetros de caminho

sessionId
string<uuid>
obrigatório

UUID da sessão de verificação de origem para a qual gerar um token.

Exemplo:

"11111111-2222-3333-4444-555555555555"

Corpo

application/json
for_application_id
string<uuid>
obrigatório

UUID da aplicação Didit que irá resgatar o token. Deve existir, não pode estar eliminada e tem de ser diferente da aplicação que efetuou a chamada. Encontre-o na Business Console em Definições → Aplicação.

Exemplo:

"a5f3bca2-46e2-411e-90ef-a580900a57ee"

ttl_in_seconds
integer
padrão:3600

Tempo de vida útil do token, em segundos. Mínimo 60, máximo 86400 (24 h). O valor predefinido é 3600 (1 h).

Intervalo necessário: 60 <= x <= 86400
Exemplo:

3600

Resposta

Token de partilha gerado.

share_token
string

JWT assinado com HS256. Passe este valor textualmente como share_token para POST /v3/session/import-shared/ na aplicação de destino.

Exemplo:

"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

for_application_id
string<uuid>

Repete o UUID da aplicação de destino à qual o token está vinculado.

Exemplo:

"a5f3bca2-46e2-411e-90ef-a580900a57ee"

session_kind
enum<string>

Se a sessão de origem é uma sessão de Verificação de utilizadores (KYC) ou de Verificação de empresas (KYB).

Opções disponíveis:
user,
business
Última modificação em 7 de novembro de 2026