app-id と secret-key という2つの認証情報が必要です。このページでは、Merchant Dashboard で Payments Account(決済アカウント)を作成してこれらのキーを発行する方法を解説します。
連携キーを発行するには、有効な Hello Clever の加盟店アカウントが必要です。まだ作成していない場合は、Hello Clever の加盟店アカウントを作成するを参照してください。
連携キーを発行する
1
Merchant Dashboard で Payments Account を作成する
Hello Clever の Merchant Dashboard にログインし、右上の + Create account をクリックします。
2
このアカウントの通貨を選択する
Create account の画面で、Select a currency for this account の下に表示されている通貨を確認します。別の通貨を使う場合は Change をクリックし、Currency ダイアログの一覧から通貨を選びます(検索欄で絞り込めます)。通貨は Hello Clever の加盟店アカウントに設定されている通貨と一致させてください。
3
Payments Account の設定を開始する
What would you like to set up? の下で Accept payments and send payouts のカードを確認し、Create Payments Account をクリックします。
4
アカウントのフォームに入力する
次のフォーム項目を入力します。
- 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 と店舗住所の入力を求められます。
Planned integration type は Hello Clever の利用方法に合わせて設定してください。この設定によって、表示される項目とその後のセットアップ手順が決まります。
5
App ID と Secret Key を確認する
- Merchant Dashboard の右上にあるアカウント名をクリックし、Developer の下の Authentication を選択します。
- Authentication のページで、Auth 1.0 タブが選択されていることを確認します。
- 作成した Payments Account に該当する行を見つけ(Account Name & URL と Name & Plugin Type で照合します)、その App ID と Secret Key をコピーします。
- App ID:この Payments Account の一意の識別子です。これが
app-idにあたります。 - Secret Key:API リクエストの認証に使う秘密のキーです。これが
secret-keyにあたります。
次のステップ
app-id と secret-key が手元にあれば、Hello Clever をプラットフォームへ接続する準備が整っています。
- プラグイン連携:Shopify、WooCommerce、Magento、その他の対応プラットフォーム向けの Hello Clever プラグイン設定に認証情報を入力します。
- API 連携:Hello Clever API へのリクエストで、
app-idとsecret-keyを認証ヘッダーとして渡します。必要な形式は API 認証ガイドを参照してください。