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

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

注意

モジュールを本番環境にインストールする前に、テストすることをお勧めします。インストール中に問題が発生した場合は、トラブルシューティングをご覧ください。

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

Adobe マーケットプレイスでモジュールを注文します。
端末を開いて、Adobe Commerce ディレクトリーで以下のコマンドを実行します。
Command Line
```
composer require stripe/stripe-payments
```

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

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

Command Line

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

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

Command Line

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

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

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

ファイルとデータベースをバックアップします。
サンドボックス環境で開始します。
モジュールの元のコードに行ったカスタマイズがあれば、コピーを取っておく。
CHANGELOG を確認する。

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

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

Command Line

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

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

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

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

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

Command Line

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

ライフサイクルポリシー

このモジュールの最新バージョンは、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.3.* 以降については、新機能、バグ修正、セキュリティパッチを提供します。古いバージョンは非推奨です。できるだけ早くアップグレードすることをお勧めします。すべてのリリースは、Adobe Marketplace および stripe-magento2-releases GitHub リポジトリで入手できます。

バージョン履歴

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

バージョン 4.1

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

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

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

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

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

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

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

バージョン 4.1:

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

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

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

注意

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

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

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

ライフサイクルポリシー

バージョン履歴

バージョン 4.1

参照情報