セッションデータ更新API：KYC・KYBフィールドの修正

​

共通の要件

• 認可：クライアントAPIキー（標準のx-api-key / Authorization bearer）またはユーザー認証トークン。
• 権限：
  • KYCとPOA：write:sessions
  • KYB企業および主要人物の当事者：write:businesses
• セッションのステータス（KYC / POAのみ）：APPROVED、DECLINED、IN_REVIEW、KYC_EXPIREDのいずれかである必要があります。レビュー可能な状態に達していないセッションは更新できません。KYB企業の更新にはステータスによる制限はありません。
• 機能レコードが存在すること：KYCフィールドはセッションでKYC情報を取得した場合のみ、POAフィールドはPOA情報を取得した場合のみ、KYB企業フィールドはセッションに登記チェックがある場合のみ更新できます。
• 部分更新：含めたフィールドのみが変更されます。フィールドを省略すると、そのまま維持されます。extra_fieldsのキーを削除するにはnullを送信します。
• Webhook：更新が成功すると、session_kind: "user"または"business"を含むdata.updatedが発行され、セッションの監査証跡に、変更された具体的なフィールドと変更者が記録されます。

​

KYC本人データの更新

​

変更可能なフィールド

​

例

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

​

住所証明（POA）データの更新

​

変更可能なフィールド

​

例

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

​

KYBの企業データを更新

​

要件

• 権限: write:businesses(KYC / POA用の権限とは異なります)。
• URLのcompanyUuidは指定したsessionIdに属している必要があります。属していない場合は404が返されます。
• セッションステータスによる制限はありません。KYBの企業データはいつでも修正できます。

​

変更可能なフィールド

​

例

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

​

主要人物の当事者をスキップ

​

要件

• 権限: write:businesses。
• URLのpartyUuidは指定したsessionIdに属している必要があります。属していない場合は404が返されます。
• allow_skipによる制限を受けません。 この役割設定は、申請者がホスト型の主要人物画面に入力する際にスキップできる内容を制限するものです。このエンドポイントはオペレーターによる上書きであるため、申請者がスキップできなかった役割でも機能します。

​

リクエストボディ

​

例

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

​

更新後に起こること

• Webhook: セッションでdata.updatedが発行され、ペイロードにはセッションのsession_kind("user"または"business")が含まれます。送信先レベルで一度サブスクライブし、session_kindで振り分けてください。
• 監査ログ: セッションには、変更されたフィールド、変更前と変更後の値、および(ユーザー認証による呼び出しの場合は)実行者のメールアドレスが正確に記録されます。コンソールの「Events」タブで確認できます。
• 住所の再ジオコーディング: address / poa_addressを変更するKYCおよびPOAの更新では、Diditがバックグラウンドでジオコーディングを再実行します。失敗は無視されるため、ジオコーディングの問題が原因で更新が失敗することはありません。
• AMLの再評価: 氏名 / 生年月日 / 国籍を変更するKYCの更新は、セッションでAMLが完了していなかった場合、AMLスクリーニングを再トリガーすることがあります。結果はセッションの判定に表示されます。

​

これらのエンドポイントを使用すべきでない場合

• 検証全体のやり直し: 顧客が身分証明書の写真を撮り直したり、書類を再アップロードしたりする必要がある場合は、代わりにupdate-statusを使用してセッションをResubmittedに移行してください。
• UserまたはBusinessエンティティのプロフィールフィールドの変更: PATCH /v3/users/{vendor_data}/またはPATCH /v3/businesses/{vendor_data}/を使用してください。これらのエンドポイントは、セッションレベルではなくエンティティレベルのデータを更新します。
• 主要人物の詳細の編集: 当事者の名前、役割、所有構造を変更する公開APIはありません。このデータはホスト型フローを通じて送信されます。変更できる唯一のフィールドはis_skippedです(主要人物の当事者をスキップを参照)。

​

エラー

​

次のステップ