> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Verifica dell'identità: verifica alla registrazione e step-up prima dei pagamenti

> Con Didit, richiedi la verifica dell'identità alla registrazione e di nuovo prima dei pagamenti; ottieni claim verificati nei token.

L'identità verificata di Didit Authentication chiede alle persone di dimostrare chi sono nei momenti che scegli tu: prima che il loro account venga creato e di nuovo prima di un'azione sensibile, come un'erogazione.
La tua app riceve l'esito e le attestazioni verificate che hai selezionato, come `over_18` o un nome verificato, nei token della persona, mai i suoi documenti o le sue foto.

Configurala nella console sotto **Authentication > Verified identity**, oppure via API con [`verified/`](#imposta-tramite-api).

![La pagina Verified identity nella Business Console di Didit, con i livelli di verifica in fase di registrazione e i relativi prezzi, e le regole di aumento del livello di verifica prima delle azioni sensibili](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-verified-identity.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=98544caeedf5ffaf68484cace19f9b3f)

Authentication > Verified identity: il controllo al momento della registrazione e le regole prima delle azioni sensibili.

## Come funziona

Ogni controllo viene eseguito come sessione di verifica della tua applicazione, creata con il `vendor_data` della persona.
Ciò significa che compare nelle tue verifiche ed è associato alla stessa persona a cui sono associati i suoi accessi e le sue transazioni, va in revisione manuale come qualsiasi altra verifica e viene fatturato al prezzo di quella verifica.

| Controllo | Cosa fa la persona | Prezzo di listino |
| - | - | - |
| Rilevamento della vitalità | Scatta un selfie, sottoposto al rilevamento della vitalità. | \$0.10 |
| Accesso con selfie | Scatta un selfie che Didit confronta con il volto già associato alla persona. | \$0.10 |
| Verifica completa dell'identità | Scansiona un documento d'identità e scatta un selfie: documento, rilevamento della vitalità e confronto facciale. | \$0.33 |

Didit esegue ogni controllo con il suo workflow predefinito oppure con uno dei tuoi workflow, da te scelto per quel controllo.
Consulta i [prezzi](https://docs.didit.me/it/getting-started/pricing.md) per tutti i prezzi delle verifiche.

## Al momento della registrazione

Scegli il livello che una persona deve superare prima che venga creato il suo account:

| Livello | Valore | Significato |
| - | - | - |
| Nessuna verifica | `none` | Chiunque abbia un'email, un telefono o una passkey può registrarsi. Il valore predefinito. |
| Rilevamento della vitalità | `liveness` | Si registra una persona reale: un selfie, sottoposto a rilevamento della vitalità. |
| ID completo | `full_id` | Documento, rilevamento della vitalità e confronto facciale, prima che l'account esista. |

Un nuovo livello si applica alle persone che si registrano da quel momento in poi, mai agli account esistenti.

Sulle pagine ospitate, Didit guida la persona attraverso il controllo durante la registrazione.
Sulle tue schermate, la chiamata di registrazione risponde con `verification_required` e un `verification_url` valido per 30 minuti: invia la persona a quell'indirizzo.
Didit emette il codice di accesso solo dopo che il controllo è stato approvato.

## Step-up prima delle azioni sensibili

Uno step-up chiede alla persona di verificarsi di nuovo, solo quando un'azione è abbastanza rischiosa.
Attivi le regole e la tua app chiede a Didit, prima di ogni azione sensibile, se si applica una di esse.

![Un telefono che mostra uno step-up che chiede alla persona di confermare la propria identità con un selfie](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/step-up-preview.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=dd5087d0ba5f20b49bbd4252149ef8ca)

Cosa vede la persona quando uno step-up chiede un selfie.

| Regola | Si attiva quando | Controllo predefinito |
| - | - | - |
| `payout` | Un prelievo o un trasferimento supera la tua soglia, per esempio 500 nella tua valuta. Un payout in un'altra valuta viene sempre controllato. | Accesso con selfie |
| `device` | Un payout viene effettuato in una sessione su un dispositivo da cui non proveniva nessuna delle sessioni precedenti della persona. | Accesso con selfie |
| `bank` | La persona aggiunge o modifica un conto bancario. | verifica completa dell'identità |
| `contact` | La persona modifica il proprio indirizzo email o numero di telefono. | Rilevamento della vitalità |

Puoi cambiare il controllo di ogni regola in rilevamento della vitalità, accesso con selfie o verifica completa dell'identità.
Quando si applicano più regole, Didit chiede il controllo più forte.
Se Didit non dispone ancora di un volto associato alla persona, un accesso con selfie diventa un controllo con verifica completa dell'identità.

### Chiedi uno step-up

La tua app chiama `POST {issuer}/step-up/` con il token di accesso della persona, oppure il metodo `stepUp()` degli SDK:

```bash theme={null}
curl --fail-with-body "${DIDIT_AUTH_ISSUER}/step-up/" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "payout", "amount": "900.00", "currency": "USD", "return_to": "https://app.example.com/payouts/confirm"}'
```

| Campo | Regola |
| - | - |
| `action` | `payout`, `bank` o `contact`. Un payout applica anche la regola `device`. |
| `amount` | Obbligatorio per `payout`, con un massimo di due cifre decimali. |
| `currency` | Codice ISO 4217. Il valore predefinito è la valuta della tua regola di payout. |
| `return_to` | Dove la persona torna dopo la verifica. Quando si applica una regola, deve essere uno dei tuoi [URL di reindirizzamento](https://docs.didit.me/it/authentication/overview.md#url-di-reindirizzamento) registrati. |

* `200 {"required": false}`: nessuna regola si applica, quindi puoi procedere.
* `201` con `verification_url`: invia la persona a quell'indirizzo. Lo step-up resta aperto per 30 minuti (`expires_in: 1800`).

### Leggi il risultato sul tuo backend

La persona torna a `return_to` con `step_up=<id>&status=approved` aggiunto, ma quella query non prova nulla.
Il tuo backend legge lo step-up con `GET {issuer}/step-up/{step_up_id}/` e un token di accesso della stessa sessione, e agisce solo quando `status` è `approved`.

| Stato | Significato |
| - | - |
| `pending` | La persona non ha ancora completato il controllo. |
| `approved` | La persona ha superato il controllo. Procedi con l'azione. |
| `review` | Il controllo attende la revisione del tuo team. |
| `declined` | La persona non ha superato il controllo. Non è definitivo finché `verification_url` funziona ancora: la persona può riprovare, e lo step-up torna in `pending`. |
| `expired` | Sono passati 30 minuti. Crea un nuovo step-up. |
| `superseded` | È subentrato un altro controllo, oppure il risultato non riguardava questo step-up. Creane uno nuovo. |

Uno step-up non consente mai l'azione in caso di errore: quando la verifica non è disponibile, l'azione resta bloccata.
Le guide rapide per [JavaScript](https://docs.didit.me/it/authentication/quickstarts/javascript.md#step-up-e-riautenticazione), [Next.js](https://docs.didit.me/it/authentication/quickstarts/nextjs.md#step-up-before-sensitive-actions) e [iOS](https://docs.didit.me/it/authentication/quickstarts/ios.md#step-up-prima-delle-azioni-sensibili) mostrano il lato SDK, e il [Riferimento API](https://docs.didit.me/it/authentication/api-reference/create-step-up.md) contiene il contratto completo.

## Cosa riceve la tua app

Scegli quali claim verificati inserire nei token della persona:

| Claim | Valore |
| - | - |
| `over_18`, `over_21` | Se la persona ha almeno 18 o 21 anni, in base alla data di nascita verificata. |
| `given_name`, `family_name` | Il nome e il cognome verificati. |
| `birthdate` | La data di nascita riportata sul documento, in formato `YYYY-MM-DD`. |
| `nationality` | Codice ISO 3166-1 alpha-2. |
| `country` | Codice ISO 3166-1 alpha-2 del paese del documento. |
| `document_verified` | Se un documento d'identità è stato verificato. |
| `liveness` | Se il rilevamento della vitalità è stato superato. |

Il token di accesso e l'ID token li riportano in `verified`, con `level`, il livello più alto superato dalla persona: `liveness`, `liveness_face_match` o `full_id`.
È `{}` quando la persona non ne ha superato nessuno, mentre `GET /session/` restituisce `null`.

```json theme={null}
{
  "verified": {
    "level": "full_id",
    "over_18": true,
    "given_name": "Alex",
    "country": "ES"
  }
}
```

* Un controllo approvato durante una sessione arriva nei token al successivo aggiornamento, entro 5 minuti.
* Chiunque possieda il token può leggere questi claim, incluso il tuo front-end, quindi seleziona solo i claim personali di cui la tua app ha bisogno.
* La tua app riceve solo claim, mai il documento, il selfie o i dati facciali.

## Imposta tramite API

`GET` e `PATCH` su `verified/` nella tua [API di gestione dell'autenticazione](https://docs.didit.me/it/authentication/set-up-by-api.md) leggono e modificano le stesse impostazioni della console:

```bash theme={null}
curl --fail-with-body --request PATCH "${MANAGEMENT_BASE}verified/" \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "signup_level": "liveness",
    "rules": [
      {"rule": "payout", "enabled": true, "method": "selfie", "threshold": "500.00", "currency": "USD"},
      {"rule": "bank", "enabled": true, "method": "full_id"}
    ],
    "claims": ["over_18", "given_name", "country"]
  }'
```

| Campo | Valori |
| - | - |
| `signup_level` | `none`, `liveness` oppure `full_id`. |
| `rules` | Una voce per ogni regola che modifichi: `rule` (`payout`, `device`, `bank` o `contact`), `enabled`, `method` (`liveness`, `selfie` o `full_id`) e, solo per `payout`, `threshold` e `currency`. |
| `claims` | I claim da inserire nei token, dalla tabella sopra. |
| `workflows` | Facoltativo: il tuo ID workflow per `liveness`, `selfie` o `full_id`, oppure `null` per quello predefinito di Didit. |

Una regola che ometti mantiene le sue impostazioni attuali.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.