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

# Updated (업데이트)

> 이 이벤트는 기존에 제출된 KYC 정보가 업데이트될 때 트리거됩니다. 업데이트는 관리자의 수동 변경이나 시스템에 의해 발생할 수 있습니다. 이 웹훅을 통해 KYC 데이터의 변경 사항을 실시간으로 추적하고 필요한 조치를 즉시 취할 수 있습니다.

<Note>
  Projection API 로 Submission 은 설정된 정보 (full\_name, gender 외) 노출을 사전에 제외시킬 수 있습니다.
  지원 가능한 항목들은 POST/Projection 의 [Fields](https://developers.argosidentity.com/api-reference/api-reference-guide/ko/post-projection#param-fields) 부분을 확인 바랍니다.
</Note>

<CodeGroup>
  ```json updated-webhook-id-document.json theme={null}
  {
      "webhook_trigger": "updated",
      "submission_id": "string",
      "duplicated_information": "string",
      "email": "string",
      "data": {
          "update": [
              "kycStatus",
              "idType",
              "issuingCountry",
              "fullName",
              "first_name",
              "last_name",
              "gender",
              "nationality",
              "birthDate",
              "identityNumber",
              "issueDate",
              "expireDate",
              "documentNumber",
              "serialNumber",
              "privacyShield",
              "curpNumber",
              "version",
              "typeOfPermit"
          ],
          "kyc_result": "string",
          "pending_at": "string",
          "reviewer": "string"
      },
      "admin": "string",
      "update_time": "string",
      "age_group": "string",
      "gender": "string",
      "date_of_birth": "string",
      "full_name": "string",
      "full_name_en": "string",
      "first_name" "string",
      "last_name" "string",
      "nationality": "string",
      "userid": "string",
      "tokenId": "string"
  }
  ```

  ```json updated-webhook-knowledge-based.json theme={null}
  {
      "webhook_trigger": "updated",
      "submission_id": "string",
      "duplicated_information": "string",
      "email": "string",
      "data": {
          "update": [
              "fullName",
              "gender",
              "birthDate",
              "nationality",
              "kycStatus",
              "issueDate",
              "identityNumber"
          ],
          "kyc_result": "string",
          "pending_at": "string",
          "reviewer": "string"
      },
      "admin": "string",
      "update_time": "string",
      "gender": "string",
      "date_of_birth": "string",
      "nationality": "string",
      "userid": "string",
      "tokenId": "string",
      "age_group": "N/A",
      "full_name": "string",
      "full_name_en": "string",
      "phoneNumber": "string",
      "ssnNumber": "string"
  }
  ```
</CodeGroup>

<ResponseField name="webhook_trigger" type="string">
  웹훅 이벤트 유형 - `updated`는 사용자 정보가 업데이트되었음을 의미
</ResponseField>

<ResponseField name="submission_id" type="string">
  KYC 제출 건별 고유 식별자
</ResponseField>

<ResponseField name="duplicated_information" type="string">
  이름, 생년월일, 성별, 국적을 기준으로 중복 확인용 식별자가 생성됩니다. (\*네 가지 기준이 모두 제공되면 항상 생성됩니다.)
</ResponseField>

<ResponseField name="email" type="string">
  KYC 제출자 이메일 주소
</ResponseField>

<ResponseField name="data" type="object">
  업데이트된 사용자 데이터를 포함하는 객체

  <Expandable title="update">
    <ResponseField name="update" type="array">
      업데이트된 필드 목록
    </ResponseField>

    <ResponseField name="kyc_result" type="string">
      KYC 검토 결과
    </ResponseField>

    <ResponseField name="pending_at" type="string">
      KYC가 pending 상태로 설정된 시간 (UTC+0, ISO 8601 형식)
    </ResponseField>

    <ResponseField name="reviewer" type="string">
      검토자 유형. `system`은 AI 시스템 검수, `agent`는 인간 검수
    </ResponseField>

    <ResponseField name="kyc_result" type="string">
      KYC 결과가 처음 결정된 UTC 시간. 승인/거부 시에만 제공 (ISO 8601 형식)
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="admin" type="string">
  대시보드에서 업데이트를 수행한 관리자 이메일
</ResponseField>

<ResponseField name="update_time" type="string">
  업데이트가 발생한 시간 (UTC+0, ISO 8601 형식)
</ResponseField>

<ResponseField name="age_group" type="string">
  제출자의 연령대 카테고리
  `minor` : 13세 이하,
  `early-teen`: 14 \~ 15세,
  `teen`: 16 \~ 17세,
  `adult`: 18세 이상
</ResponseField>

<ResponseField name="gender" type="string">
  제출자 성별 ("male" 또는 "female")
</ResponseField>

<ResponseField name="date_of_birth" type="string">
  제출자 생년월일 (YYYY-MM-DD 형식)
</ResponseField>

<ResponseField name="nationality" type="string">
  제출자 국적 (ISO 3166-1 alpha-3 국가 코드)
</ResponseField>

<ResponseField name="userid" type="string">
  고객사에서 정의한 KYC 제출자 고유 식별자
</ResponseField>

<ResponseField name="tokenId" type="string">
  비공개 모드의 라이브 폼 제출 시 사용된 토큰 ID
</ResponseField>

<ResponseField name="full_name" type="string">
  제출자의 전체 이름
</ResponseField>

<ResponseField name="full_name_en" type="string">
  KYC 승인 후 제공되는 영문 Full Name. 이름은 음역(transliteration) 처리되며 의역하지 않습니다. KYC 미승인 또는 미번역 상태는 `null`.
</ResponseField>

<ResponseField name="first_name" type="string">
  제출자의 이름
</ResponseField>

<ResponseField name="last_name" type="string">
  제출자의 가족 이름(성)
</ResponseField>

<ResponseField name="ssnNumber" type="string">
  소셜 시큐리티 넘버 (Social Security Number)\
  \* lowerCamelCase 컨벤션 적용을 위해 ssn 뒤에 Number 를 추가로 기입하였습니다.
</ResponseField>