Saltar para o conteúdo

Trust Center

Verifique os seus próprios utilizadores: documentos de identidade, correspondência facial e verificações de empresa.

Abrir Trust Center
Verificado com o painel em 18 de novembro de 2026

Três métodos fazem a partir de código o que a janela Verificar alguém faz: abrir uma sessão, ler uma sessão e listar sessões. Cada um atua no Trust Center da conta cuja chave de API usa.

Abra uma sessão

Chame verify_session_create. Envie level (1 a 4, por omissão 2) e, se quiser, a sua própria external_ref (200 carateres no máximo). A resposta traz um session_id, um hosted_url para enviar à pessoa e expires_at, que é 24 horas depois.

Redirecione o seu utilizador para hosted_url, ou envie-lha.

Leia o resultado

Chame verify_session_result com o session_id. Devolve o status, a sua external_ref, as horas e o result quando a sessão estiver concluída.

curl -s https://xuda.ai/cpi/verify_session_create \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","level":2,"external_ref":"user_482"}'
const res = await fetch('https://xuda.ai/cpi/verify_session_create', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({ api_key: 'YOUR_API_KEY', level: 2, external_ref: 'user_482' }),
});
const { code, data } = await res.json();
// data.hosted_url is where you send this user next.
import requests

res = requests.post(
    'https://xuda.ai/cpi/verify_session_create',
    json={'api_key': 'YOUR_API_KEY', 'level': 2, 'external_ref': 'user_482'},
)

O que decide a sessão

  • O modo. Uma sessão é de teste quando o serviço corre em modo de teste, e live quando corre em Live. As sessões de teste são gratuitas, nunca são contadas e podem ser terminadas a partir do dashboard. As ligações live ainda não podem ser concluídas.
  • O nível. Um nível acima do que o seu plano permite é recusado, indicando qual o plano que o inclui. O pedido nunca é reduzido em silêncio.
  • Acima da franquia. Uma sessão live acima da franquia mensal do seu plano é recusada no Free e, num plano pago, é criada e marcada como excedente.

As chaves criam-se em Programadores, e criar uma exige o seu próprio Nível 2.

Recusas

Webhooks

No Starter e acima, defina um endereço nas definições do Trust Center e é enviado um pedido assinado quando uma verificação é decidida, para não ter de fazer polling. Cada um traz um cabeçalho Xuda-Event e um cabeçalho Xuda-Signature composto por uma data e hora e um HMAC da data e hora e do corpo, assinado com o segredo mostrado uma vez nas definições. Uma entrega que falha é repetida, até cinco tentativas.

Que tal está este guia?

Última atualização em 16 de novembro de 2026