DocumentaciónReferencia de configuración

Security > Google reCAPTCHA Storefront

Última actualización: 8 de octubre de 2026

Creado para:

  • Intermedio
  • Principiante
  • Usuario
  • Administrador
  • Desarrollador
IMPORTANT
Para poder configurar Google reCAPTCHA, debe asegurarse de que el archivo PHP.ini incluya la siguiente configuración: allow_url_fopen = 1. Esto puede requerir la asistencia del desarrollador. Consulte Configuración de PHP en la Guía de instalación.

Para acceder a las opciones de configuración de la tienda, elige Stores > Settings>Configuration​en la barra lateral de_ Admin _.

Para obtener más información acerca del uso de Google reCAPTCHA para proteger su tienda, consulte Google reCAPTCHA en la Guía de sistemas de administración.

reCAPTCHA v2 (“I am not a robot”)

reCAPTCHA v2 ("No soy un robot")

Campo
Ámbito
Descripción
Google API Website Key
Sitio web
Clave del sitio web que se crea al registrar la cuenta de Google reCAPTCHA.
Google API Secret Key
Sitio web
La clave secreta asociada a su cuenta de Google reCAPTCHA.
Size
Sitio web
El tamaño del cuadro reCAPTCHA de Google que aparece cuando un cliente inicia sesión en su cuenta. Opciones: Normal (predeterminado) / Compact
Theme
Sitio web
Determina el estilo del cuadro reCAPTCHA de Google. Opciones: Light Theme (predeterminado) / Dark Theme
Language Code
Vista de tienda
El código de dos caracteres que especifica el idioma que se usa para el texto y los mensajes de Google reCAPTCHA.

reCAPTCHA v2 Invisible

reCAPTCHA v2 invisible

Campo
Ámbito
Descripción
Google API Website Key
Sitio web
Clave del sitio web que se crea al registrar la cuenta de Google reCAPTCHA.
Google API Secret Key
Sitio web
La clave secreta asociada a su cuenta de Google reCAPTCHA.
Invisible Badge Position
Sitio web
La posición del distintivo reCAPTCHA invisible en cada página. Opciones: Inline / Bottom Right / Bottom Left
Theme
Global
Determina el estilo del cuadro reCAPTCHA de Google. Opciones: Light Theme (predeterminado) / Dark Theme
Language Code
Vista de tienda
Un código de dos caracteres que especifica el idioma que se usa para el texto y los mensajes de Google reCAPTCHA.

reCAPTCHA v3 Invisible

reCAPTCHA v3 invisible

Campo
Ámbito
Descripción
Google API Website Key
Sitio web
Clave del sitio web que se crea al registrar la cuenta de Google reCAPTCHA.
Google API Secret Key
Sitio web
La clave secreta asociada a su cuenta de Google reCAPTCHA.
Minimum Score Threshold
Global
La puntuación mínima que identifica una interacción de usuario como un riesgo potencial, donde 1,0 es una interacción de usuario típica y 0,0 es probablemente un bot. Predeterminado: 0.5
Invisible Badge Position
Sitio web
La posición del distintivo reCAPTCHA invisible en cada página. Opciones: Inline / Bottom Right / Bottom Left
Theme
Sitio web
Determina el estilo del cuadro reCAPTCHA de Google. Opciones: Light Theme (predeterminado) / Dark Theme
Language Code
Vista de tienda
Un código de dos caracteres que especifica el idioma que se usa para el texto y los mensajes de Google reCAPTCHA.

reCAPTCHA Enterprise

[Solo SaaS]{class="badge positive" title="Solo se aplica a proyectos de Adobe Commerce as a Cloud Service (infraestructura de SaaS administrada por Adobe)."}

reCAPTCHA v3 Enterprise

