> ## 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.

# Hello Clever の連携キーを安全に取得する

> Hello Clever の Merchant Dashboard で Payments Account を作成し、API 呼び出しとプラグイン接続を認証する app-id と secret-key を発行します。

Hello Clever のすべての連携（Shopify ストア、WooCommerce サイト、独自の API のいずれを接続する場合でも）には、`app-id` と `secret-key` という2つの認証情報が必要です。このページでは、Merchant Dashboard で Payments Account（決済アカウント）を作成してこれらのキーを発行する方法を解説します。

<Info>
  連携キーを発行するには、有効な Hello Clever の加盟店アカウントが必要です。まだ作成していない場合は、[Hello Clever の加盟店アカウントを作成する](/ja/create-merchant-account)を参照してください。
</Info>

## 連携キーを発行する

<Steps>
  <Step title="Merchant Dashboard で Payments Account を作成する">
    Hello Clever の Merchant Dashboard にログインし、右上の **+ Create account** をクリックします。
  </Step>

  <Step title="このアカウントの通貨を選択する">
    **Create account** の画面で、**Select a currency for this account** の下に表示されている通貨を確認します。

    別の通貨を使う場合は **Change** をクリックし、**Currency** ダイアログの一覧から通貨を選びます（検索欄で絞り込めます）。通貨は Hello Clever の加盟店アカウントに設定されている通貨と一致させてください。
  </Step>

  <Step title="Payments Account の設定を開始する">
    **What would you like to set up?** の下で **Accept payments and send payouts** のカードを確認し、**Create Payments Account** をクリックします。
  </Step>

  <Step title="アカウントのフォームに入力する">
    次のフォーム項目を入力します。

    * **Currency**：前のステップから引き継がれます（読み取り専用）。
    * **Account name**：登録済みのアカウント名（読み取り専用）。
    * **Account nickname**：このアカウントを識別するためのラベル（例：`Payment Account 1`）。
    * **Account image**：**Browse** をクリックしてロゴやストアの画像をアップロードします。ファイルサイズの上限は 2MB です。
    * **Planned integration type**：ドロップダウンを開き、構成に合う選択肢を選びます。EC プラットフォーム（Shopify、WooCommerce、Magento など）、請求書向けの Xero、実店舗向けの Tyro、または独自の API 連携です。
    * **Website URL**：ストアのウェブサイトのアドレスを入力します。Tyro を選択した場合は、代わりに次の画面で Tyro Location ID と店舗住所の入力を求められます。

    フォームの入力が完了したら、**Create Payments Account** をクリックします。

    <Note>
      **Planned integration type** は Hello Clever の利用方法に合わせて設定してください。この設定によって、表示される項目とその後のセットアップ手順が決まります。
    </Note>
  </Step>

  <Step title="App ID と Secret Key を確認する">
    1. Merchant Dashboard の右上にあるアカウント名をクリックし、**Developer** の下の **Authentication** を選択します。
    2. **Authentication** のページで、**Auth 1.0** タブが選択されていることを確認します。
    3. 作成した Payments Account に該当する行を見つけ（**Account Name & URL** と **Name & Plugin Type** で照合します）、その **App ID** と **Secret Key** をコピーします。

    * **App ID**：この Payments Account の一意の識別子です。これが `app-id` にあたります。
    * **Secret Key**：API リクエストの認証に使う秘密のキーです。これが `secret-key` にあたります。

    <Warning>
      `secret-key` はパスワードと同様に取り扱ってください。公開の場で共有したり、バージョン管理にコミットしたり、クライアントサイドのコードで露出させたりしないでください。キーが漏えいした場合は、Merchant Dashboard から直ちに新しいキーを発行してください。
    </Warning>
  </Step>
</Steps>

## 次のステップ

`app-id` と `secret-key` が手元にあれば、Hello Clever をプラットフォームへ接続する準備が整っています。

* **プラグイン連携**：[Shopify](/ja/integrations/shopify)、[WooCommerce](/ja/integrations/woocommerce)、[Magento](/ja/integrations/magento)、その他の対応プラットフォーム向けの Hello Clever プラグイン設定に認証情報を入力します。
* **API 連携**：Hello Clever API へのリクエストで、`app-id` と `secret-key` を認証ヘッダーとして渡します。必要な形式は [API 認証ガイド](/ja/api/authentication)を参照してください。

<Tip>
  App ID と Secret Key のペアは、1つの Payments Account にのみ有効です。複数のストアや店舗を接続する必要がある場合は、Merchant Dashboard でそれぞれに個別の Payments Account を作成し、独自の認証情報を発行してください。
</Tip>

<Tip>
  テスト用と本番用で別の認証情報が必要な場合は、サンドボックスアカウントとライブアカウントにそれぞれ Payments Account を作成してください。各環境が独立したキーのセットを発行します。
</Tip>


## Related topics

- [適切な Hello Clever の連携方法を選ぶ](/ja/integrations/choosing-integration.md)
- [Hello Clever とは](/ja/getting-started/introduction.md)
- [Hello Clever を始める](/ja/getting-started/overview.md)