메인 콘텐츠로 건너뛰기

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.

일부 Android 기기(특히 중국 제조사 커스텀 ROM)나 인앱 브라우저(웹뷰) 환경에서 “신분증 촬영 > 카메라 초기화 중…” 화면에서 카메라가 열리지 않을 수 있습니다. 아래 원인과 해결 순서를 확인하고, 웹뷰에서 계속 막히는 경우 일반 브라우저로 이어서 진행하는 우회 경로를 사용하세요.

​
문제 원인 확인

웹뷰·Android 환경에서 카메라가 열리지 않는 경우는 대부분 다음 중 하나입니다.
  • 인앱 브라우저(웹뷰)의 카메라 차단: 일부 앱 내장 브라우저나 중국 제조사 기본 브라우저는 웹뷰에서 카메라(getUserMedia) 접근을 자체적으로 막습니다. 카메라 화면으로 전환됐는데 화면 상단에 카메라 사용 아이콘이 표시되지 않으면 해당 환경에서 카메라가 차단된 상태입니다.
  • 구형 Android System WebView: APK 웹뷰 환경에서 Android System WebView 버전이 낮으면 getUserMedia 호출이 동작하지 않아 카메라가 초기화되지 않을 수 있습니다.
  • 권한 미허용: 기기(OS) 권한과 브라우저(사이트) 권한 중 하나라도 꺼져 있으면 카메라가 실행되지 않습니다. 중국 기기는 두 권한을 각각 허용해야 합니다.
  • 기타 환경 요인: 카메라 사용 중 동일 브라우저에 탭을 여러 개 열어둔 경우, 또는 기기에 카메라 사용을 제한하는 보안/MDM 앱이 설치된 경우.

​
해결 방법

​
1. 카메라 초기화가 느릴 때는 잠시 대기

신분증 촬영 화면으로 전환될 때 기기 성능에 따라 카메라 초기화가 몇 초간 지연될 수 있습니다. 화면이 바로 나오지 않더라도 잠시 기다리면 정상적으로 다음 단계로 진행됩니다.

​
2. Chrome 등 표준 브라우저 사용

인앱 브라우저(웹뷰)나 일부 중국 제조사 기본 브라우저는 카메라를 차단할 수 있습니다. 카메라 화면 상단에 카메라 아이콘이 보이지 않는다면 Chrome 브라우저에서 페이지를 다시 열어 진행하세요.
카카오톡·페이스북·인스타그램 등 앱 내부에서 열린 브라우저에서도 카메라가 동작하지 않을 수 있습니다. 이 경우 아래 일반 브라우저로 이어서 진행 안내를 따르세요.

​
3. 카메라 권한 확인 (기기 + 브라우저)

중국 기기를 포함해 Android에서는 기기(OS) 권한과 브라우저(사이트) 권한을 모두 허용해야 카메라가 실행됩니다. 한쪽이라도 꺼져 있으면 카메라가 초기화되지 않습니다. 권한을 다시 켜는 자세한 방법은 카메라 권한 허용 방법을 참고하세요.

​
4. 브라우저 탭은 하나만 유지

카메라가 실행 중인 상태에서 동일 브라우저에 탭을 2개 이상 열면 카메라가 정상 동작하지 않을 수 있습니다. 다른 탭을 모두 닫고 하나만 유지한 뒤 다시 시도하세요.

​
5. 카메라 차단 앱 확인

기업용 보안 앱이나 MDM(기기 관리) 앱이 설치되어 있으면 카메라 실행이 제한될 수 있습니다. 일부 제조사의 사내 보안 앱이 대표적인 예입니다. 해당 앱을 비활성화한 뒤 다시 시도하세요.

​
6. Android System WebView 업데이트 (APK 웹뷰)

APK 웹뷰 환경에서 카메라가 초기화되지 않으면, Google Play에서 Android System WebView와 Chrome을 최신 버전으로 업데이트한 뒤 다시 시도하세요.
테스트베드처럼 OS·WebView 버전이 고정된 기기에서 특히 발생할 수 있습니다. getUserMedia 지원은 WebView 버전에 의존하므로, 업데이트만으로 해결되는 경우가 많습니다.

​
7. 일반 브라우저로 이어서 진행 (웹뷰 우회)

위 방법으로도 인앱 브라우저(웹뷰)에서 카메라가 계속 열리지 않으면, 동일한 ID Check 링크를 일반 브라우저에서 열어 인증을 마칠 수 있습니다.
1

고객사로부터 ID Check 링크 받기

사용 중인 서비스(고객사)에서 ID Check(LiveForm) 링크를 SMS·이메일 등으로 다시 전달받습니다. 앱 화면에 「기본 브라우저에서 열기」 옵션이 있다면 이를 사용해도 됩니다.
2

Chrome / Safari 등 일반 브라우저에서 열기

전달받은 링크를 휴대폰 기본 브라우저(Android: Chrome, iOS: Safari)의 주소창에 붙여넣어 엽니다.
3

인증 완료

신분증 촬영·셀피 등 인증을 끝까지 진행합니다. 결과는 기존과 동일하게 서비스에 반영됩니다.
고객사(통합) 담당자 안내
  • 사용자가 앱(웹뷰)에서 카메라 문제로 막히는 경우를 대비해, ID Check 링크를 외부 브라우저로 전달할 수 있는 경로(예: SMS/이메일 재발송, 「기본 브라우저에서 열기」 버튼, QR 표시)를 제공하세요.
  • 외부로 다시 열 때는 반드시 시스템 기본 브라우저로 여세요. Custom Tabs · SFSafariViewController 등 임베디드 브라우저로 다시 열면 동일한 카메라 문제가 재현될 수 있습니다.
  • 인증 결과는 Webhook과 Return URL(kycStatus / errorCode)로 전달되므로, 사용자가 외부 브라우저에서 인증을 완료해도 서비스에서 결과를 받을 수 있습니다.
1회성 링크(토큰) 사용 시 주의tokenId(Private Mode)나 startValidUntil이 적용된 링크는 최초 사용 후 3분이 지나거나, 이미 처리된 제출(승인·거부·보류)이 있는 경우 만료되어, 같은 링크를 브라우저에서 다시 열면 오류 페이지로 이동합니다. 이 경우 고객사에서 브라우저 재시도용 링크를 새로 발급해 전달해야 합니다. 일반 ?pid= 링크는 다시 열어도 새 제출로 정상 진행됩니다. 사용자 식별이 필요하면 userid · cf1 등 동일 파라미터로 재발급하세요.

​
문제가 계속되면

위 방법으로도 해결되지 않는다면:
  1. 기기 재시작: 기기를 완전히 끄고 다시 켜보세요.
  2. 다른 일반 브라우저에서 시도: Chrome 또는 Safari 등 다른 표준 브라우저에서 다시 진행해보세요.
  3. 고객센터 문의: 문제가 지속되면 담당 고객센터로 문의해 주세요.
검증된 기기·브라우저 범위는 권장 브라우저 및 기기를 참고하세요. Android 9 미만 기기는 지원되지 않습니다.