Proteja a los menores, garantice el cumplimiento legal y haga crecer su negocio de forma segura
Documentación para desarrolladores | API y guía de integración - Visión general
Visión general
Bienvenido a la documentación para desarrolladores de Go.cam.
Esta sección proporciona un recorrido completo por el servicio Go.cam, incluyendo detalles sobre cómo funciona y una guía paso a paso para integrarlo en su plataforma.
Primeros pasos
Antes de comenzar el proceso de implementación, deberá crear una cuenta Go.cam. Una cuenta activa le otorga acceso como socio y le permite configurar los ajustes necesarios para la integración. La activación de la cuenta suele tardar menos de 24 horas.
Métodos de verificación
Go.cam ofrece cuatro métodos de verificación diseñados para garantizar que los usuarios no sean menores de edad:
- Validación de tarjeta de crédito
- Detección de edad por selfie
- Extracción de edad de documento de identidad
- Verificación por correo electrónico
- Documento de identidad NFC
Los usuarios finales pueden completar la verificación utilizando cualquiera de los métodos disponibles.
Flujo de verificación
El proceso de verificación de Go.cam se puede ver desde dos perspectivas: la experiencia del usuario final y la lógica de integración del socio.
1. Flujo del usuario final
Fig: Diagrama de flujo de verificación del usuario
Pasos de verificación del usuario (ver Diagrama de flujo de verificación del usuario):
- 1. El usuario visita un sitio asociado protegido por el sistema de verificación de edad de Go.cam.
- 2. El usuario inicia la verificación haciendo clic en el botón "Verificar edad".
- 3. Dependiendo de la integración del socio, el usuario podrá:
- Ser redirigido a una página de verificación alojada por Go.cam, o
- Interactuar con una superposición de iframe que carga el flujo de verificación de Go.cam.
- 4. El usuario selecciona uno de los métodos de verificación disponibles:
- Validación de tarjeta de crédito
- Detección de edad por selfie
- Extracción de edad de documento de identidad
- Verificación por correo electrónico
- Documento de identidad NFC
- 5. El usuario proporciona la información requerida (por ejemplo, detalles de la tarjeta de crédito, acceso a la cámara web, imagen del documento de identidad o una dirección de correo electrónico).
- 6. Al finalizar, Go.cam muestra el resultado:
- Página de éxito: incluye un botón para volver al sitio del socio.
- Página de fallo: incluye una opción "Reintentar" y un código QR para continuar la verificación en un dispositivo móvil. Si tiene éxito, se validará la sesión del dispositivo original.
- 7. Después de una verificación exitosa, el usuario es redirigido a la URL de retorno configurada, desbloqueando el sitio del socio.
2. Integración del socio con lógica de redirección
Fig: Diagrama de lógica de redirección
Flujo de redirección (ver Diagrama de lógica de redirección):
- 1. El usuario accede al sitio del socio e inicia la verificación de edad.
- 2. El socio genera una URL de verificación de Go.cam utilizando el SDK, proporcionando:
- Clave de cifrado y clave HMAC
- Metadatos del usuario (por ejemplo, userId)
- 3. El usuario es redirigido a Go.cam para completar el proceso de verificación.
- 4. El usuario selecciona y completa uno de los métodos de verificación.
- 5. Go.cam muestra una página de éxito o de fallo.
- 6. Los resultados se procesan de la siguiente manera:
- Los resultados de la verificación se almacenan en Go.cam.
- Go.cam envía los resultados a la URL de callback de resultados de verificación configurada, junto con los datos de usuario proporcionados (por ejemplo, userId).
- Se crea una cookie en Go.cam con una versión cifrada de los datos de verificación, que puede ser descifrada posteriormente utilizando las claves del socio.
- 7. En caso de éxito, el usuario es redirigido a la URL de retorno, desbloqueando el sitio del socio.
3. Integración del socio con lógica de Iframe
Fig: Diagrama de lógica de Iframe
Flujo de Iframe (ver Diagrama de lógica de Iframe):
- 1. El usuario accede al sitio del socio e inicia la verificación de edad.
- 2. El socio genera una URL de verificación de Go.cam utilizando el SDK, proporcionando:
- Clave de cifrado y clave HMAC
- Metadatos del usuario (por ejemplo, userId)
- 3. Utilizando el SDK de frontend, el socio activa la superposición de iframe para cargar la instancia de verificación de Go.cam.
- 4. Una vez que el iframe se carga:
- Un evento confirma la inicialización.
- Si ya existe una cookie de verificación de Go.cam, un evento separado notifica al socio (la integridad de la cookie debe ser validada).
- 5. El usuario selecciona y completa uno de los métodos de verificación.
- 6. Go.cam muestra una página de éxito o de fallo:
- Página de éxito: cierra la superposición de iframe.
- Página de fallo: permite reintentar.
- 7. Los resultados se procesan de la siguiente manera:
- Los resultados de la verificación se almacenan en Go.cam.
- Go.cam envía los resultados a la URL de callback de resultados de verificación configurada, junto con los datos de usuario proporcionados (por ejemplo, userId).
- Se crea una cookie en Go.cam con datos de verificación cifrados, descifrables mediante las claves del socio.
- Un evento JavaScript anuncia el éxito de la verificación, permitiendo al socio validar la cookie almacenada.
- 8. En caso de éxito, la superposición de iframe se elimina, desbloqueando el sitio del socio.
Terminología
- Socio: Usted, el integrador que implementa Go.cam en su plataforma.
- Clave de cifrado / Clave HMAC: Claves disponibles en su cuenta Go.cam, utilizadas para cifrar y validar los datos de verificación.
- URL de callback de resultados de verificación: Endpoint definido en su cuenta Go.cam donde se publican los resultados de la verificación.
- URL de retorno: URL definida a través del SDK de Go.cam para redirigir a los usuarios después de una verificación exitosa.
Tipos de verificación
Go.cam ofrece múltiples métodos de verificación para garantizar que los usuarios cumplan con los requisitos de edad. Cada método está diseñado teniendo en cuenta la privacidad, la seguridad y el cumplimiento.
1. Verificación con tarjeta de crédito
- El usuario es redirigido temporalmente a un entorno seguro, donde se le pide que introduzca su número de tarjeta de crédito y fecha de caducidad.
- No se realizan cargos. Solo se comprueba la validez y la integridad de la tarjeta.
- Este es el único método de verificación que envía datos al backend. El procesamiento se realiza en un entorno compatible con PCI DSS.
- Go.cam no almacena ni reenvía los detalles de la tarjeta a terceros.
2. Verificación de edad por selfie
- Requiere acceso a la cámara web para capturar el rostro del usuario en tiempo real.
- Un modelo de aprendizaje automático se ejecuta localmente en el dispositivo; no se cargan ni almacenan imágenes.
- El proceso:
- 1. El usuario alinea su rostro en el centro de la pantalla.
- 2. Se toman múltiples fotografías. Se descartan los valores atípicos y se calcula una edad promedio predicha.
- 3. Las comprobaciones de consistencia facial aseguran que la misma persona permanezca frente a la cámara.
- 4. También se presenta una medida de vivacidad, pidiendo al usuario que realice acciones específicas según su posición actual.
- Si se detecta que el usuario es menor de edad, el proceso pasa automáticamente a la verificación de documento de identidad:
- Las tomas faciales se comparan con la foto del documento.
- Si la coincidencia es exitosa, la fecha de nacimiento se extrae del documento para confirmar la edad.
- Si el usuario es verificado como adulto, el proceso se completa con éxito. De lo contrario, el usuario puede reintentar dentro de una ventana de sesión de 10 minutos antes de la expiración.
Certificación
- Go.cam cuenta con la certificación Challenge 25: las personas mayores de 18 años que parezcan menores de 25 pueden tener que presentar un documento de identidad.
- Certificado por:
- Asociación de Sitios que Abogan por la Protección Infantil
- El proveedor global líder de soluciones de alojamiento web de alto rendimiento en infraestructuras de alojamiento Cloud, VPS y Dedicado.
- Autoridad Central para la Supervisión y Protección de Menores en Internet en Alemania
- Esquema de Certificación de Verificación de Edad
- La verificación de edad funciona con un modelo de reconocimiento facial de código abierto. [Más información aquí].
3. Verificación de documento de identidad
- El usuario selecciona un país y un tipo de documento (tarjeta de identidad, pasaporte o licencia de conducir).
- Regiones soportadas: todos los países europeos y los Estados Unidos.
- La verificación se puede completar utilizando:
- Una foto de cámara web, o
- Una imagen cargada localmente.
- Las imágenes se procesan localmente en el dispositivo; nada se carga a los servidores de Go.cam.
- Si no se realizó una verificación por selfie previamente, solo se extrae la fecha de nacimiento. La edad actual se calcula y se compara con la mayoría de edad legal del país.
- La extracción de texto de documentos utiliza un modelo OCR de código abierto. [Más información aquí].
4. Verificación por correo electrónico
- Verifica la edad del usuario basándose en la actividad histórica del correo electrónico.
- El sistema comprueba si la dirección de correo electrónico proporcionada apareció en una filtración de datos hace al menos 13 años.
- Suposición: si el correo electrónico existía hace 13 años, el usuario debe tener al menos 20 años (edad mínima de 7 para crear el correo electrónico + 13 años).
- Para confirmar la propiedad, se envía un código de validación a la dirección proporcionada, que el usuario debe introducir en la ventana de verificación.
5. Documento de identidad NFC
- Requiere un dispositivo móvil (iOS o Android) con capacidad NFC para leer el chip biométrico de un pasaporte electrónico o tarjeta de identidad electrónica nacional, junto con acceso a la cámara para escanear la Zona de Lectura Mecánica (MRZ) del documento.
- Todos los datos del documento, retratos del chip y comparaciones faciales se procesan localmente en el dispositivo en memoria volátil; no se cargan ni almacenan detalles de identificación, fotos o datos biométricos.
El proceso:
- El usuario abre el flujo de verificación móvil (mediante código QR, enlace profundo o App Clip), que transporta de forma segura la referencia de la sesión y el descriptor facial del selfie en vivo.
- El usuario escanea la MRZ del documento con la cámara para obtener la clave de acceso al chip.
- El usuario sostiene el documento contra la antena NFC del dispositivo. La aplicación se autentica con el chip a través de BAC/PACE y lee los datos personales (DG1) y la foto del retrato (DG2).
- La fecha de nacimiento y el país emisor extraídos del chip se verifican localmente contra la mayoría de edad aplicable (18+ por defecto, o umbrales específicos del país).
- Un modelo local de aprendizaje automático compara la foto del retrato del chip con el descriptor del selfie en vivo del usuario para confirmar que el documento pertenece al usuario.
Simple, seguro y sin costes de configuración
Proteja a los menores, garantice el cumplimiento legal y haga crecer su negocio de forma segura