O que muda
Como fazer a migração (Web)
1
Atualize o backend
Troque a chamada de criação de sessão para
POST /api/v2/sessions. O corpo da requisição não usa mais visitorId/eventId/maxAttempts; a resposta não traz mais facetecSessionToken. Se você chama o endpoint de falha manual, só troque /api/v1/ por /api/v2/ na URL — o corpo e a resposta são idênticos.2
Aponte para o novo script do SDK
Troque a URL do
<script> carregado via CDN pela URL da v10. Não é preciso carregar o motor FaceTec separadamente — o novo bundle já faz isso.3
Remova o mount
A captura da v10 abre como camada full-screen. Remova qualquer elemento do DOM que você reservava só para montar o SDK.
4
Ajuste os callbacks
Atualize
onSuccess/onFailure para o novo formato de resultado e de erro — veja Implementação e Solução de problemas.5
Remova a lógica de retry dentro da sessão
Se o seu código tratava
attemptsLeft/canRetry para reexibir a tela sem criar uma nova sessão, remova essa lógica: na v10, uma nova tentativa é sempre uma chamada nova a run(), que cria uma sessão nova automaticamente.6
Reaplique a customização visual, se houver
O sistema de temas mudou de um preset fixo para grupos de campos que espelham a própria API do FaceTec. Reveja sua paleta em Customização.
A v9 continua funcionando normalmente até o desligamento. Não é necessário migrar de uma vez — as duas versões podem coexistir enquanto você faz a transição.