ドキュメントCommerce「Payment Services ガイド」

Payment Services のインストール

Last update: Fri Nov 01 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

  • 管理者

Adobe Commerce と Magento Open Source の支払いサービスの使用を開始するには、いくつかのオンボーディング手順を完了する必要があります。

INFO
詳しくは、Adobe Commerce用の設定 Payment Services ビデオ参照してください。

Adobe Commerce および Magento Open Source 用の Payment Services 拡張機能をダウンロードしてインストールすることは、Payment Services を使用するための前提条件の手順です。

拡張機能のダウンロード

インストールする前に、最初に Commerce Marketplaceーから拡張機能をダウンロドする必要があります。

  1. Commerce Marketplaceの支払いサービス拡張機能に移動します。
  2. エディションとバージョンを選択するには、Edition と Your store version を希望の選択項目に切り替えます。
  3. 「Add to Cart」をクリックします。
  4. チェックアウトを完了し、「Place Order」をクリックします。
  5. 注文の確認と詳細については、Marketplace のダウンロードに関連するメールを確認してください。
NOTE
Adobe Commerce バージョン 2.4.7 以降 Payment Services 場合は、すぐに使用できます。

拡張機能のインストール

Payment Services 拡張機能は、クラウドインフラストラクチャー上のインスタンスとオンプレミスインスタンスの両方に対してイ Adobe Commerce ストールできます。これらのインスタンスは、登録プロセスで提供されるCommerce アカウント mageid にリンクされています。
オンプレミスの手順を使用するお客様は Magento Open Source とんどいません。

Composer は、Adobe Commerce の初期インストール時、または Composer のキーが以前に auth.json ファイルに保存されていなかった場合に、これらのキーを使用します。

Composer キーの取得の詳細については、 認証キーの取得を参照してください。

拡張機能をダウンロードしてインストールする前に考慮すべき事項について詳しくは、 拡張機能のインストールを参照してください。

クラウドインフラストラクチャー上の Adobe Commerce

Commerce Cloudインスタンスの Payment Services 拡張機能をインストールする場合に使用します。

  1. composer.json ファイルを更新します。

    code language-bash 
    composer require magento/payment-services --no-update

  2. 依存関係を更新し、拡張機能をインストールします。

    code language-bash 
    composer update magento/payment-services --with-dependencies

    composer update コマンドを使用して、すべてのルート依存関係を更新します。

  3. 変更をコミットし、プッシュします。

オンプレミスおよびその他の設定

この方法は、オンプレミスのインスタンスおよび Magento Open Source のお客様の Payment Services 拡張機能をインストールする場合に使用します。

  1. 拡張機能を取得するには、次のコマンドを実行します。

    code language-bash 
    composer require magento/payment-services --no-update

  2. 依存関係を更新し、拡張機能をインストールします。

    code language-bash 
    composer update magento/payment-services --with-dependencies

    composer update コマンドを使用して、すべてのルート依存関係を更新します。

  3. インスタンスをアップグレード：

    code language-bash 
    bin/magento setup:upgrade

  4. キャッシュをクリアする：

    code language-bash 
    bin/magento cache:clean

  5. 変更をコミットします。

  6. コミットされたコードが確実にデプロイされるように、インスタンスを更新します。

NOTE
Payment Services 1.6.1 は、PHP バージョン 7.x と互換性があります。ただし、Payment Services の最新バージョンにアップデートすることを強くお勧めします。

拡張機能のアップグレード

新しいバージョンの Payment Services がリリースされると、拡張機能を簡単にアップグレードできます。

  1. パッケージの最新バージョンを取得するには：

    code language-bash 
    composer update magento/payment-services --with-dependencies

    composer update コマンドを使用して、すべてのルート依存関係を更新します。

  2. コンポーザーを更新した後、次のコマンドを実行します。

    code language-bash 
    bin/magento setup:upgrade

  3. 変更をコミットし、プッシュします。

トラブルシューティング

Payment Services 拡張機能をインストールしようとすると、エラーが発生することがあります。 次のトラブルシューティング方法を使用して、エラーを解決します。

リポジトリーのリスト

リポジトリーのリストに repo.magento.com が存在することを確認します。

コンポーザーのキーが正しくありません

Composer キーが正しくないことを示す次のエラーが表示される場合：

Could not find a matching version of package magento/payment-services. Check the package spelling, your version constraint and that the package is available in a stability which matches your minimum-stability (stable).

Composer キーが有効で、他のMagento パッケージにアクセスできることを確認します。

設定されている Composer キーを確認するには：

  1. auth.json ファイルの場所を見つけます。

    code language-bash 
    composer config --global home

  2. auth.json ファイルを表示します。

    code language-bash 
    cat /path/to/auth.json

  3. 詳しくは Commerce アカウントに関連付けられているキ MageID を参照してください。

PHP に必要なメモリが不足しています

PHP 用のメモリが足りないことを示す次のエラーが表示された場合：

Fatal error: Allowed memory size of 2146435072 bytes exhausted (tried to allocate 4096 bytes) in phar:///usr/local/bin/composer/src/Composer/DependencyResolver/RuleWatchGraph.php on line 52

メモリ制限を増やすご使用の環境の PHP の場合は、php.ini を使用します。

または、次のコマンドを使用してメモリ制限を指定できます：php -d memory_limit=-1 [path to composer]/composer require magento/payment-services。

例：

php -d memory_limit=-1 vendor/bin/composer require magento/payment-services
recommendation-more-help
87189544-c8b9-4aef-af07-ed3578763c38