Utiliza la aplicación de Stripe para Adobe Commerce (Magento 2)

Obtén más información sobre cómo instalar, actualizar y desinstalar la aplicación de Stripe para Adobe Commerce (Magento 2).

Precaución

Te recomendamos que pruebes el módulo antes de instalarlo en tu entorno de producción. Si tienes algún problema de instalación, consulta Resolución de problemas.

Instala el módulo

Descarga la última versión del módulo desde Stripe.
Extrae el módulo en tu directorio de Adobe Commerce.
Command Line
```
tar -xvf stripe-magento2-latest.tgz
```
Instala la biblioteca Stripe PHP.
Command Line
```
composer require stripe/stripe-php:^14.10
```

Configura el módulo.

Command Line

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

Si ejecutas Adobe Commerce en modo de producción, también debes compilar e implementar los archivos estáticos del módulo.
Command Line
```
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy
```

Actualiza el módulo

Antes de realizar la actualización:

Haz copias de seguridad de tus archivos y base de datos.
Empieza con tu entorno de pruebas.
Guarda una copia de cualquier personalización que hayas realizado en el código original del módulo.
Comprueba el REGISTRO DE CAMBIOS.

Los lanzamientos de parches (x.x.Y) son compatibles con versiones anteriores y no requieren desarrollo adicional por tu parte después de la actualización. Los lanzamientos secundarios y principales pueden añadir nuevas funciones o cambiar el código de forma incompatible con versiones anteriores. Si has personalizado el código del módulo, tendrás que migrar estas personalizaciones después de la actualización y resolver cualquier conflicto potencial.

Ejecuta los siguientes comandos:

Command Line
php bin/magento module:disable --clear-static-content StripeIntegration_Payments
rm -rf app/code/StripeIntegration/Payments
tar -xvf stripe-magento2-latest.tgz
php bin/magento module:enable StripeIntegration_Payments
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy
php bin/magento cache:flush
php bin/magento cache:cleanStripeIntegration_Payments

Desinstala el módulo

Antes de desinstalar:

Haz copias de seguridad de tus archivos y base de datos.
Guarda una copia de cualquier personalización que hayas realizado en el código original del módulo en caso de que necesites reinstalarlo más adelante.

Ejecuta los siguientes comandos:

Command Line
php bin/magento module:disable --clear-static-content StripeIntegration_Payments
composer remove stripe/stripe-php
rm -rf app/code/StripeIntegration/Payments
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy
php bin/magento cache:flush
php bin/magento cache:clean

Política de ciclo de vida

La última versión del módulo es compatible con las siguientes versiones de Adobe Commerce:

Liberación	Soporte
Adobe Commerce 2.0 - 2.3.6	Ya no es compatible, la última versión compatible es `stripe/stripe-payments:2.9.5`.
Adobe Commerce 2.3.7 - 2.4.x	Actualmente compatible, consulta más abajo nuestra propia política de ciclo de vida.

Para stripe/stripe-payments:4.3.* y versiones posteriores, ofrecemos nuevas funciones, correcciones de errores y parches de seguridad. Las versiones anteriores están obsoletas. Stripe te recomienda que actualices lo antes posible. Todas las versiones están disponibles en Adobe marketplace y en el repositorio de GitHub stripe-magento2-releases.

Historial de versiones

Más información sobre los cambios de compatibilidad con versiones anteriores en la aplicación Adobe Commerce (Magento 2).

Versión 4.1

La versión 4.1.0 introduce cambios para gestionar situaciones en las que se pueden realizar pedidos y facturar sin cobrar pagos. Estas situaciones incluyen:

Compras de suscripciones de prueba
Suscripciones con fechas de inicio futuras.
Actualizaciones o cambios a planes de suscripción inferiores existentes.

Anteriormente, el módulo reembolsaba y cerraba automáticamente estos pedidos con una nota de crédito sin conexión. Ahora, para mejorar la declaración de impuestos:

Los reembolsos automáticos quedan obsoletos.
Los artículos pedidos en estas situaciones tienen un precio personalizado de 0.
Estas partidas están excluidas del cálculo del importe del envío.

Esto da lugar a pedidos con importes de subtotal, envío e impuestos cero. Cuando se compran productos regulares con suscripciones, los importes de subtotal, envío e impuestos solo reflejan las partidas del pedido regular. Estos cambios garantizan que el total general del pedido coincida con el importe del pago cobrado en la fecha del pedido.

Además, la versión 4.1 cambia la forma en que se gestionan las capturas parciales y los reembolsos:

Anteriormente, las capturas parciales o los reembolsos desde el Dashboard de Stripe creaban automáticamente facturas o notas de crédito en Magento.
Estos documentos no incluían los artículos del pedido, sino que utilizaban totales manuales o comisiones de ajuste o reembolsos.
Este enfoque causó problemas con la declaración de impuestos.

En la versión 4.1:

Solo las capturas completas y los reembolsos completos dan lugar a facturas automáticas o notas de crédito.
Para capturas parciales o reembolsos, los comerciantes deben usar el panel de administración de Magento.
Esto garantiza un desglose correcto de los impuestos en la documentación y la presentación de informes precisos a la API de Stripe.