Documentação

A verificação de domínio Apple Pay falha devido ao diretório raiz somente leitura no Adobe Commerce

Last update: Mon Oct 06 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

No Adobe Commerce no Managed Services, a verificação de domínio de Pagamento do Apple falha porque o diretório .well-known de nível raiz é restrito e não pode ser gravado. Para corrigir isso, hospede o arquivo de verificação em um diretório gravável e configure o roteamento usando o arquivo .magento.app.yaml ou os trechos Fastly VCL.

Descrição description

Ambiente

  • Produto: Adobe Commerce no Managed Services
  • Versão: 2.4.x
  • Ambiente afetado: produção, preparo

Problema/Sintomas

  • Não é possível verificar o domínio Apple Pay devido à incapacidade de gravar no diretório raiz.
  • O diretório raiz é somente leitura.
  • Redirecionamentos 301 não são permitidos de acordo com os requisitos da Apple.

Resolução resolution

Para colocar com êxito o arquivo necessário e configurá-lo para a verificação de domínio Apple Pay, siga estas etapas:

  1. Crie um diretório .well-known em /pub/media/.
  2. Baixe o arquivo apple-developer-merchantid-domain-association.txt do Apple Pay.
  3. Carregar o arquivo para /pub/media/.well-known/.

Em seguida, configure o roteamento usando um dos seguintes métodos:

Método 1: Usando .magento.app.yaml

  • Adicione a seguinte configuração ao seu arquivo .magento.app.yaml:

    code language-none 
    "/.well-known":
  root: "pub/media/.well-known"
  allow: true
  scripts: false
  expires: 1y

  • Envie as alterações para o seu ambiente.

Método 2: Uso de Trechos Fastly VCL

  • Faça logon no Administrador do Magento e acesse: Lojas > Configurações > AVANÇADO > Sistema

  • Expanda Cache de Página Inteira e vá para Configuração Rápida >   Trechos de VCL personalizados.

  • Clique em Criar e adicione a seguinte regra:

    code language-none 
    if (req.url.path == "/.well-known/apple-app-site-association") {
  set req.url = "/media/.well-known/apple-app-site-association";
}

  • Use um nome amigável como Apple_domain_association.

  • Defina o tipo como recv e a prioridade como 100.

  • Clique em Criar e em Carregar Fastly VCL para aplicar as alterações.

Agora você poderá acessar o arquivo em:
https://your_domain/.well-known/apple-developer-merchantid-domain-association.txt

Leitura relacionada

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f