Campo
Ámbito
Descripción
Site Key
Sitio web
Clave de sitio que se crea al registrar la cuenta de Google reCAPTCHA Enterprise.
Google Cloud Project ID
Sitio web
El identificador de proyecto se muestra en la sección Información del proyecto del tablero del proyecto.
Service Account JSON
Sitio web
Descargue la clave de cuenta de servicio de la consola de Google Cloud y pegue su contenido en este campo.
Minimum Score Threshold
Sitio web
La puntuación mínima que identifica una interacción de usuario como un riesgo potencial, donde 1,0 es una interacción de usuario típica y 0,0 es probablemente un bot. Predeterminado: 0.5
Badge Position
Sitio web
La posición del distintivo reCAPTCHA invisible en cada página. Opciones: Inline / Bottom Right / Bottom Left
Theme
Sitio web
Determina el estilo del cuadro reCAPTCHA de Google. Opciones: Light Theme (predeterminado) / Dark Theme
Language Code
Vista de tienda
Un código de dos caracteres que especifica el idioma que se usa para el texto y los mensajes de Google reCAPTCHA. Deje el campo en blanco para utilizar el idioma predeterminado del explorador del usuario.
Validation Failure Message
Vista de tienda
Mensaje que se muestra cuando falla la validación.

reCAPTCHA Failure Messages

Mensajes de error

Campo
Ámbito
Descripción
reCAPTCHA Validation Failure Message
Vista de tienda
El mensaje que se muestra en la tienda si la verificación falla. Texto predeterminado: reCAPTCHA verification failed.
reCAPTCHA Technical Failure Message
Vista de tienda
El mensaje que se muestra en la tienda si reCAPTCHA no devuelve un resultado de verificación. Texto predeterminado: Something went wrong with reCAPTCHA. Please contact the store owner.

Storefront

Tienda

