Vi manca un Paese o un controllo su misura? Diteci di cosa avete bisogno.Prenotate una chiamata di 15 minuti

Sviluppatori

Verificate una persona con una chiamata API.

Il vostro backend crea una sessione, la persona si verifica su una pagina ospitata o in un frame integrato, e l'esito torna via webhook e come risultato firmato.

Il riferimento API è pubblico su app.secuveri.com/docs. Non serve accedere per leggerlo.

curl -X POST https://api.secuveri.com/v1/sessions \
  -H "x-api-key: $SECUVERI_API_KEY" \
  -H "content-type: application/json" \
  -H "Idempotency-Key: signup-1042" \
  -d '{
    "workflow_id": "wf_kyc_standard",
    "vendor_data": "customer-1042"
  }'

201Risposta

{
  "verification_id": "VRF-7KQ2M9XA",
  "status": "CREATED",
  "url": "https://verify.secuveri.com/verification/VRF-7KQ2M9XA?t=…"
}

Avvio rapido

Online in tre passi.

  1. 01

    Create una chiave API

    In Impostazioni, Chiavi API. sk_test_ per la sandbox, sk_live_ per la produzione. Le chiavi restano sul vostro server.

  2. 02

    Creare una sessione

    POST /v1/sessions restituisce un link. Reindirizzate, mostrate un codice QR o lasciate che lo inviamo via e-mail o SMS.

  3. 03

    Ricevete l'esito

    Un webhook firmato vi avvisa della conclusione. Il risultato firmato contiene l'esito e ogni controllo.

API autonome

Ogni API anche da sola.

Ogni controllo è venduto anche come API autonoma, fuori da un flusso di verifica. Ognuna con il suo stato reale.

Disponibile

Verifica del documento

Leggere e verificare un documento d'identità e il suo chip NFC.

Disponibile

Confronto facciale

Confrontare due immagini del volto.

Disponibile

Liveness

Verificare che un selfie mostri una persona viva.

Disponibile

Stima dell'età

Stimare l'età da un'immagine del volto.

Disponibile

Screening AML

Verificare una persona su liste di sanzioni e PEP con POST /v1/aml/screen.

Disponibile

Prova di residenza

Leggere una bolletta o un estratto per la vostra verifica.

Disponibile

Content Credentials (C2PA)

Validare le Content Credentials di un'immagine con il secuveri C2PA Validator.

Disponibile

Verifica aziendale (KYB)

Verificare un'azienda nel registro di commercio svizzero.

Risultati affidabili

Webhook e risultati firmati.

Il webhook vi dice che è successo qualcosa. Il risultato firmato vi dice cosa, verificabile da chiunque abbia le nostre chiavi pubbliche.

  1. 01

    Il vostro backend

    POST /v1/sessions

  2. 02

    Flusso ospitato

    Documento, liveness, confronto facciale

  3. 03

    Webhook

    secuveri-signature: HMAC-SHA256

  4. 04

    Risultato firmato

    JWS ES256, verificato con /.well-known/jwks.json

  • Webhook ritentati 7 volte in circa 21 ore
  • ID evento per scartare i duplicati
  • Nessun dato personale nel risultato firmato

Componenti

Cosa vi offre l'API.

Tutto il necessario per gestire la verifica dal vostro backend.

API delle sessioni

Create una sessione e ricevete link e token. Chiavi di idempotenza, una sessione aperta per cliente, e possiamo inviare il link via e-mail o SMS.

Webhook

Eventi quando una verifica termina o viene esaminata, firmati HMAC e ritentati per circa 21 ore.

Risultati firmati

Ogni esito come JWS ES256 senza dati personali, verificabile con le nostre chiavi pubbliche.

Embed web

Aprite il flusso in una finestra modale o in un frame integrato con un solo tag script, con passaggio al telefono tramite QR.

Sandbox

Chiavi di test e scenari gratuiti che chiudono una sessione con l'esito scelto.

Riautenticazione

Confermate un cliente che ritorna con selfie e liveness, confrontati con la sua verifica precedente.

ID riutilizzabile in swiyu (beta)

Dopo una verifica completa, le persone possono salvare una secuveri Verified ID nell'app swiyu e condividerla la volta successiva, legata al titolare. Sono accettate anche le Beta-ID swiyu. Funziona nella beta pubblica di swiyu.

Liste di blocco e di autorizzazione

Bloccate o autorizzate e-mail, numeri di telefono, intervalli IP, dispositivi, i vostri ID utente o paesi del documento, via API o nella dashboard.

SDK

Librerie ed embed.

Script di embed web

Disponibile

secuveri.js apre il flusso ospitato in una finestra modale o in un frame integrato e ne segnala l'avanzamento.

API REST

Disponibile

HTTPS e JSON da qualsiasi linguaggio, con una descrizione OpenAPI.

@secuveri/web

Disponibile

Un pacchetto tipizzato per il browser per l'embed e i suoi eventi.

@secuveri/node

Disponibile

Un client Node.js per sessioni, risultati e verifica delle firme dei webhook.

iOS SDK

In arrivo

Acquisizione nativa e lettura del chip NFC nella vostra app iPhone.

Android SDK

In arrivo

Acquisizione nativa e lettura del chip NFC nella vostra app Android.

Contatto

Contattateci

Diteci che cosa volete verificare. Vi mostreremo come secuveri si integra nei vostri processi.

Rispondiamo entro un giorno lavorativo e usiamo i vostri dati solo per la vostra richiesta. Consultate la nostra informativa sulla privacy.