O que é KYC (Conheça Seu Cliente)?
Know Your Customer (KYC) é o processo de verificação de identidade de clientes individuais antes de estabelecer um relacionamento comercial. A solução KYC da gu1 permite integrar a verificação de identidade em sua aplicação, permitindo que seus usuários finais concluam o processo de verificação de forma fluida.Abordagem API-First
Nossa API de KYC permite:- Criar validações KYC programaticamente para seus clientes
- Gerar URLs de verificação para compartilhar com seus usuários
- Receber notificações webhook em tempo real quando a verificação for concluída
- Consultar o status de validação a qualquer momento
Fluxo de Integração Típico
Compartilhar URL com o Cliente
Envie a URL de verificação ao seu cliente por email, SMS ou integre em seu app
Cliente Completa a Verificação
Seu cliente segue a URL e completa o processo de verificação de identidade
Receber Notificação Webhook
A gu1 envia um webhook ao seu sistema quando a verificação estiver completa
Webhooks vs Polling Manual: Embora os webhooks forneçam notificações em tempo real, você também pode verificar manualmente o status de validação a qualquer momento usando
GET /api/kyc/validations/:id. Isso é útil para:- Depuração ou testes sem infraestrutura de webhook
- Exibir atualizações de status aos usuários em tempo real
- Recuperar de falhas na entrega de webhook
- Criar dashboards de administração para monitorar o status de validação
Recursos Principais
KYC Completo vs Verificações Individuais
Qual você deve usar?
-
KYC Completo (
global_gueno_validation_kyc): Verificação de identidade completa incluindo upload de documento, selfie, comparação facial e detecção de vida. Recomendado para serviços financeiros, bancos e indústrias reguladas. - Verificações Individuais: Chamadas de API separadas para verificações específicas como screening PEP, verificação de sanções ou buscas de mídia adversa. Use quando precisar apenas de pontos de dados específicos ou já tiver documentos de identidade verificados.
| Recurso | KYC Completo | Verificações Individuais |
|---|---|---|
| Upload de Documento | ✅ Incluído | ❌ Não incluído |
| Selfie + Liveness | ✅ Incluído | ❌ Não incluído |
| Comparação Facial | ✅ Incluído | ❌ Não incluído |
| PEP/Sanções | ✅ Incluído | ✅ Chamada de API separada |
| Mídia Adversa | Add-on opcional | ✅ Chamada de API separada |
| Experiência do Usuário | Fluxo único para o usuário | Sem interação do usuário |
| Melhor Para | Abertura de conta, onboarding | Monitoramento contínuo, screening |
| Endpoint API | POST /api/kyc/validations | POST /entities/:id/analyze |
Verificação de Identidade Abrangente (KYC Completo)
- Validação de Documento: Autentica documentos de identidade emitidos pelo governo
- Verificação Biométrica: Reconhecimento facial e detecção de vida
- Comparação Facial: Compara selfie com a foto do documento (veja nota de segurança abaixo)
- Screening AML/Sanções: Verifica contra listas de vigilância globais
- Extração de Dados: Extrai e verifica informações pessoais
Processamento Automático de Documentos
- Tecnologia OCR: Extrai automaticamente dados de documentos de identidade
- Suporte Multi-idioma: Processa documentos em mais de 100 idiomas
- Autenticação de Documentos: Detecta documentos falsos ou adulterados
- Extração de Dados: Incorpora informações verificadas ao seu sistema
Webhooks em Tempo Real
- Notificações Instantâneas: Receba atualizações assim que a verificação for concluída
- Mudanças de Status: Notificações de aprovação, rejeição ou revisão manual
- Entrega Segura: Assinaturas de webhook para validação de segurança
- Lógica de Retentativas: Retentativas automáticas para entregas falhadas
Pronto para Conformidade
- Conformidade AML/CFT: Cumpre com requisitos anti-lavagem de dinheiro
- Conformidade GDPR: Padrões de proteção de dados e privacidade
- Registro de Auditoria: Histórico completo de tentativas de verificação
- Retenção de Dados: Políticas de retenção configuráveis
Casos de Uso
Aplicações Fintech
- Banco Digital: Verifica usuários durante abertura de conta
- Apps de Pagamento: Cumpre com regulações financeiras
- Plataformas de Empréstimo: Verifica identidade de mutuários
- Exchanges de Cripto: Cumpre requisitos KYC para traders
Marketplaces e Plataformas
- Plataformas P2P: Verifica compradores e vendedores
- Economia Compartilhada: Valida prestadores de serviços
- Economia Gig: Incorpora freelancers e contratados
- Plataformas de Aluguel: Verifica inquilinos e anfitriões
Documentos Suportados
Nossa solução KYC aceita vários documentos de identidade de mais de 200 países:- Carteiras de identidade nacional
- Passaportes
- Carteiras de motorista
- Autorizações de residência
- Documentos emitidos pelo governo
Começando
Pronto para integrar verificação KYC em sua aplicação?Criar Validação KYC
Iniciar uma nova sessão de verificação
Obter URL de Verificação
Obter a URL para compartilhar com usuários
Integração de Webhooks
Receber notificações em tempo real
Verificar Status
Consultar resultados de verificação
Resumo de Endpoints API
| Endpoint | Método | Descrição | Caso de Uso |
|---|---|---|---|
/api/kyc/validations | POST | Criar uma nova validação KYC | Iniciar processo de verificação |
/api/kyc/validations/{id} | GET | Obter status e detalhes de validação | Polling manual - verificar status a qualquer momento |
/api/kyc/entities/{entityId}/current | GET | Obter validação atual para uma entidade | Recuperar validação ativa |
/api/kyc/webhooks | POST | Receber notificações webhook | Automático - ser notificado quando completo |