DocumentaçãoCommerceReferência de configuração

Security > Google reCAPTCHA Storefront

Last update: Tue Jan 20 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Iniciante
  • Intermediário
  • Administrador
  • Desenvolvedor
  • Usuário
IMPORTANT
Antes de configurar o Google reCAPTCHA, verifique se o arquivo PHP.ini inclui a seguinte configuração: allow_url_fopen = 1. Isso pode exigir ajuda do desenvolvedor. Consulte Configurações do PHP no Guia de Instalação.

Para acessar as definições de configuração de armazenamento, escolha Stores > Settings>Configuration​na barra lateral_ Admin _.

Para obter mais informações sobre como usar o Google reCAPTCHA para proteger sua loja, consulte o Google reCAPTCHA no Guia de Sistemas de Administração.

reCAPTCHA v2 (“I am not a robot”)

reCAPTCHA v2 (Não sou um robô)

Campo
Escopo
Descrição
Google API Website Key
Site
A chave do site que é criada ao registrar sua conta do Google reCAPTCHA.
Google API Secret Key
Site
A chave secreta associada à sua conta do Google reCAPTCHA.
Size
Site
O tamanho da caixa do Google reCAPTCHA que aparece quando um cliente faz logon em sua conta. Opções: Normal (padrão) / Compact
Theme
Site
Determina o estilo da caixa do reCAPTCHA do Google. Opções: Light Theme (padrão) / Dark Theme
Language Code
Exibição de loja
O código de dois caracteres que especifica o idioma usado para texto e mensagens do Google reCAPTCHA.

reCAPTCHA v2 Invisible

reCAPTCHA v2 Invisível

Campo
Escopo
Descrição
Google API Website Key
Site
A chave do site que é criada ao registrar sua conta do Google reCAPTCHA.
Google API Secret Key
Site
A chave secreta associada à sua conta do Google reCAPTCHA.
Invisible Badge Position
Site
A posição do selo reCAPTCHA invisível em cada página. Opções: Inline / Bottom Right / Bottom Left
Theme
Global
Determina o estilo da caixa do reCAPTCHA do Google. Opções: Light Theme (padrão) / Dark Theme
Language Code
Exibição de loja
Um código de dois caracteres que especifica o idioma usado para texto e mensagens do Google reCAPTCHA.

reCAPTCHA v3 Invisible

reCAPTCHA v3 Invisível

Campo
Escopo
Descrição
Google API Website Key
Site
A chave do site que é criada ao registrar sua conta do Google reCAPTCHA.
Google API Secret Key
Site
A chave secreta associada à sua conta do Google reCAPTCHA.
Minimum Score Threshold
Global
A pontuação mínima que identifica uma interação do usuário como um risco potencial, onde 1,0 é uma interação típica do usuário e 0,0 provavelmente é um bot. Padrão: 0.5
Invisible Badge Position
Site
A posição do selo reCAPTCHA invisível em cada página. Opções: Inline / Bottom Right / Bottom Left
Theme
Site
Determina o estilo da caixa do reCAPTCHA do Google. Opções: Light Theme (padrão) / Dark Theme
Language Code
Exibição de loja
Um código de dois caracteres que especifica o idioma usado para texto e mensagens do Google reCAPTCHA.

reCAPTCHA Enterprise

[Somente SaaS]{class="badge positive" title="Aplicável somente a projetos do Adobe Commerce as a Cloud Service (infraestrutura SaaS gerenciada pela Adobe)."}

reCAPTCHA v3 Empresa

Campo
Escopo
Descrição
Site Key
Site
A chave do site criada quando você registra sua conta do Google reCAPTCHA Enterprise.
Google Cloud Project ID
Site
A ID do projeto é exibida na seção Informações do projeto no painel do projeto.
Service Account JSON
Site
Baixe a chave da conta de serviço do console do Google Cloud e cole seu conteúdo nesse campo.
Minimum Score Threshold
Site
A pontuação mínima que identifica uma interação do usuário como um risco potencial, onde 1,0 é uma interação típica do usuário e 0,0 provavelmente é um bot. Padrão: 0.5
Badge Position
Site
A posição do selo reCAPTCHA invisível em cada página. Opções: Inline / Bottom Right / Bottom Left
Theme
Site
Determina o estilo da caixa do reCAPTCHA do Google. Opções: Light Theme (padrão) / Dark Theme
Language Code
Exibição de loja
Um código de dois caracteres que especifica o idioma usado para texto e mensagens do Google reCAPTCHA. Deixe o campo em branco para usar o idioma padrão do navegador do usuário.
Validation Failure Message
Exibição de loja
Uma mensagem a ser exibida quando a validação falhar.

reCAPTCHA Failure Messages

Mensagens de falha

