Saltar al contenido principal

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.

En algunos dispositivos Android (especialmente ROMs personalizadas de fabricantes chinos) o navegadores dentro de la aplicación (WebView), la cámara puede no abrirse en la pantalla “Captura de ID > Inicializando cámara…”. Verifique las causas y soluciones a continuación en orden y, si la cámara sigue fallando dentro de un WebView, use la ruta de omisión para continuar en un navegador estándar.

​
Comprensión del problema

Cuando la cámara no se abre en un entorno WebView o Android, generalmente se debe a una de las siguientes causas.
  • Cámara bloqueada en el navegador dentro de la aplicación (WebView): Algunos navegadores dentro de aplicaciones y navegadores predeterminados de dispositivos chinos bloquean el acceso a la cámara (getUserMedia) dentro del WebView. Si llega a la pantalla de la cámara pero no aparece ningún icono de cámara en uso en la parte superior, la cámara está bloqueada en ese entorno.
  • Android System WebView desactualizado: En un entorno APK WebView, una versión antigua de Android System WebView puede impedir que getUserMedia funcione, por lo que la cámara nunca se inicializa.
  • Permiso no concedido: Si el permiso del dispositivo (sistema operativo) o el permiso del navegador (sitio) está desactivado, la cámara no se iniciará. En los dispositivos chinos, ambos permisos deben concederse por separado.
  • Otros factores del entorno: Varias pestañas abiertas en el mismo navegador mientras la cámara está en uso, o una aplicación de seguridad/MDM instalada en el dispositivo que restringe el uso de la cámara.

​
Soluciones

​
1. Espere un momento si la inicialización de la cámara es lenta

Al cambiar a la pantalla de captura de ID, la inicialización de la cámara puede retrasarse unos segundos según el rendimiento del dispositivo. Aunque la pantalla no aparezca de inmediato, espere un momento y continuará al siguiente paso normalmente.

​
2. Use un navegador estándar como Chrome

Los navegadores dentro de aplicaciones (WebView) y algunos navegadores predeterminados de dispositivos chinos pueden bloquear la cámara. Si no aparece ningún icono de cámara en la parte superior de la pantalla de la cámara, vuelva a abrir la página en el navegador Chrome y continúe.
La cámara también puede fallar en navegadores abiertos desde dentro de aplicaciones como KakaoTalk, Facebook o Instagram. En ese caso, siga la guía Continuar en un navegador estándar a continuación.

​
3. Verifique los permisos de cámara (dispositivo + navegador)

En Android, incluidos los dispositivos chinos, tanto el permiso del dispositivo (sistema operativo) como el permiso del navegador (sitio) deben estar permitidos para que la cámara se inicie. Si alguno está desactivado, la cámara no se inicializará. Para los pasos detallados para volver a habilitar los permisos, consulte Cómo habilitar el permiso de cámara.

​
4. Mantenga abierta solo una pestaña del navegador

Si hay dos o más pestañas abiertas en el mismo navegador mientras la cámara está en uso, es posible que la cámara no funcione correctamente. Cierre todas las demás pestañas, mantenga solo una e intente de nuevo.

​
5. Verifique las aplicaciones que bloquean la cámara

Una aplicación de seguridad corporativa o una aplicación MDM (Mobile Device Management) puede restringir el uso de la cámara. Las aplicaciones de seguridad internas de algunos fabricantes son un ejemplo común. Desactive la aplicación e intente de nuevo.

​
6. Actualice Android System WebView (APK WebView)

Si la cámara no se inicializa en un entorno APK WebView, actualice Android System WebView y Chrome a la última versión desde Google Play y luego intente de nuevo.
Esto es especialmente probable en dispositivos con una versión de sistema operativo/WebView fija, como los dispositivos de banco de pruebas. La compatibilidad con getUserMedia depende de la versión de WebView, por lo que la actualización por sí sola a menudo lo resuelve.

​
7. Continuar en un navegador estándar (omisión de WebView)

Si la cámara sigue sin abrirse dentro del navegador de la aplicación (WebView) después de los pasos anteriores, puede finalizar la verificación abriendo el mismo enlace de ID Check en un navegador estándar.
1

Obtenga el enlace de ID Check del servicio

Pida al servicio (su proveedor) que reenvíe el enlace de ID Check (LiveForm) por SMS, correo electrónico, etc. Si la pantalla de la aplicación ofrece una opción «Abrir en el navegador predeterminado», puede usarla en su lugar.
2

Ábralo en un navegador estándar como Chrome / Safari

Pegue el enlace en la barra de direcciones del navegador predeterminado del teléfono (Android: Chrome, iOS: Safari) y ábralo.
3

Complete la verificación

Finalice la verificación (captura de ID, selfie, etc.) hasta el final. El resultado se refleja en el servicio igual que antes.
Para integradores (el proveedor)
  • Para gestionar a los usuarios que se quedan atascados en la cámara dentro de una aplicación (WebView), proporcione una ruta para entregar el enlace de ID Check a un navegador externo (por ejemplo, reenvío por SMS/correo electrónico, un botón «Abrir en el navegador predeterminado» o un código QR).
  • Al volver a abrir externamente, use siempre el navegador predeterminado del sistema. Volver a abrir en un navegador integrado como Custom Tabs o SFSafariViewController puede reproducir el mismo problema de cámara.
  • El resultado de la verificación se entrega a través de Webhook y la Return URL (kycStatus / errorCode), por lo que su servicio aún recibe el resultado incluso cuando el usuario completa la verificación en un navegador externo.
Precaución al usar enlaces de un solo uso (token)Un enlace con tokenId (Private Mode) o startValidUntil caduca 3 minutos después del primer uso, o una vez que ya existe un envío con un resultado de KYC decidido (aprobado/rechazado/pendiente): volver a abrir el mismo enlace en un navegador enviará al usuario a una página de error. En ese caso, el proveedor debe emitir un nuevo enlace para el reintento en el navegador. Un enlace ?pid= simple se vuelve a abrir normalmente como un nuevo envío. Si necesita mantener la misma identidad de usuario, vuelva a emitirlo con los mismos parámetros, como userid / cf1.

​
Si el problema persiste

Si los métodos anteriores no resuelven el problema:
  1. Reinicie el dispositivo: Apague el dispositivo por completo y vuelva a encenderlo.
  2. Pruebe otro navegador estándar: Intente de nuevo en otro navegador estándar como Chrome o Safari.
  3. Contacte a soporte: Si el problema persiste, contacte a soporte al cliente.
Para el rango de dispositivos/navegadores verificados, consulte Navegadores y Dispositivos Recomendados. Los dispositivos con Android inferior a 9 no son compatibles.