Documentazione sviluppatore | API & Integration Guide - Implementazione ospitata

Changelog

15 ottobre 2025

Processo di verifica dell’età tramite selfie

• Miglioramento della velocità complessiva del processo di verifica dell’età
• Rafforzamento dei meccanismi anti-spoofing e dei controlli di liveness per le versioni standard e avanzata

---

23 settembre 2025

Validazione degli utenti

• Validazione tra partner: una volta che un utente è validato presso un partner, il suo stato viene ora riconosciuto su tutti i siti partner.

Configurazione della verifica

• I partner possono ora scegliere i tipi di verifica da proporre agli utenti.
• L’opzione di fallback via email può essere disattivata se necessario.

Miglioramenti dell’interfaccia utente

• Aggiunta di tre nuove opzioni di colore configurabili per i pulsanti di annullamento ed errore:
• button.backgroundFailure
• button.foregroundFailure
• button.foregroundCallToActionFailure

Implementazione standard (precedentemente vecchia implementazione)

La precedente pagina di implementazione è stata rinominata e migliorata con il nome Implementazione standard.

Aggiornamenti dell’SDK dell’implementazione standard:

• Semplificazione della validazione del payload:
• I controlli di integrità del payload non sono più necessari.
• Utilizzare eventMessage.data.isPayloadValid per verificare direttamente la validità del payload.
• Rimozione dello script locale di validazione del payload.
• Nuovi parametri opzionali:
• paramList.verificationTypeList : definire i tipi di verifica da mostrare.
• paramList.verificationTypeDefault : definire il tipo di verifica selezionato di default.
• paramList.useEmailAsFallbackVerification : attivare o disattivare il fallback via email.
• Ulteriore personalizzazione UI: tre nuovi colori configurabili per gli stati di errore e annullamento (vedi miglioramenti UI).

Implementazione Hosted (nuova)

Una nuova opzione, Implementazione Hosted, è ora disponibile. Si distingue dall’implementazione standard:

• Implementazione 100% frontend (JavaScript).
• Logica di overlay iframe semplificata.
• Installazione rapida tramite un unico script JavaScript nel (modalità automatica).
• Gestione automatica di:
• Offuscamento del contenuto fino alla verifica.
• Cookie locali per identificare gli utenti verificati.
• Due modalità disponibili:
• Automatica: gestione completa.
• Controllata: personalizzazione delle azioni in base al risultato.
• Restrizioni per dominio:
• Ogni dominio deve essere validato.
• Implementazione e dati legati al dominio.
• Due chiavi per dominio: sviluppo e produzione.
• Configurazione per dominio: colori, tipi di verifica, liveness, fallback email, ecc.
• Logica di verifica semplificata rispetto all’implementazione standard.

Filtro delle statistiche

• Le statistiche possono ora essere filtrate per nome di dominio.
• Le implementazioni Hosted e Standard possono essere distinte nei report.

Correzioni di bug

Sono state apportate diverse correzioni minori.