> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rc.cleverhub.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Magento に Hello Clever を追加する

> Magento 2 のストアで PayID、PayTo、キャッシュバック対応の決済を受け付けるため、Hello Clever の決済ゲートウェイ拡張機能をダウンロード、導入、設定します。

このページでは、Magento 2 のストアに Hello Clever の決済ゲートウェイを追加して設定する方法を解説します。拡張機能をダウンロードし、FTP またはコマンドラインで導入し、キャッシュをフラッシュして、Magento Admin で API の認証情報を設定します。

## 要件

<Info>
  Hello Clever は現在、ストアの住所が**オーストラリア**にある Magento の加盟店が利用できます。現時点で対応しているのは \*\*AUD（オーストラリアドル）\*\*のみです。
</Info>

* **Magento のバージョン**：2.20 以上。
* **ストアの通貨**：AUD。このプラグインは市場地域（国）ごとに専用のウェブサイトスコープを必要とし、Magento Admin で対応する基準通貨を設定する必要があります。

ストアの基準通貨を AUD に設定する手順は次のとおりです。

1. **Stores > Configuration > Currency Setup** へ移動します。
2. 通貨を **AUD (Australian Dollars)** に設定します。

***

<a id="installation" />

## 導入

### 手順 1：拡張機能をダウンロードする

1. [Magento Extension Download](https://helloclever.co/plugins/magento/VERSION/1.0.3/app.zip) のページから Hello Clever の Magento 拡張機能をダウンロードします。
2. ダウンロードすると、サーバーへアップロードする拡張機能のファイルが揃います。

### 手順 2：拡張機能を導入する

拡張機能は FTP またはコマンドラインのいずれかで導入できます。

<Tabs>
  <Tab title="方法 1：FTP">
    <Steps>
      <Step title="FTP でアップロードする">
        FileZilla などの FTP クライアントを使って、Magento サーバーの `app/code/Clever` ディレクトリにモジュールをアップロードします。
      </Step>

      <Step title="フォルダ構成を確認する">
        次へ進む前に、アップロードしたディレクトリ構成が必要な配置と一致していることを確認してください。
      </Step>
    </Steps>
  </Tab>

  <Tab title="方法 2：コマンドライン">
    <Steps>
      <Step title="拡張機能を圧縮する">
        拡張機能のファイルを `.zip` または `.tar.gz` の形式に圧縮します。
      </Step>

      <Step title="サーバーへコピーする">
        `scp` を使って、アーカイブをサーバーの `app/code/Clever` ディレクトリへ転送します。

        ```bash theme={null}
        scp <path_to_your_extension> <ssh_server>:<path_to_clever_directory>
        ```
      </Step>

      <Step title="アーカイブを展開する">
        SSH でサーバーにログインし、Clever のディレクトリへ移動してアーカイブを展開します。

        ```bash theme={null}
        unzip <compressed_extension.zip>
        # or for .tar.gz:
        tar -xzvf <compressed_extension.tar.gz>
        ```
      </Step>

      <Step title="Magento のセットアップコマンドを実行する">
        Magento のルートディレクトリ（例：`magento2`）へ移動し、次のコマンドを実行します。

        ```bash theme={null}
        sudo php bin/magento setup:upgrade
        sudo php bin/magento setup:di:compile
        sudo php bin/magento setup:static-content:deploy
        ```
      </Step>
    </Steps>
  </Tab>
</Tabs>

### 手順 3：Magento のキャッシュをフラッシュする

<Steps>
  <Step title="Cache Management を開く">
    Magento Admin にログインし、**System > Cache Management** へ移動します。
  </Step>

  <Step title="キャッシュをフラッシュする">
    **Flush Cache Storage** をクリックして、キャッシュされたすべてのデータを消去します。
  </Step>
</Steps>

***

## 拡張機能を設定する

<Steps>
  <Step title="Hello Clever の設定を開く">
    Magento Admin で **Stores > Configuration > Sales > Payment Methods > Hello Clever** へ移動します。
  </Step>

  <Step title="プラグインを有効にする">
    **Enabled** の項目を **Yes** に設定します。
  </Step>

  <Step title="認証情報と環境を設定する">
    次の項目を入力します。

    * **API Environment**：テストには `Sandbox`、本番取引には `Production` を選択します。
    * **App ID**：Hello Clever の Merchant Dashboard からコピーします。
    * **Secret Key**：Hello Clever の Merchant Dashboard からコピーします。
    * **Description**：チェックアウトで顧客に表示される決済手段の説明をカスタマイズします。
  </Step>

  <Step title="接続をテストする">
    **Test Connection** をクリックして、認証情報が正しく接続が機能していることを確認します。
  </Step>

  <Step title="設定を保存する">
    **Save Config** をクリックして設定を確定します。
  </Step>
</Steps>

***

## 拡張機能を更新する

Hello Clever の拡張機能を新しいバージョンへ更新するには、古いファイルを削除して再導入する必要があります。

<Steps>
  <Step title="古いファイルを削除する">
    `root/app/code/Clever` 内のすべてのファイルを削除します。
  </Step>

  <Step title="最新バージョンを導入する">
    上記の[導入の手順](#installation)に従って、更新した拡張機能をアップロードして設定します。
  </Step>

  <Step title="キャッシュをフラッシュする">
    Magento Admin で **System > Cache Management** へ移動し、**Flush Cache Storage** をクリックします。
  </Step>
</Steps>


## Related topics

- [Shopline に Hello Clever を追加する](/ja/integrations/shopline.md)
- [Xero に Hello Clever を追加する](/ja/integrations/xero.md)
- [Shopify に Hello Clever を追加する](/ja/integrations/shopify.md)