Skip to main content
GET
/
api
/
kyc
/
validations
/
{id}
Obter URL de Verificação KYC
curl --request GET \
  --url http://api.gu1.ai/api/kyc/validations/{id} \
  --header 'Authorization: Bearer <token>'

​
Resumo

Após criar uma validação KYC, você pode recuperar a URL de verificação a qualquer momento. Esta URL é o que você compartilhará com seu cliente para que ele complete o processo de verificação de identidade.

​
Quando Usar Isso

  • Recuperar URL depois: Se você não salvou a URL da resposta de criação
  • Reenviar ao cliente: Quando o cliente solicita um novo link
  • Verificar detalhes: Ver status atual e metadata
  • Integrar com outros sistemas: Passar a URL para serviços de notificação

​
Solicitação

​
Endpoint

GET https://api.gu1.ai/api/kyc/validations/{id}

​
Valores possíveis de status

O campo status pode ser: pending, in_progress, in_review, approved, rejected, expired, abandoned, cancelled. Consulte Verificar status para a descrição de cada um.

​
Exemplo

const validationId = '550e8400-e29b-41d4-a716-446655440000';

const response = await fetch(
  `https://api.gu1.ai/api/kyc/validations/${validationId}`,
  {
    headers: {
      'Authorization': 'Bearer SUA_API_KEY'
    }
  }
);

const validation = await response.json();
const urlVerificacao = validation.providerSessionUrl;
console.log('Compartilhe esta URL com seu cliente:', urlVerificacao);

​
Alternativa: Obter Validação Atual por Entidade

GET https://api.gu1.ai/api/kyc/entities/{entityId}/current

​
Compartilhar a URL com Clientes

​
Exemplo de Email

<p>Olá {{nomeCliente}},</p>
<p>Por favor complete sua verificação de identidade para continuar:</p>
<p><a href="{{providerSessionUrl}}">Verificar Sua Identidade</a></p>
<p>Este link expirará em 7 dias.</p>

​
Integração em App

// Redirecionar usuário para verificação
window.location.href = providerSessionUrl;

// Ou abrir em nova janela
window.open(providerSessionUrl, '_blank');

​
Próximos Passos

Integração Webhook

Receber atualizações em tempo real

Verificar Status

Consultar resultados de validação