Solución de problemas de Adobe Commerce

Problemas de instalación

El problema más habitual durante el proceso de instalación es recibir el siguiente error al usar Composer:

Composer package not found: Could not find a matching version of package stripe/stripe-payments

Si tienes este problema, sigue estos pasos:

1. Pide el módulo en el marketplace de Adobe.
2. Elimina el archivo de ~/.composer/auth.json si has introducido las claves de API de Adobe Commerce incorrectas.
3. Vuelve a ejecutar el comando Composer. Es posible que tengas que introducir un nombre de usuario y una contraseña. Asegúrate de introducir las claves de la API de Adobe Commerce de la cuenta que utilizaste para realizar el pedido. Puedes obtener tus claves de autenticación en Adobe Commerce.

Actualizaciones y problemas de caché

Si actualizas el módulo, pero, por algún motivo, no ves los nuevos cambios, puedes borrar manualmente la caché de Adobe Commerce eliminando un conjunto de directorios. La documentación oficial de Adobe Commerce describe qué directorios hay que eliminar para Adobe Commerce 2.3 y Adobe Commerce 2.4.

Una vez que hayas eliminado estos directorios, ejecuta los siguientes comandos:

php bin/magento setup:upgrade
php bin/magento cache:flush

Si vas a ejecutar los comandos en modo de producción, también debes compilar e instalar los activos estáticos:

php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy

