> ## 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.

# Data Injection (데이터 주입)

> 이 이벤트는 KYC 시스템에 추가 데이터가 주입될 때 트리거됩니다. 주로 주소 정보와 같은 특정 데이터 타입의 추가나 갱신을 위해 사용됩니다. 이 이벤트를 통해 KYC 프로필의 데이터 보강 과정을 추적하고, 관련 시스템을 업데이트할 수 있습니다.

<Note>
  Injection 시 cf1 \~ cf3 값이 있었다면 Injection webhook 응답에 cf1 \~ cf3 이 포함되어 옵니다. 다만 이미 cf1 \~ cf3 정보가 있는 Submission 의 경우, Injection webhook 응답에선 cf1 \~ cf3 의 정보를 다시 보여주지 않습니다.
</Note>

<CodeGroup>
  ```json injection-pass.json theme={null}
  {
      "webhook_trigger": "injection",
      "action": {
          "type": "address",
          "created_at": "YYYY-MM-DD-HH-MM-SS-ZZZ"
      },
      "submission_id": "{submission_id}",
      "email": "email@email.com",
      "kyc_status": "approved",
      "applicant_id": "{applicant_id}",
      "userid": "{userid}",
      "cf1": "{custom_field1}",
      "cf2": "{custom_field2}",
      "cf3": "{custom_field3}",
      "tokenId": "{token_id}"
  }
  ```

  ```json injection-fail-distance.json theme={null}
  {
      "webhook_trigger": "injectionFail",
      "action": {
          "type": "address",
          "created_at": "YYYY-MM-DD-HH-MM-SS-ZZZ",
          "failCode": "distanceChecks_ipGeo"
      },
      "submission_id": "{submission_id}",
      "email": "email@email.com",
      "kyc_status": "approved",
      "applicant_id": "{applicant_id}",
      "userid": "{user_id}",
      "duplicated_information": "{encrypted_duplicated_information}"
  }
  ```

  ```json injection-fail-blacklist.json theme={null}
  {
      "webhook_trigger": "injectionFail",
      "action": {
          "type": "address",
          "created_at": "YYYY-MM-DD-HH-MM-SS-ZZZ",
          "failCode": "blackliskCountries"
      },
      "submission_id": "{submission_id}",
      "email": "email@email.com",
      "kyc_status": "approved",
      "applicant_id": "{applicant_id}",
      "userid": "{user_id}",
      "duplicated_information": "{encrypted_duplicated_information}"
  }
  ```
</CodeGroup>

<ResponseField name="webhook_trigger" type="string">
  웹훅 이벤트 유형 - `injection`은 데이터 주입 이벤트를 나타냄
</ResponseField>

<ResponseField name="action" type="object">
  데이터 주입 작업에 대한 정보를 포함하는 객체

  <Expandable title="properties">
    <ResponseField name="type" type="string">
      주입되는 데이터의 유형 (예: "address")
    </ResponseField>

    <ResponseField name="created_at" type="string">
      데이터 주입 작업이 실행된 UTC 시간 (ISO 8601 형식)
    </ResponseField>

    <ResponseField name="failCode" type="string">
      실패가 발생된 경우 원인이 되는 코드가 표기
    </ResponseField>
  </Expandable>
</ResponseField>

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

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

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

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

<ResponseField name="applicant_id" type="string">
  중복 제출을 확인하기 위해 부여되는 고유 식별 ID로, KYC 상태가 승인일 때만 전달 됩니다.
</ResponseField>

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

<ResponseField name="cf1" type="string">
  사용자 정의 필드 1의 값
</ResponseField>

<ResponseField name="cf2" type="string">
  사용자 정의 필드 2의 값
</ResponseField>

<ResponseField name="cf3" type="string">
  사용자 정의 필드 3의 값
</ResponseField>

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