# Adobe Commerce 用に Stripe アプリを使用する (Magento 2)

Stripe app for Adobe Commerce (Magento 2) をインストール、アップグレード、アンインストールする方法をご紹介します。

> モジュールを本番環境にインストールする前に、テストすることをお勧めします。インストール中に問題が発生した場合は、[トラブルシューティング](https://docs.stripe.com/use-stripe-apps/adobe-commerce/payments/troubleshooting.md)をご覧ください。

## モジュールをインストールする

#### マーケットプレイスから (推奨)

1. [Adobe マーケットプレイス](https://marketplace.magento.com/stripe-stripe-payments.html)でモジュールを注文します。

1. 端末を開いて、Adobe Commerce ディレクトリーで以下のコマンドを実行します。

   ```bash
   composer require stripe/stripe-payments
   ```

この段階で、ユーザー名とパスワードの送信が必要になる場合があります。[Adobe Commerce 認証キー](https://devdocs.magento.com/guides/v2.3/install-gde/prereq/connect-auth.html)を入力してください。Composer からメッセージが表示されたときに、認証情報の保存を受け入れることができます。キーを保存しても、エラー `Invalid Credentials` が表示される場合は、`~/.composer/auth.json` 内のキーを更新するか、このファイルを削除してコマンドを再度実行します。

1. 次のコマンドを実行して、モジュールを設定します。

   ```bash
   php bin/magento setup:upgrade
   php bin/magento cache:flush
   php bin/magento cache:clean
   ```

1. Adobe Commerce を本番環境で実行する場合は、モジュールの静的ファイルもコンパイルしてデプロイする必要があります。

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

#### 未加工パッケージから

1. Stripe からモジュールの[最新バージョン](https://github.com/stripe/stripe-magento2-releases/raw/master/stripe-magento2-latest.tgz)をダウンロードします。

1. モジュールを Adobe Commerce ディレクトリーに抽出します。

   ```bash
   tar -xvf stripe-magento2-latest.tgz
   ```

1. Stripe PHP ライブラリーをインストールします。

   ```bash
    composer require stripe/stripe-php:~17.6
   ```

1. モジュールを設定します。

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

1. Adobe Commerce を本番環境で実行する場合は、モジュールの静的ファイルもコンパイルしてデプロイする必要があります。

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

## モジュールをアップグレードする

アップグレードする前に、以下を行ってください。

- ファイルとデータベースをバックアップします。
- サンドボックス環境で開始します。
- モジュールの元のコードに行ったカスタマイズがあれば、コピーを取っておく。
- [CHANGELOG](https://github.com/stripe/stripe-magento2-releases/blob/master/CHANGELOG.md) を確認する。

パッチリリース (x.x.Y) は下位互換性があり、アップグレード後にお客様側で追加の開発作業を行う必要はありません。マイナーリリースやメジャーリリースでは、新しい機能が追加されたり、後方互換性のないコード変更が行われたりする可能性があります。モジュールのコードをカスタマイズした場合は、アップグレード後にそれらのカスタマイズを移植し、競合の可能性があれば解決する必要があります。

#### マーケットプレイスから

以下のコマンドを実行します。

```bash
composer remove stripe/stripe-payments
composer require stripe/stripe-payments
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy
php bin/magento cache:clean
```

#### 未加工パッケージから

以下のコマンドを実行します。

```bash
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
```

## モジュールをアンインストールする

アンインストールする前に:

- ファイルとデータベースをバックアップします。
- モジュールの元のコードをカスタマイズしている場合は、後で再インストールが必要になる場合に備えてコピーを取っておきます。

#### マーケットプレイスから

以下のコマンドを実行します。

```bash
composer remove stripe/stripe-payments
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy
php bin/magento cache:clean
```

#### 未加工パッケージから

以下のコマンドを実行します。

```bash
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
```

## ライフサイクルポリシー

このモジュールの最新バージョンは、Adobe Commerce の以下のバージョンをサポートしています

| リリース                         | サポート                                                           |
| ---------------------------- | -------------------------------------------------------------- |
| Adobe Commerce 2.0 ～ 2.3.6   | サポートが終了しました。互換性のある最後のバージョンは `stripe/stripe-payments:2.9.5` です。 |
| Adobe Commerce 2.3.7 ～ 2.4.x | 現在サポート対象です。Stripe 独自のライフサイクルポリシーについては、以下をご覧ください。               |

`stripe/stripe-payments:4.5.x` 以降では、バグ修正とセキュリティパッチが提供されます。Stripe では、モジュールの最新の公開バージョンにアップグレードすることをお勧めします。すべてのリリースは、Adobe Marketplace と [stripe-magento2-releases](https://github.com/stripe/stripe-magento2-releases) GitHub リポジトリで入手できます。

## バージョン履歴

Adobe Commerce アプリバージョン (Magento 2) の下位互換性の変更点を説明します。

### バージョン 4.1

バージョン 4.1.0 では、支払いを回収せずに注文と請求を行えるシナリオを処理するための変更が導入されています。これらのシナリオには以下が含まれます。

- トライアルサブスクリプションを購入してください。
- 開始日が将来のサブスクリプション。
- 既存のサブスクリプションプランをアップグレードまたはダウングレードします。

これまでは、モジュールが自動的にこれらの注文を返金し、オフラインのクレジットメモを残してクローズしていました。現在は、納税申告書を改善するために、以下のようになっています。

- 自動返金は非推奨になりました。
- これらのシナリオの注文アイテムのカスタム価格は 0 です。
- これらのアイテムは、配送料金の計算から除外されます。

これにより、小計、配送料、税額がゼロの注文が作成されます。通常の商品をサブスクリプションで購入した場合、小計、配送料、および税額には通常の注文アイテムのみが反映されます。これらの変更により、注文の総計が注文日に回収された支払い金額と一致するようになります。

また、バージョン 4.1 では、一部キャプチャーと返金の処理方法が変更されています。

- これまでは、 Stripe ダッシュボードから一部キャプチャーまたは返金を行うと、Magento で請求書またはクレジットメモが自動的に作成されました。
- これらの書類には、代わりに手動での合計、調整手数料、または返金を使用する注文アイテムは含まれていませんでした。
- この手法では、納税申告に問題が発生していました。

バージョン 4.1:

- 全額キャプチャーと全額返金の場合にのみ、請求書またはクレジットメモが自動作成されます。
- 一部キャプチャまたは返金を行うには、加盟店は Magento 管理パネルを使用する必要があります。
- これにより、書類の税金の内訳が正しくなり、Stripe API に正確にレポートされます。

## See also

- [Stripe app for Adobe Commerce を設定する](https://docs.stripe.com/use-stripe-apps/adobe-commerce/payments/configuration.md)
- [Adobe Commerce 管理パネルを使用する](https://docs.stripe.com/use-stripe-apps/adobe-commerce/payments/admin.md)
- [トラブルシューティング](https://docs.stripe.com/use-stripe-apps/adobe-commerce/payments/troubleshooting.md)