KYC (Verificacao de Identidade)

O template integra verificacao de identidade (Know Your Customer) com suporte a multiplos operadores.

Operadores suportados

Operador	Descricao
CAF	Provedor de identidade digital
Legitimuz	Verificacao por documento + selfie
Pay2Free	Verificacao simplificada
Serasa	Bureau de credito (Brasil)
SumSub	Verificacao global
Unico	Biometria facial
ShieldID	Verificacao por dispositivo

O operador ativo e determinado pela configuracao do pais (kycOperators em @cactus-agents/country-config).

Fluxo

1. Usuario precisa verificar identidade
   (por deposito, saque, ou regra regulatoria)
       |
       v
2. Modal KYC abre com iframe do operador
       |
       v
3. Usuario completa verificacao no iframe
       |
       v
4. Template faz polling de status (a cada 5s)
       |
       v
5. Resultado: Aprovado / Reprovado / Pendente manual

Status possiveis

Status	Descricao
PROCESSING	Verificacao em andamento
APPROVED	Aprovado automaticamente
MANUAL_APPROVED	Aprovado manualmente
REPROVED	Reprovado
MANUAL_REPROVED	Reprovado manualmente
MANUAL_APPROVE_PENDING	Aguardando aprovacao manual
LIVENESS_PENDING	Prova de vida pendente

Gatilhos

O KYC pode ser disparado por:

• Validacao pos-registro — se o pais/marca exige KYC apos cadastro
• Deposito — se o contexto de deposito requer KYC
• Saque — se o contexto de saque requer KYC
• Mudanca de senha/dispositivo/IP — por seguranca
• Link de recuperacao — via email/SMS (/user/validate/kyc/:token)

Configuracao

O KYC nao requer configuracao especifica no fork. O operador e selecionado automaticamente pelo backend com base no pais do usuario.

Para personalizar os operadores disponiveis por pais, ajuste a lista kycOperators no @cactus-agents/country-config.