Campo
Escopo
Descrição
reCAPTCHA Validation Failure Message
Exibição de loja
A mensagem que é exibida na loja se a verificação falhar. Texto padrão: reCAPTCHA verification failed.
reCAPTCHA Technical Failure Message
Exibição de loja
A mensagem exibida na loja se o reCAPTCHA não retornar um resultado de verificação. Texto padrão: Something went wrong with reCAPTCHA. Please contact the store owner.

Storefront

Vitrine

NOTE
O tipo do reCAPTCHA escolhido deve corresponder ao tipo associado à chave de API da sua conta do Google reCAPTCHA.
WARNING
Ao usar o reCAPTCHA versão 3, um usuário genuíno com baixa pontuação não pode continuar. Para a versão 2, um usuário genuíno com uma pontuação baixa recebe um desafio. Considere cuidadosamente se os usuários originais com uma pontuação baixa devem ter a oportunidade de resolver um desafio (versão 2) ou ser bloqueados (versão 3).
Campo
Escopo
Descrição
Enable for Customer Login
Site
Especifica o tipo de reCAPTCHA que é usado quando os clientes entram em suas contas. Opções:
No- (padrão) Não valida a solicitação de logon.
reCAPTCHA v2 ("I am not a robot") - Exige que o usuário marque a caixa de seleção Não sou um robô.
Invisible reCAPTCHA v2- Valida o comportamento do usuário em segundo plano sem exigir interações com base na pontuação.
Invisible reCAPTCHA v3 - (Recomendado) Valida o comportamento do usuário em segundo plano com base na pontuação de interação.
Enable for Forgot Password
Site
Especifica o tipo de reCAPTCHA que é usado quando os clientes solicitam uma redefinição de senha. Opções:
No- (padrão) Não valida a solicitação de redefinição de senha.
reCAPTCHA v2 ("I am not a robot") - Exige que o usuário marque a caixa de seleção Não sou um robô.
Invisible reCAPTCHA v2- Valida o comportamento do usuário em segundo plano sem exigir interações com base na pontuação.
Invisible reCAPTCHA v3 - (Recomendado) Valida o comportamento do usuário em segundo plano com base na pontuação de interação.
Enable for Create New Customer Account
Site
Especifica o tipo de reCAPTCHA que é usado quando o cliente se inscreve em uma nova conta. Opções:
No- (padrão) Não valida a solicitação de conta.
reCAPTCHA v2 ("I am not a robot") - Exige que o usuário marque a caixa de seleção Não sou um robô.
Invisible reCAPTCHA v2- Valida o comportamento do usuário em segundo plano sem exigir interações com base na pontuação.
Invisible reCAPTCHA v3 - (Recomendado) Valida o comportamento do usuário em segundo plano com base na pontuação de interação.
Enable for Edit Customer Account
Site
Especifica o tipo de reCAPTCHA que é usado quando o cliente altera suas informações de conta. Opções:
No- (padrão) Não valida a solicitação de conta.
reCAPTCHA v2 ("I am not a robot") - Exige que o usuário marque a caixa de seleção Não sou um robô.
Invisible reCAPTCHA v2- Valida o comportamento do usuário em segundo plano sem exigir interações com base na pontuação.
Invisible reCAPTCHA v3 - (Recomendado) Valida o comportamento do usuário em segundo plano com base na pontuação de interação.
Enable for Create New Company Account
Site
Adobe Commerce B2B (Disponível somente com Adobe Commerce B2B) Especifica o tipo de reCAPTCHA usado quando uma nova conta da empresa é criada. Opções:
No- (padrão) Não valida a solicitação de conta.
reCAPTCHA v2 ("I am not a robot") - Exige que o usuário marque a caixa de seleção Não sou um robô.
Invisible reCAPTCHA v2- Valida o comportamento do usuário em segundo plano sem exigir interações com base na pontuação.
Invisible reCAPTCHA v3 - (Recomendado) Valida o comportamento do usuário em segundo plano com base na pontuação de interação.
Enable for Contact Us
Site
Especifica o tipo de reCAPTCHA usado para enviar uma mensagem da página Fale Conosco de seu armazenamento. Opções:
No- (padrão) Não valida a solicitação de mensagem.
reCAPTCHA v2 ("I am not a robot") - Exige que o usuário marque a caixa de seleção Não sou um robô.
Invisible reCAPTCHA v2- Valida o comportamento do usuário em segundo plano sem exigir interações com base na pontuação.
Invisible reCAPTCHA v3 - (Recomendado) Valida o comportamento do usuário em segundo plano com base na pontuação de interação.
Enable for Product Review
Site
Especifica o tipo de reCAPTCHA que é usado quando os clientes enviam uma avaliação do produto. Opções:
No- (padrão) não valida a solicitação de revisão do produto.
reCAPTCHA v2 ("I am not a robot") - Exige que o usuário marque a caixa de seleção Não sou um robô.
Invisible reCAPTCHA v2- Valida o comportamento do usuário em segundo plano sem exigir interações com base na pontuação.
Invisible reCAPTCHA v3 - (Recomendado) Valida o comportamento do usuário em segundo plano com base na pontuação de interação.
Enable for Newsletter Subscription
Site
Especifica o tipo de reCAPTCHA invisível que é usado quando os clientes se inscrevem em uma assinatura de boletim informativo. Opções:
No- (padrão) não valida a solicitação de assinatura do boletim informativo.
reCAPTCHA v2 ("I am not a robot") - Exige que o usuário marque a caixa de seleção Não sou um robô.
Invisible reCAPTCHA v2- Valida o comportamento do usuário em segundo plano sem exigir interações com base na pontuação.
Invisible reCAPTCHA v3 - (Recomendado) Valida o comportamento do usuário em segundo plano com base na pontuação de interação.
Enable for Gift Card
Site
Adobe Commerce (somente Adobe Commerce) Especifica o tipo de reCAPTCHA que é usado quando os clientes inserem um código de cartão-presente. Opções:
No- (padrão) Não valida o envio do código de cartão-presente.
reCAPTCHA v2 ("I am not a robot") - Exige que o usuário marque a caixa de seleção Não sou um robô.
Invisible reCAPTCHA v2- Valida o comportamento do usuário em segundo plano sem exigir interações com base na pontuação.
Invisible reCAPTCHA v3 - (Recomendado) Valida o comportamento do usuário em segundo plano com base na pontuação de interação.
Enable for Invitation Create Account
Site
Especifica o tipo de reCAPTCHA que é usado quando os clientes enviam um código de convite de criação de conta. Opções:
No- (padrão) Não valida o envio de email de convite.
reCAPTCHA v2 ("I am not a robot") - Exige que o usuário marque a caixa de seleção Não sou um robô.
Invisible reCAPTCHA v2- Valida o comportamento do usuário em segundo plano sem exigir interações com base na pontuação.
Invisible reCAPTCHA v3 - (Recomendado) Valida o comportamento do usuário em segundo plano com base na pontuação de interação.
Enable for Send to Friend
Site
Especifica o tipo de reCAPTCHA que é usado quando os clientes compartilham um produto com um amigo. Opções:
No- (padrão) Não valida o envio de email.
reCAPTCHA v2 ("I am not a robot") - Exige que o usuário marque a caixa de seleção Não sou um robô.
Invisible reCAPTCHA v2- Valida o comportamento do usuário em segundo plano sem exigir interações com base na pontuação.
Invisible reCAPTCHA v3 - (Recomendado) Valida o comportamento do usuário em segundo plano com base na pontuação de interação.
Enable for Wishlist Sharing
Site
Especifica o tipo de reCAPTCHA usado quando os clientes compartilham uma lista de desejos. Opções:
No- (padrão) Não valida a mensagem e o envio de email.
reCAPTCHA v2 ("I am not a robot") - Exige que o usuário marque a caixa de seleção Não sou um robô.
Invisible reCAPTCHA v2- Valida o comportamento do usuário em segundo plano sem exigir interações com base na pontuação.
Invisible reCAPTCHA v3 - (Recomendado) Valida o comportamento do usuário em segundo plano com base na pontuação de interação.
Enable for Coupon Codes
Site
Especifica o tipo de reCAPTCHA que é usado quando os clientes inserem um código de cupom. Opções:
No- (padrão) Não valida o envio do código do cupom.
reCAPTCHA v2 ("I am not a robot") - Exige que o usuário marque a caixa de seleção Não sou um robô.
Invisible reCAPTCHA v2- Valida o comportamento do usuário em segundo plano sem exigir interações com base na pontuação.
Invisible reCAPTCHA v3 - (Recomendado) Valida o comportamento do usuário em segundo plano com base na pontuação de interação.
Enable for PayPal Payflow Pro payment form
Site
Especifica o tipo de reCAPTCHA usado quando os clientes pagam uma compra com o PayPal Payflow Pro. Opções:
No- (padrão) Não valida a solicitação de redefinição de senha.
reCAPTCHA v2 ("I am not a robot") - Exige que o usuário marque a caixa de seleção Não sou um robô.
Invisible reCAPTCHA v2- Valida o comportamento do usuário em segundo plano sem exigir interações com base na pontuação.
Invisible reCAPTCHA v3 - (Recomendado) Valida o comportamento do usuário em segundo plano com base na pontuação de interação.
recommendation-more-help
d39aca6f-58a0-41c6-83eb-39fd0ef30672