NOTE
El tipo de reCAPTCHA que elija debe coincidir con el tipo asociado a la clave de API de su cuenta de Google reCAPTCHA.
WARNING
Cuando se utiliza la versión 3 de reCAPTCHA, un usuario auténtico con una puntuación baja no puede continuar. Para la versión 2, un usuario auténtico con una puntuación baja recibe un desafío. Considere detenidamente si los usuarios genuinos con una puntuación baja deben tener la oportunidad de resolver un desafío (versión 2) o de ser bloqueados (versión 3).
Campo
Ámbito
Descripción
Enable for Customer Login
Sitio web
Especifica el tipo de reCAPTCHA que se usa cuando los clientes inician sesión en sus cuentas. Opciones:
No- (predeterminado) No valida la solicitud de inicio de sesión.
reCAPTCHA v2 ("I am not a robot") - Requiere que el usuario seleccione la casilla de verificación No soy un robot.
Invisible reCAPTCHA v2- Valida el comportamiento del usuario en segundo plano sin requerir interacciones basadas en la puntuación.
Invisible reCAPTCHA v3 : (recomendado) valida el comportamiento del usuario en segundo plano en función de la puntuación de interacción.
Enable for Forgot Password
Sitio web
Especifica el tipo de reCAPTCHA que se usa cuando los clientes solicitan un restablecimiento de contraseña. Opciones:
No- (predeterminado) No valida la solicitud de restablecimiento de contraseña.
reCAPTCHA v2 ("I am not a robot") - Requiere que el usuario seleccione la casilla de verificación No soy un robot.
Invisible reCAPTCHA v2- Valida el comportamiento del usuario en segundo plano sin requerir interacciones basadas en la puntuación.
Invisible reCAPTCHA v3 : (recomendado) valida el comportamiento del usuario en segundo plano en función de la puntuación de interacción.
Enable for Create New Customer Account
Sitio web
Especifica el tipo de reCAPTCHA que se usa cuando el cliente se suscribe a una nueva cuenta. Opciones:
No- (predeterminado) No valida la solicitud de cuenta.
reCAPTCHA v2 ("I am not a robot") - Requiere que el usuario seleccione la casilla de verificación No soy un robot.
Invisible reCAPTCHA v2- Valida el comportamiento del usuario en segundo plano sin requerir interacciones basadas en la puntuación.
Invisible reCAPTCHA v3 : (recomendado) valida el comportamiento del usuario en segundo plano en función de la puntuación de interacción.
Enable for Edit Customer Account
Sitio web
Especifica el tipo de reCAPTCHA que se usa cuando el cliente cambia su información de cuenta. Opciones:
No- (predeterminado) No valida la solicitud de cuenta.
reCAPTCHA v2 ("I am not a robot") - Requiere que el usuario seleccione la casilla de verificación No soy un robot.
Invisible reCAPTCHA v2- Valida el comportamiento del usuario en segundo plano sin requerir interacciones basadas en la puntuación.
Invisible reCAPTCHA v3 : (recomendado) valida el comportamiento del usuario en segundo plano en función de la puntuación de interacción.
Enable for Create New Company Account
Sitio web
Adobe Commerce B2B (disponible solo con Adobe Commerce B2B) Especifica el tipo de reCAPTCHA que se usa cuando se crea una nueva cuenta de empresa. Opciones:
No- (predeterminado) No valida la solicitud de cuenta.
reCAPTCHA v2 ("I am not a robot") - Requiere que el usuario seleccione la casilla de verificación No soy un robot.
Invisible reCAPTCHA v2- Valida el comportamiento del usuario en segundo plano sin requerir interacciones basadas en la puntuación.
Invisible reCAPTCHA v3 : (recomendado) valida el comportamiento del usuario en segundo plano en función de la puntuación de interacción.
Enable for Contact Us
Sitio web
Especifica el tipo de reCAPTCHA que se usa para enviar un mensaje desde la página Contáctenos de su tienda. Opciones:
No- (predeterminado) No valida la solicitud de mensaje.
reCAPTCHA v2 ("I am not a robot") - Requiere que el usuario seleccione la casilla de verificación No soy un robot.
Invisible reCAPTCHA v2- Valida el comportamiento del usuario en segundo plano sin requerir interacciones basadas en la puntuación.
Invisible reCAPTCHA v3 : (recomendado) valida el comportamiento del usuario en segundo plano en función de la puntuación de interacción.
Enable for Product Review
Sitio web
Especifica el tipo de reCAPTCHA que se usa cuando los clientes envían una revisión del producto. Opciones:
No- (predeterminado) No valida la solicitud de revisión del producto.
reCAPTCHA v2 ("I am not a robot") - Requiere que el usuario seleccione la casilla de verificación No soy un robot.
Invisible reCAPTCHA v2- Valida el comportamiento del usuario en segundo plano sin requerir interacciones basadas en la puntuación.
Invisible reCAPTCHA v3 : (recomendado) valida el comportamiento del usuario en segundo plano en función de la puntuación de interacción.
Enable for Newsletter Subscription
Sitio web
Especifica el tipo de reCAPTCHA invisible que se usa cuando los clientes se suscriben a newsletter. Opciones:
No- (predeterminado) No valida la solicitud de suscripción al boletín informativo.
reCAPTCHA v2 ("I am not a robot") - Requiere que el usuario seleccione la casilla de verificación No soy un robot.
Invisible reCAPTCHA v2- Valida el comportamiento del usuario en segundo plano sin requerir interacciones basadas en la puntuación.
Invisible reCAPTCHA v3 : (recomendado) valida el comportamiento del usuario en segundo plano en función de la puntuación de interacción.
Enable for Gift Card
Sitio web
Adobe Commerce (solo Adobe Commerce) Especifica el tipo de reCAPTCHA que se usa cuando los clientes escriben un código de tarjeta regalo. Opciones:
No- (predeterminado) No valida el envío de código de tarjeta regalo.
reCAPTCHA v2 ("I am not a robot") - Requiere que el usuario seleccione la casilla de verificación No soy un robot.
Invisible reCAPTCHA v2- Valida el comportamiento del usuario en segundo plano sin requerir interacciones basadas en la puntuación.
Invisible reCAPTCHA v3 : (recomendado) valida el comportamiento del usuario en segundo plano en función de la puntuación de interacción.
Enable for Invitation Create Account
Sitio web
Especifica el tipo de reCAPTCHA que se usa cuando los clientes envían un código de invitación de creación de cuenta. Opciones:
No- (predeterminado) No valida el envío del correo electrónico de invitación.
reCAPTCHA v2 ("I am not a robot") - Requiere que el usuario seleccione la casilla de verificación No soy un robot.
Invisible reCAPTCHA v2- Valida el comportamiento del usuario en segundo plano sin requerir interacciones basadas en la puntuación.
Invisible reCAPTCHA v3 : (recomendado) valida el comportamiento del usuario en segundo plano en función de la puntuación de interacción.
Enable for Send to Friend
Sitio web
Especifica el tipo de reCAPTCHA que se usa cuando los clientes comparten un producto con un amigo. Opciones:
No- (predeterminado) No valida el envío por correo electrónico.
reCAPTCHA v2 ("I am not a robot") - Requiere que el usuario seleccione la casilla de verificación No soy un robot.
Invisible reCAPTCHA v2- Valida el comportamiento del usuario en segundo plano sin requerir interacciones basadas en la puntuación.
Invisible reCAPTCHA v3 : (recomendado) valida el comportamiento del usuario en segundo plano en función de la puntuación de interacción.
Enable for Wishlist Sharing
Sitio web
Especifica el tipo de reCAPTCHA que se usa cuando los clientes comparten una lista de deseos. Opciones:
No- (predeterminado) No valida el envío de mensaje y correo electrónico.
reCAPTCHA v2 ("I am not a robot") - Requiere que el usuario seleccione la casilla de verificación No soy un robot.
Invisible reCAPTCHA v2- Valida el comportamiento del usuario en segundo plano sin requerir interacciones basadas en la puntuación.
Invisible reCAPTCHA v3 : (recomendado) valida el comportamiento del usuario en segundo plano en función de la puntuación de interacción.
Enable for Coupon Codes
Sitio web
Especifica el tipo de reCAPTCHA que se usa cuando los clientes escriben un código de cupón. Opciones:
No- (predeterminado) No valida el envío del código de cupón.
reCAPTCHA v2 ("I am not a robot") - Requiere que el usuario seleccione la casilla de verificación No soy un robot.
Invisible reCAPTCHA v2- Valida el comportamiento del usuario en segundo plano sin requerir interacciones basadas en la puntuación.
Invisible reCAPTCHA v3 : (recomendado) valida el comportamiento del usuario en segundo plano en función de la puntuación de interacción.
Enable for PayPal Payflow Pro payment form
Sitio web
Especifica el tipo de reCAPTCHA que se usa cuando los clientes pagan una compra con PayPal Payflow Pro. Opciones:
No- (predeterminado) No valida la solicitud de restablecimiento de contraseña.
reCAPTCHA v2 ("I am not a robot") - Requiere que el usuario seleccione la casilla de verificación No soy un robot.
Invisible reCAPTCHA v2- Valida el comportamiento del usuario en segundo plano sin requerir interacciones basadas en la puntuación.
Invisible reCAPTCHA v3 : (recomendado) valida el comportamiento del usuario en segundo plano en función de la puntuación de interacción.
Enable for Presigned Upload
Sitio web
[Solo SaaS]{class="badge positive" title="Solo se aplica a proyectos de Adobe Commerce as a Cloud Service (infraestructura de SaaS administrada por Adobe)."} Determina si reCAPTCHA se usa para validar solicitudes a la initiateUpload mutación de GraphQL, que genera direcciones URL prefirmadas para cargas de archivos de tienda. Cuando está habilitada, cada solicitud debe incluir un token reCAPTCHA válido en el encabezado X-ReCaptcha. Las solicitudes con un token que falta o no es válido fallan y no se emite ninguna dirección URL de carga. Opciones:
No- (predeterminado) No valida la solicitud de carga.
reCAPTCHA v2 ("I am not a robot") - Requiere que el usuario seleccione la casilla de verificación No soy un robot.
Invisible reCAPTCHA v2- Valida el comportamiento del usuario en segundo plano sin requerir interacciones basadas en la puntuación.
Invisible reCAPTCHA v3 : (recomendado) valida el comportamiento del usuario en segundo plano en función de la puntuación de interacción.
recommendation-more-help
commerce-admin-help-configuration-reference