Mise à jour des données de session : corriger KYC et KYB

​

Exigences communes

• Autorisation : clé API client (x-api-key / Authorization bearer standard) ou token d’autorisation utilisateur.
• Privilège :
  • KYC et POA : write:sessions
  • Entreprise KYB et partie « personnes clés » : write:businesses
• Statut de la session (KYC / POA uniquement) : doit être l’un de APPROVED, DECLINED, IN_REVIEW ou KYC_EXPIRED. Les sessions qui n’ont pas atteint un état pouvant faire l’objet d’un examen ne peuvent pas être corrigées. Les mises à jour de l’entreprise KYB ne sont soumises à aucune condition de statut.
• L’enregistrement de la fonctionnalité doit exister : vous ne pouvez corriger les champs KYC que si la session a capturé un KYC, les champs POA si elle a capturé un POA, et les champs de l’entreprise KYB si la session comporte une vérification de registre.
• Mises à jour partielles : seuls les champs que vous incluez sont modifiés. Omettez un champ pour le laisser inchangé. Envoyez null pour supprimer une clé de extra_fields.
• Webhooks : une mise à jour réussie déclenche data.updated avec session_kind: "user" ou "business", et le journal d’audit de la session enregistre les champs précis modifiés ainsi que la personne qui les a modifiés.

​

Mettre à jour les données d’identité KYC

​

Champs modifiables

​

Exemple

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" }
  }'

​

Mettre à jour les données du justificatif de domicile (POA)

​

Champs modifiables

​

Exemple

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"
    }
  }'

​

Mettre à jour les données de l’entreprise KYB

​

Prérequis

• Privilège : write:businesses (différent du privilège KYC / POA).
• Le companyUuid présent dans l’URL doit appartenir au sessionId indiqué, sinon vous obtenez une erreur 404.
• Aucune restriction liée au statut de la session : les données de l’entreprise KYB peuvent être corrigées à tout moment.

​

Champs modifiables

​

Exemple

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"
  }'

​

Ignorer une partie des personnes clés

​

Prérequis

• Privilège : write:businesses.
• Le partyUuid présent dans l’URL doit appartenir au sessionId indiqué, sinon vous obtenez une erreur 404.
• Non soumis à allow_skip. Ce paramètre de rôle limite ce que le demandeur peut ignorer lorsqu’il remplit l’écran hébergé des personnes clés. Cet endpoint est la dérogation de l’opérateur : il fonctionne donc même pour les rôles que le demandeur n’aurait pas pu ignorer.

​

Corps de la requête

​

Exemple

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 }'

​

Ce qui se passe après une mise à jour

• Webhook : data.updated est déclenché pour la session, avec son session_kind dans le payload ("user" ou "business"). Abonnez-vous une fois au niveau de la destination de webhook et aiguillez selon session_kind.
• Piste d’audit : la session enregistre précisément les champs modifiés, les anciennes et nouvelles valeurs et, pour les appels authentifiés par utilisateur, l’e-mail de l’acteur. Visible dans l’onglet Events de la console.
• Nouveau géocodage de l’adresse : pour les mises à jour KYC et POA qui modifient address / poa_address, Didit relance le géocodage en arrière-plan. Les échecs sont ignorés afin que la mise à jour n’échoue jamais en raison d’un problème de géocodage.
• Réévaluation AML : les mises à jour KYC qui modifient le nom, la date de naissance ou la nationalité peuvent relancer le filtrage AML si celui-ci n’était pas terminé pour la session. Les résultats apparaissent dans la décision de session.

​

Quand ne pas utiliser ces endpoints

• Relancer la vérification complète : si le client doit reprendre la photo de sa pièce d’identité ou téléverser à nouveau un document, utilisez plutôt update-status pour faire passer la session à Resubmitted.
• Modifier les champs de profil de l’entité User ou Business : utilisez PATCH /v3/users/{vendor_data}/ ou PATCH /v3/businesses/{vendor_data}/. Ces endpoints mettent à jour les données au niveau de l’entité, et non au niveau de la session.
• Modifier les détails des personnes clés : aucune API publique ne permet de modifier le nom, les rôles ou l’actionnariat d’une partie. Ces données sont soumises via le parcours hébergé. Le seul champ modifiable est is_skipped (voir Ignorer une partie des personnes clés).

​

Erreurs

​

Étapes suivantes