세션 데이터 업데이트 API: KYC 및 KYB 필드 수정

​

공통 요구 사항

• 권한 부여: 클라이언트 API 키(표준 x-api-key / Authorization 베어러) 또는 사용자 권한 부여 토큰.
• 권한:
  • 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 재평가: 세션에서 AML이 완료되지 않았다면, 이름, 생년월일 또는 국적을 변경하는 KYC 업데이트가 AML 스크리닝을 다시 트리거할 수 있습니다. 결과는 세션 결정에 표시됩니다.

​

이 엔드포인트를 사용하지 말아야 할 경우

• 전체 인증 다시 실행: 고객이 신분증 사진을 다시 찍거나 문서를 다시 업로드해야 한다면, 세션을 Resubmitted로 이동하려면 update-status를 사용하십시오.
• 사용자 또는 기업 엔티티의 프로필 필드 변경: PATCH /v3/users/{vendor_data}/ 또는 PATCH /v3/businesses/{vendor_data}/를 사용하십시오. 이 엔드포인트들은 세션 수준이 아닌 엔티티 수준 데이터를 업데이트합니다.
• 주요 인물 세부 정보 편집: 당사자의 이름, 역할 또는 소유권을 패치하는 공개 API는 없습니다. 해당 데이터는 호스팅 흐름을 통해 제출됩니다. 패치할 수 있는 유일한 필드는 is_skipped입니다(주요 인물 당사자 건너뛰기 참조).

​

오류

​

다음 단계