{"id":4536,"date":"2026-10-06T11:31:40","date_gmt":"2026-10-06T11:31:40","guid":{"rendered":"https:\/\/whitelotto.com\/?p=4536"},"modified":"2026-10-06T11:31:40","modified_gmt":"2026-10-06T11:31:40","slug":"lottery-kyc-integration-guide","status":"publish","type":"post","link":"https:\/\/whitelotto.com\/pt-br\/lottery-kyc-integration-guide\/","title":{"rendered":"Integra\u00e7\u00e3o KYC para Loteria: Estados, Dados e Revis\u00e3o Manual"},"content":{"rendered":"\n

Uma integra\u00e7\u00e3o KYC para loteria deve transformar as decis\u00f5es de um fornecedor de verifica\u00e7\u00e3o em permiss\u00f5es claras e controladas para a conta do jogador. Defina o modelo de estados, o processo de revis\u00e3o manual, o tratamento de atualiza\u00e7\u00f5es e os limites de dados antes de conectar a primeira tela de verifica\u00e7\u00e3o. Concluir um envio de documentos n\u00e3o \u00e9 o mesmo que aprovar um solicitante.<\/p>\n

Este guia aborda requisitos t\u00e9cnicos e operacionais, n\u00e3o orienta\u00e7\u00f5es jur\u00eddicas espec\u00edficas de uma jurisdi\u00e7\u00e3o nem documenta\u00e7\u00e3o real da API WhiteLotto. O operador respons\u00e1vel e seus assessores devem definir as verifica\u00e7\u00f5es aplic\u00e1veis e as a\u00e7\u00f5es permitidas na conta. O guia da jornada KYC<\/a> considera a experi\u00eancia do jogador junto a esses controles.<\/p>\n\n

Mapeie os estados do fornecedor para as decis\u00f5es do operador<\/h2>\n

Mantenha separados o status do fluxo de trabalho do fornecedor, o resultado da decis\u00e3o e as permiss\u00f5es internas da conta. \u201cConclu\u00eddo\u201d pode descrever uma revis\u00e3o encerrada com aprova\u00e7\u00e3o ou rejei\u00e7\u00e3o. \u201cRequer a\u00e7\u00e3o\u201d pode indicar a necessidade de outro documento, em vez de uma recusa definitiva.<\/p>\n

\n
Mapeamento de estados de verifica\u00e7\u00e3o independente de fornecedor<\/caption>
Estado interno<\/th>Significado a definir<\/th>A\u00e7\u00e3o do operador<\/th><\/tr><\/thead>
N\u00e3o iniciado<\/th>Nenhuma jornada de verifica\u00e7\u00e3o exigida foi iniciada.<\/td>Mostrar a pr\u00f3xima etapa aplic\u00e1vel e as restri\u00e7\u00f5es configuradas.<\/td><\/tr>\n
Aguardando o solicitante<\/th>S\u00e3o necess\u00e1rias informa\u00e7\u00f5es ou um novo envio.<\/td>Apresentar uma solicita\u00e7\u00e3o segura e clara, sem expor a l\u00f3gica interna de risco.<\/td><\/tr>\n
Revis\u00e3o pendente<\/th>O fornecedor ou revisor ainda n\u00e3o chegou a uma decis\u00e3o utiliz\u00e1vel.<\/td>Preservar o status pendente; n\u00e3o aprovar silenciosamente por tempo esgotado.<\/td><\/tr>\n
Revis\u00e3o manual<\/th>\u00c9 necess\u00e1ria uma decis\u00e3o humana autorizada.<\/td>Definir respons\u00e1vel, limite de acesso e caminho de escala\u00e7\u00e3o.<\/td><\/tr>\n
Aprovado<\/th>As verifica\u00e7\u00f5es acordadas foram aprovadas para o n\u00edvel e momento pertinentes.<\/td>Aplicar somente as permiss\u00f5es autorizadas pela pol\u00edtica do operador.<\/td><\/tr>\n
Rejeitado ou restrito<\/th>Um resultado definitivo ou uma restri\u00e7\u00e3o posterior exige a\u00e7\u00e3o.<\/td>Aplicar restri\u00e7\u00f5es controladas e a comunica\u00e7\u00e3o permitida ao cliente.<\/td><\/tr>\n<\/tbody><\/table><\/div>\n

A documenta\u00e7\u00e3o de status de solicitantes da Sumsub<\/a> ilustra a diferen\u00e7a entre uma revis\u00e3o conclu\u00edda, uma aprova\u00e7\u00e3o e uma rejei\u00e7\u00e3o que permite nova tentativa. Esse \u00e9 o exemplo de um fornecedor, n\u00e3o uma afirma\u00e7\u00e3o de que a WhiteLotto utiliza a Sumsub ou tem estados id\u00eanticos.<\/p>\n\n

Torne as atualiza\u00e7\u00f5es seguras, inclusive as mudan\u00e7as de decis\u00e3o<\/h2>\n

Vincule a refer\u00eancia do solicitante ao jogador e ao n\u00edvel de verifica\u00e7\u00e3o corretos. Valide a origem do evento pelo mecanismo documentado do fornecedor. Armazene metadados suficientes do evento para detectar duplicidades e investigar hor\u00e1rios, sem colocar documentos de identidade nos logs de rotina.<\/p>\n

Um solicitante pode receber uma decis\u00e3o posterior \u00e0 primeira conclus\u00e3o. O guia de resultados da Sumsub<\/a> descreve eventos definitivos posteriores e a recupera\u00e7\u00e3o de entregas n\u00e3o recebidas. Acorde como a integra\u00e7\u00e3o determina a decis\u00e3o atual, trata atualiza\u00e7\u00f5es antigas e reavalia permiss\u00f5es ap\u00f3s uma mudan\u00e7a leg\u00edtima. Uma aprova\u00e7\u00e3o mantida permanentemente em cache n\u00e3o constitui um modelo de estados completo.<\/p>\n

Crie uma rota de recupera\u00e7\u00e3o suportada para notifica\u00e7\u00f5es ausentes. Use uma consulta de status ou um reprocessamento do fornecedor como alternativa prevista no contrato real, em vez de consultar continuamente todos os solicitantes sem um motivo. Conecte esse desenho \u00e0 arquitetura principal de integra\u00e7\u00e3o<\/a>.<\/p>\n\n

Minimize os dados copiados para a plataforma<\/h2>\n

Identifique as informa\u00e7\u00f5es necess\u00e1rias a cada sistema: refer\u00eancia do fornecedor, decis\u00e3o, n\u00edvel de verifica\u00e7\u00e3o, hor\u00e1rios relevantes e c\u00f3digos de motivo permitidos podem atender um fluxo sem copiar todos os documentos enviados. Defina quem pode acessar o painel do fornecedor, o que \u00e9 retido localmente e como as instru\u00e7\u00f5es de exclus\u00e3o ou reten\u00e7\u00e3o s\u00e3o propagadas.<\/p>\n

Use solicitantes fict\u00edcios no desenvolvimento e nas demonstra\u00e7\u00f5es. N\u00e3o pe\u00e7a que funcion\u00e1rios enviem passaportes reais para um ambiente de testes n\u00e3o aprovado. Aplique acesso baseado em fun\u00e7\u00f5es \u00e0 revis\u00e3o manual e mantenha identificadores sens\u00edveis fora de URLs, eventos de an\u00e1lise e ferramentas gerais de acompanhamento de erros. Resolva os direitos contratuais separadamente usando o guia de propriedade dos dados de jogadores<\/a>.<\/p>\n\n

Defina o tratamento manual antes do lan\u00e7amento<\/h2>\n

Identifique o revisor, o respons\u00e1vel pela escala\u00e7\u00e3o e as a\u00e7\u00f5es permitidas para casos amb\u00edguos. Especifique o tratamento de contas duplicadas, identificadores incompat\u00edveis, fornecedores indispon\u00edveis e verifica\u00e7\u00f5es reabertas. Separe uma falha t\u00e9cnica de integra\u00e7\u00e3o de uma decis\u00e3o negativa de verifica\u00e7\u00e3o, para n\u00e3o informar incorretamente ao cliente que ele foi reprovado.<\/p>\n

A equipe de suporte precisa de mensagens seguras, refer\u00eancias de casos e um caminho at\u00e9 um revisor autorizado \u2014 n\u00e3o de acesso irrestrito a documentos. Acorde as expectativas operacionais e o tempo em aberto das exce\u00e7\u00f5es na checklist de suporte e SLA<\/a>.<\/p>\n\n

Casos de aceite da integra\u00e7\u00e3o KYC<\/h2>\n