Si ejecutas Varnish, también debes reiniciar Varnish después de eliminar los archivos var/cache/*. Algunos navegadores también almacenan en caché las solicitudes de Adobe Commerce; si sigues teniendo problemas con la caché, prueba con otro navegador.

No hay ningún método de pago en el proceso de compra

Es posible que el método de pago no aparezca en el proceso de compra por varios motivos:

• Te falta la biblioteca PHP de Stripe o estás usando una versión antigua. Puedes instalar esta dependencia siguiendo el paso 3 de las instrucciones de instalación.
• Tienes otro módulo de Stripe instalado que está usando una versión antigua de la biblioteca Stripe PHP. Deshabilita o desinstala cualquier otro módulo de Stripe activo.
• No has configurado las claves de la API de Stripe correctamente.
• Has limitado la disponibilidad del método de pago a determinados países o divisas.

No aparecen Apple Pay o Google Pay

Si has configurado Express Checkout y los monederos siguen sin aparecer, hay algunas comprobaciones que puedes realizar para solucionar el problema.

Comprobaciones del Dashboard

• Asegúrate de haber habilitado Apple Pay y Google Pay en la configuración de métodos de pago.
• Confirma que tu dominio está registrado y habilitado.
• Si el dominio de tu sitio web empieza con www, asegúrate de que el dominio sea www.example.com y no example.com. Si ambos son válidos, debes registrar ambos dominios.

Comprobaciones del dispositivo

• Asegúrate de haber habilitado Apple Pay y Google Pay en la configuración de métodos de pago.
• Para Apple Pay, utiliza Safari en un iPhone con iOS 10 o posterior.
• Para Google Play, utiliza Chrome Desktop o Chrome Mobile con una cuenta de Google conectada.
• Asegúrate de tener al menos una tarjeta en tu monedero.
  • En iOS, puedes añadir una tarjeta en Configuración > Monedero > Apple Pay.
  • En Chrome, puedes añadir una tarjeta en Configuración > Autocompletar > Métodos de pago > Añadir nueva tarjeta de crédito.
• Prueba la demostración para confirmar que tu dispositivo está configurado correctamente.

Comprobaciones de configuración

• Asegúrate de haber habilitado el Express Checkout en la sección de configuración del módulo.
• Asegúrate de haber configurado un país alternativo predeterminado (Tiendas > Configuración > General > Opciones de país > País predeterminado).

Comprobaciones técnicas

• Si tu sitio web está protegido por un firewall o autenticación básica, es posible que la verificación del dominio falle. Comprueba si hay alguna advertencia relacionada en la consola de tu navegador.
• Debes enviar tu sitio web a través de HTTPS con un certificado TLS 1.2 válido. Compruébalo en tu navegador o en SSL Labs.
• Asegúrate de que tu página HTTPS no cargue imágenes, CSS ni JavaScript de forma insegura. Para ello, haz clic en el candado de la barra de la URL de tu navegador.

Comprobaciones de las páginas de productos

Si los monederos aparecen al finalizar la compra, pero no se muestran en las páginas de productos, puede deberse a las siguientes razones:

• Has desactivado los procesos de compras como invitado desde el administrador de Adobe Commerce.
• Tu sitio web está mostrando las páginas de tus productos sin un certificado TLS 1.2 válido.
• Has sobrescrito la plantilla del botón Añadir al carrito en tu tema.

Motivos menos comunes

• Asegúrate de que no estás utilizando una clave de API de Stripe antigua. Apple Pay requiere una clave de API moderna, que comience con pk_live_ o pk_test_. Puedes poner tu clave publicable en la sección de Desarrolladores del Dashboard.
• Si estás utilizando un módulo OneStepCheckout, es posible que también tengas que configurar el módulo OSC para actualizar el formulario de pago cuando los clientes invitados envíen su dirección de facturación. En la mayoría de los casos, esto no es necesario.
• Los errores de JavaScript se producen cuando Stripe.js se está iniciando. Comprueba en la consola de tu navegador si hay algún error de JavaScript relacionado con Stripe.js.

Pedido pendiente atascado

Al crear un pedido, el estado inicial es Pending Payment, lo que indica que la autorización del pago por parte del banco del cliente está aún pendiente. Para todos los métodos de pago basados en el redireccionamiento, cuando se produce una autorización, Stripe notifica a tu sitio web mediante webhooks. Si tus pedidos no cambian de Pending Payment a Processing, es posible que falten webhooks o que sean incorrectos.

Ve a la configuración de webhooks para comprobar si existe un punto de conexión de webhooks con la URL de tu tienda. De lo contrario, puedes intentar crearlo manualmente ejecutando el siguiente comando desde tu directorio raíz de Magento:

bin/magento stripe:webhooks:configure

Si el punto de conexión del webhook ya existe, verifica la Tasa de error para identificar los webhooks que fallan. Puedes hacer clic en el punto de conexión del webhook para ver los mensajes de error. Para obtener ayuda sobre problemas de webhook que no se deban a una configuración incorrecta del servidor, ponte en contacto con el servicio de soporte de Stripe y comparte los detalles sobre los errores que encuentres.

Después de solucionar el problema del webhook, necesitas volver a enviar a tu sitio web los eventos de charge.succeeded que no se entregaron correctamente. El módulo proporciona tres comandos para reenviar un solo evento, un rango de eventos o eventos dentro de un rango de fechas:

bin/magento stripe:webhooks:process-event [-f|--force] <event_id>
bin/magento stripe:webhooks:process-events-range <from_event_id> <to_event_id>
bin/magento stripe:webhooks:process-events-date-range <from_date> [<to_date>]

Puedes obtener una lista de todos los eventos fallidos charge.succeeded en la sección de desarrolladores de tu Dashboard de Stripe y decidir cuáles reenviar utilizando uno de los comandos anteriores.

Error al iniciar sesión y errores en el lado del servidor (HTTP 500)

Adobe Commerce registra los errores y las excepciones que encuentra durante el tiempo de ejecución de la aplicación en el directorio var/log. Puedes encontrar estos errores en los dos archivos siguientes:

var/log/system.log
var/log/exception.log

Si tienes acceso SSH, puedes filtrar los mensajes de error con el siguiente comando:

grep -i Stripe var/log/system.log

Puedes visualizar los errores directamente en la consola a medida que se producen (o cuando actualizas una página determinada). Para supervisar los errores, ejecuta el siguiente comando para ver el registro de errores:

tail -f var/log/*

Si no tienes acceso a shell, puedes descargar este archivo y buscar los errores de Stripe con un editor de texto.