각 세션 상태가 의미하는 것
검증 세션은 Not Started, In Progress, In Review, Approved, Declined와 같은 상태를 거쳐 진행됩니다 - 각각 무엇을 의미하는지, 무엇을 해야 하는지, 그리고 판정이 확정된 세션도 왜 다시 바뀔 수 있는지를 안내합니다.
상태는 총 10가지입니다. Approved, Declined, Kyc Expired는 판정이 내려졌다는 뜻이지만, 그중 어느 것도 영구히 불변하지는 않습니다. 리뷰어가 판정을 다시 열 수도 있고, 상시 AML 모니터링이 나중에 승인된 세션을 움직일 수도 있습니다. In Review는 사람의 처리가 필요한 유일한 상태입니다. 세션이 판정된 후에도 업데이트 처리를 계속하세요.
모든 검증 세션에는 프로세스의 어느 단계에 있는지 알려주는 상태가 있습니다. 각 상태가 평이한 말로 무엇을 의미하는지, 그리고 여러분 쪽에서 뭔가 해야 할 일이 있는지 안내합니다.
#세션 상태를 확인하는 곳
비즈니스 콘솔의 사이드바에서 Verifications로 이동해 확인하려는 세션을 여세요. 상태는 실행된 각 검사의 결과와 함께 상단에 표시됩니다.
- Overview에는 세션의 현재 상태와 그 이유가 표시됩니다.
- 각 검사에는 자체 탭이 있고, 각각 자체 결과를 가집니다.
- Events는 타임라인입니다. 이 세션이 거쳐온 모든 상태를 타임스탬프와 함께 확인할 수 있습니다.
#각 상태 설명
| 상태 | 의미 | 대응 필요 여부 |
|---|---|---|
| Not Started | 생성되었지만 아직 링크가 열리지 않음. | 아니요 - 기다리거나 리마인드하세요. |
| In Progress | 사용자가 검사를 적극적으로 진행 중. | 아니요 - 저절로 해결됩니다. |
| Approved | 모든 검사 통과 - 신원 확인 완료. | 아니요. |
| Declined | 하나 이상의 검사 실패. 검증이 거절된 이유를 확인하세요. | 재제출을 요청하고 싶을 때만. |
| In Review | 낮은 점수, 데이터 불일치, AML 히트 등으로 사람의 판단을 위해 플래그됨. | 예 - 승인, 거절, 또는 재제출 요청. |
| Resubmitted | 리뷰어가 특정 단계를 다시 하도록 요청함. 완료되면 재평가됨. | 아니요. |
| Awaiting User | KYB 전용 - 연결된 관계자들이 각자의 검증을 마치기를 기다리는 중. | 아니요. |
| Expired | 열리기 전에 링크가 만료됨. | 예 - 새 세션을 만드세요. |
| Abandoned | 열렸지만 제 시간에 완료되지 않음. | 선택 - 리마인드하거나 새 세션을 만드세요. |
| Kyc Expired | 이전에 승인된 세션이 재검증 기간을 지남. | 예 - 다시 검증하도록 요청하세요. |
#어느 것이 판정이 확정된 상태인가
| 카테고리 | 상태 | 의미 |
|---|---|---|
| 판정 확정 | Approved, Declined, Kyc Expired | 판정이 존재합니다. 반드시 영구적이지는 않습니다 - 아래 참조. |
| 아직 진행 중 | Not Started, In Progress, Resubmitted, Awaiting User | 사용자, 하위 세션, 또는 처리 과정을 기다리는 중입니다. |
| 여러분의 처리 필요 | In Review | 여러분 팀의 판단이 필요합니다. |
| 판정 없이 종료 | Expired, Abandoned | 사용자가 완료하지 않았습니다. |
판정이 확정된 세션도 여전히 바뀔 수 있습니다. 세션이 Approved나 Declined에 도달했다고 해서 해당 세션의 업데이트 처리를 멈추지 마세요.
- 리뷰어가 사용자에게 단계를 다시 하도록 요청하면 Declined는 Resubmitted가 되었다가 이후 Approved가 될 수 있습니다.
- 상시 AML 모니터링이 임곗값을 넘는 새 히트를 발견하면 Approved는 나중에 In Review나 Declined가 될 수 있습니다.
- 만료 정책을 설정했다면 Approved는 Kyc Expired가 될 수 있습니다.
정말로 다시는 바뀌지 않는 상태는 Expired와 Abandoned뿐입니다. 사용자가 흐름을 완료하지 않았으므로 다시 살펴볼 것이 없기 때문입니다. 그 외의 모든 상태는 여러분의 연동이 계속 업데이트를 받을 수 있도록 준비해 두어야 하는 상태입니다.
#상태 간 이동 방식
- Not Started → In Progress(링크를 열면), 또는 → Expired(끝내 열지 않으면).
- In Progress → Approved, Declined, In Review, 또는 Abandoned. KYB에서는 핵심 인물 단계가 제출되면 Awaiting User로 갈 수도 있습니다.
- In Review → Approved, Declined, 또는 Resubmitted. 항상 리뷰어의 조치에 의해서만 발생합니다.
- Declined → Resubmitted. 리뷰어가 다시 시도를 요청하면.
- Resubmitted → Approved, Declined, 또는 In Review. 사용자가 단계를 다시 완료한 후에.
- Awaiting User → Approved, Declined, 또는 In Review. 필요한 모든 관계자의 판정이 확정된 후에.
- Approved → Kyc Expired. KYC 만료 정책이 적용되는 경우.
API나 webhook에서 상태는 대소문자를 구분하는, 공백을 포함한 정확한 문자열입니다. 예를 들어 "in_review"나 "IN_REVIEW"가 아니라 "In Review"입니다. 비교할 때는 엄격한 동등 비교를 사용하세요.
주의할 예외가 하나 있습니다. 만료 상태는 "KYC Expired"가 아니라 K만 대문자인 "Kyc Expired"입니다.
전체 레퍼런스: verification statuses.
#문제처럼 보이지만 문제가 아닌 상태들
- 움직이지 않는 In Progress. 사용자가 단순히 아직 끝내지 않은 것뿐입니다. 세션을 빨리 감기할 방법은 없으며, 남은 단계를 완료하면 업데이트됩니다.
- KYB 세션의 Awaiting User. 예상된 상태입니다. 기업이 관계자 목록을 제출했고, 부모 세션은 각 사람이 판정될 때까지 기다리고 있습니다. 부모 세션이 아니라 하위 세션을 지켜보세요.
- Resubmitted가 다시 Awaiting User로 돌아감. KYB에서 하위 세션이 재제출되면, 부모 세션은 완료될 때까지 Awaiting User로 돌아갑니다.
#자체 상태에 매핑하기
자체적으로 상태를 저장하고 있다면, 정확히 맞춰야 할 매핑이 두 가지 있습니다.
- Abandoned와 Awaiting User는 재제출이 아닙니다. Resubmitted는 리뷰어가 단계를 다시 하도록 요청했다는 것을 구체적으로 의미하고, Abandoned는 사용자가 떠났다는 것을, Awaiting User는 다른 관계자들이 아직 검증 중이라는 것을 의미합니다.
- Expired와 Kyc Expired는 다릅니다. Expired는 링크가 한 번도 열리지 않았다는 뜻입니다. Kyc Expired는 승인된 검증이 여러분의 정책상 유효 기간을 넘겼다는 뜻입니다. 즉 그 사람은 한 번 검증되었고, 이제 다시 검증받아야 한다는 의미입니다.
#다음 단계
- In Review: 심사에 머물러 있는 세션과 줄이는 방법을 확인하세요.
- In Review 또는 Declined: 검증을 다시 시도하게 하기를 확인하세요.
- Declined: 검증이 거절된 이유를 확인하세요.
- 상태를 백엔드에 자동으로 전달받기: webhook으로 검증 결과 받기를 확인하세요.