Sandbox
신원 확인을 위한 Sandbox API 키.
sandbox 키는 프로덕션과 동일한 API, 호스팅 페이지, 웹훅 흐름을 실행하며, 요금이 청구되지 않는 키입니다. 요금을 논의하기 전에 ShieldID가 적합한지 확인하는 가장 빠른 방법입니다.
작동 방식
같은 파이프라인. 다른 키. 청구서 없음.
Sandbox는 단순화된 데모 모드가 아니라, 어떤 키를 보내느냐에 따라서만 구분되는 실제 검증 파이프라인입니다.
| 키 접두사 | vk_sand_…는 인증하는 순간 sandbox 키임을 식별합니다. 별도로 설정해야 하는 sandbox 계정이나 대시보드는 없습니다. |
|---|---|
| 환경 표시 | sandbox 키로 생성된 모든 세션, 결과, 웹훅에는 environment: "sandbox"가 포함되므로, sandbox에서 만들어진 것이 하위 단계에서 실제 검증으로 오인될 일이 없습니다. |
| 청구 | Sandbox 세션은 모든 요금제에서 청구되지 않으며, 통합을 개발하고 테스트하는 데 필요한 만큼 얼마든지 사용할 수 있습니다. |
| 검증 자체 | 실제 검증입니다. 본인의 신분증, 본인의 얼굴, 동일한 검사가 적용됩니다. 별도의 가짜 테스트 문서는 없으며, 직접 본인을 인증하며 제품이 어떻게 동작하는지 확인합니다. |
키 받기
오늘 요청하세요. 셀프 서비스는 곧 제공됩니다.
적격 요금제에서 sandbox 키를 직접 생성하는 셀프 서비스 기능은 계획되어 있으나 아직 일정이 정해지지 않았습니다. 출시 전까지는 문의 양식으로 요청하시면 키를 직접 받으실 수 있습니다.
출시 예정
출시 예정적격 요금제에서 sandbox 키를 직접 생성하는 셀프 서비스 기능은 계획되어 있으나 아직 일정이 정해지지 않았습니다, 가입하자마자 키를 생성하실 수 있습니다.
직접 체험해 보기
본인 휴대폰으로 실행할 수 있는 테스트 시나리오.
가짜 문서는 필요 없습니다. 본인의 신분증으로 다음 시나리오를 실행하여 각 경로가 실제로 어떻게 동작하는지 확인하세요.
깔끔한 통과
세션을 만들고 호스팅 페이지를 연 다음, 본인의 신분증을 촬영하고 라이브니스 확인을 완료하세요. checks.document, checks.liveness, checks.antispoof, checks.face_match가 각각 PASS로 반환되는 것을 확인할 수 있습니다.
카메라 거부
호스팅 페이지에서 카메라 권한을 요청할 때 거부하세요. 세션은 FAILED로 종료되며, failure_reason을 바탕으로 실제 오류 메시지를 구성할 수 있습니다.
실패 후 재시도 (곧 제공 예정)
FAILED 세션의 verification_url을 다시 열어 PENDING으로 되돌리고 두 번째 시도를 하는 기능은 아직 제공되지 않습니다. 현재는 FAILED를 최종 상태로 간주하고, 신청자가 다시 시도하려면 새 세션을 만들어 주세요.
만료된 세션
세션을 만들고 그대로 두세요. 기본 제한 시간이 지나면 EXPIRED 상태가 되며, 사람 정보나 검사 데이터는 없습니다. UI의 시간 초과 안내 메시지를 테스트하기에 좋은 상태입니다.
취소된 세션
PENDING 상태의 세션에 DELETE /v1/sessions/{id}를 호출한 다음 verification_url을 열어 보세요. 앱이 취소된 세션을 오류가 아닌 종료된 상태로 처리하는지 확인하세요.
프랑스어 로케일
locale: "fr"로 세션을 만들고, 프랑스어를 사용하는 신청자에게 호스팅 페이지와 직접 구현한 return URL 처리가 올바르게 표시되는지 확인하세요.
제한 사항
Sandbox가 하지 않는 것.
깨알 같은 약관 대신 솔직한 답변.
- Sandbox에는 프로덕션과 별도의 요청 제한이 없습니다. 현재 요금제 수준의 제한으로 조절되는 요청은 전혀 없으며, 해당 적용은 아직 제공되지 않습니다.
- Sandbox와 프로덕션은 별도의 계정, 대시보드, 문서 세트가 아니라 오직 키 접두사로만 구분됩니다.
- Sandbox 세션도 실제 문서에 대한 실제 검증입니다. 테스트를 위해 다른 사람의 신분증을 사용하지 말고 본인 신분증으로 검증하세요.
문의
Sandbox FAQ.
키 받기
Sandbox 키를 요청하세요.
어떤 서비스를 만들고 계신지 알려 주시면 테스트를 시작할 수 있도록 키를 발급해 드립니다.
Sandbox 세션에는 요금이 청구되지 않습니다.