Documentación

La verificación del dominio de Apple Pay falla debido a un directorio raíz de solo lectura en Adobe Commerce

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

En Adobe Commerce en Managed Services, la verificación del dominio de Apple Pay falla porque el directorio .well-known de nivel raíz está restringido y no se puede escribir. Para solucionarlo, aloje el archivo de verificación en un directorio grabable y configure el enrutamiento mediante el archivo .magento.app.yaml o los fragmentos de VCL de Fastly.

Descripción description

Entorno

  • Producto: Adobe Commerce en Managed Services
  • Versión: 2.4.x
  • Entorno afectado: producción, ensayo

Problema/Síntomas

  • No se puede comprobar el dominio de Apple Pay debido a la incapacidad para escribir en el directorio raíz.
  • El directorio raíz es de solo lectura.
  • Las redirecciones 301 no están permitidas según los requisitos de Apple.

Resolución resolution

Para colocar correctamente el archivo necesario y configurarlo para la verificación del dominio de Apple Pay, sigue estos pasos:

  1. Cree un directorio .well-known en /pub/media/.
  2. Descargar el archivo de apple-developer-merchantid-domain-association.txt desde Apple Pay.
  3. Cargue el archivo en /pub/media/.well-known/.

A continuación, configure el enrutamiento mediante uno de los métodos siguientes:

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

  • Agregue la siguiente configuración a su archivo .magento.app.yaml:

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

  • Insertar los cambios en el entorno.

Método 2: usar fragmentos de VCL de Fastly

  • Inicie sesión en Magento Admin y vaya a: Tiendas > configuraciones > AVANZADO > Sistema

  • Expanda Caché de página completa y vaya a Configuración rápida >   Fragmentos VCL personalizados.

  • Haga clic en Crear y agregue la regla siguiente:

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

  • Use un nombre descriptivo como Apple_domain_association.

  • Establezca el tipo en recv y la prioridad en 100.

  • Haga clic en Crear y, a continuación, haga clic en Cargar rápidamente VCL para aplicar los cambios.

Ahora debería poder acceder al archivo en:
https://your_domain/.well-known/apple-developer-merchantid-domain-association.txt

Lectura relacionada

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