Aggiorna dati sessione API: correggi campi KYC e KYB

​

Requisiti comuni

• Autorizzazione — chiave API del client (standard x-api-key / bearer Authorization) oppure token di autenticazione utente.
• Privilegio —
  • KYC e POA: write:sessions
  • Azienda KYB e persona chiave: write:businesses
• Stato della sessione (solo KYC / POA) — deve essere uno tra APPROVED, DECLINED, IN_REVIEW o KYC_EXPIRED. Le sessioni che non hanno ancora raggiunto uno stato idoneo alla revisione non possono essere modificate. Gli aggiornamenti dell’azienda KYB non hanno vincoli di stato.
• Il record della funzionalità deve esistere — puoi modificare i campi KYC solo se la sessione contiene un record KYC, i campi POA solo se contiene un record POA, e i campi dell’azienda KYB solo se la sessione include un controllo del registro.
• Aggiornamenti parziali — vengono modificati solo i campi che includi. Ometti un campo per lasciarlo invariato. Invia null per eliminare una chiave di extra_fields.
• Webhook — un aggiornamento riuscito attiva data.updated con session_kind: "user" oppure "business", e il registro di audit della sessione riporta quali campi specifici sono stati modificati e da chi.

​

Aggiornare i dati di identità KYC

​

Campi modificabili

​

Esempio

curl -X PATCH "https://verification.didit.me/v3/session/4c5c7f3a.../update-data/" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "John",
    "last_name": "Doe",
    "date_of_birth": "1990-01-01",
    "issuing_state": "ESP",
    "extra_fields": { "municipality": "Madrid" }
  }'

​

Aggiornare i dati della Prova di residenza (POA)

​

Campi modificabili

​

Esempio

curl -X PATCH "https://verification.didit.me/v3/session/4c5c7f3a.../update-poa-data/" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "document_type": "utility_bill",
    "issuer": "Iberdrola",
    "issue_date": "2026-03-15",
    "name_on_document": "Jane Doe",
    "poa_parsed_address": {
      "street_1": "Calle Mayor 10",
      "city": "Madrid",
      "postal_code": "28013",
      "country": "ES"
    }
  }'

​

Aggiornare i dati di un’azienda KYB

​

Requisiti

• Privilegio: write:businesses (diverso dal privilegio KYC / POA).
• Il companyUuid nell’URL deve appartenere al sessionId indicato, altrimenti ottieni un 404.
• Nessun vincolo sullo stato della sessione: i dati dell’azienda KYB possono essere corretti in qualsiasi momento.

​

Campi modificabili

​

Esempio

curl -X PATCH "https://verification.didit.me/v3/session/bs-01HJX1.../kyb/f7a9c1b2-4e6d.../update-data/" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "company_name": "Acme Corporation Limited",
    "registration_number": "12345678",
    "registry_status": "active",
    "legal_address": "1 Main Street, London EC1A 1AA, United Kingdom",
    "alternative_names": "Acme Ltd, Acme Group"
  }'

​

Escludere una parte della sezione Key People

​

Requisiti

• Privilegio: write:businesses.
• Il partyUuid nell’URL deve appartenere al sessionId indicato, altrimenti ottieni un 404.
• Non è vincolato da allow_skip. Quell’impostazione del ruolo limita ciò che il richiedente può escludere mentre compila la schermata Key People ospitata; questo endpoint è l’override dell’operatore, quindi funziona anche sui ruoli che il richiedente non avrebbe potuto escludere.

​

Corpo della richiesta

​

Esempio

curl -X PATCH "https://verification.didit.me/v3/session/bs-01HJX1.../kyb/parties/0a3f1e2c-7c2f.../" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "is_skipped": true }'

​

Cosa succede dopo un aggiornamento

• Webhook: data.updated viene inviato per la sessione, con il session_kind della sessione nel payload ("user" o "business"). Iscriviti una sola volta a livello di destinazione e smista in base a session_kind.
• Registro di controllo: la sessione registra esattamente quali campi sono cambiati, i valori precedenti e quelli nuovi e (per le chiamate con autenticazione utente) l’email dell’attore. Visibile nella scheda Events della console.
• Rigeocodifica dell’indirizzo: per gli aggiornamenti KYC e POA che modificano address / poa_address, Didit esegue la rigeocodifica in background. Gli errori vengono ignorati, così l’aggiornamento non fallisce mai per un problema di geocodifica.
• Rivalutazione AML: gli aggiornamenti KYC che modificano nome / data di nascita / nazionalità possono rilanciare lo screening AML se lo screening AML sulla sessione non era ancora terminato. I risultati compaiono nella decisione della sessione.

​

Quando non usare questi endpoint

• Ripetere l’intera verifica: se il cliente deve rifare la foto del documento d’identità o ricaricare un documento, usa update-status per portare la sessione in Resubmitted.
• Modificare i campi del profilo dell’entità User o Business: usa PATCH /v3/users/{vendor_data}/ oppure PATCH /v3/businesses/{vendor_data}/; questi endpoint aggiornano i dati a livello di entità, non a livello di sessione.
• Modificare i dettagli delle persone Key People: non esiste un’API pubblica per modificare nome, ruoli o assetto proprietario di una persona; questi dati vengono inviati tramite il flusso ospitato. L’unico campo modificabile è is_skipped (vedi Escludere una parte della sezione Key People).

​

Errori

​

Passaggi successivi