スマレジAPI連携設定
スマレジの「プライベートアプリ」を作成し、Regi-App に Client ID / Client Secret を登録して連携します。
事前に確認
- スマレジの「プラットフォームAPI(Developers)」でプライベートアプリを作成します。
- 本番環境の クライアントシークレットは初回のみ表示されます。必ず控えてください。
- スコープは pos.customers:read / pos.customers:write を使用します。
STEP3:スマレジAPI連携設定(全体の流れ)
- スマレジ Developers でアカウント作成
- ログイン → ダッシュボードで「プライベートアプリ」を新規作成
- 環境設定で URL を登録し、本番の Client ID / Secret を控える
- スコープ設定で pos.customers:read / write をON
- 利用状況でアクティベート
- Regi-App の店舗管理画面に「契約ID / Client ID / Secret」を入力して登録
1. スマレジ Developers から新規アカウント作成
まずはスマレジのプラットフォームAPI(Developers)へアクセスし、画面右上の 「無料でアカウント作成」 をクリックします。
公式サイト:https://developers.smaregi.jp/
2. 会社情報を入力してログイン
入力フォームから会社情報を登録し、そのままログインします。
このメールアドレス・アカウントが、以降のアプリ作成・管理に使用されます。
3. プライベートアプリを新規登録
ログイン後、ダッシュボードから 「プライベートアプリ」 を選択し、 「プライベートアプリを新規登録」 をクリックします。
基本情報は次の内容でOKです。
- アプリ区分:Webアプリ
- アプリ名:お好きな名前
- アイコン:任意(好きな画像でOK)
4. 環境設定(URL登録)+ 本番 Client ID / Secret を控える
環境設定タブで、必須項目を入力します。
開発環境・本番環境ともに同じURLでOKです。
- アプリのURL:https://regi-app.jp/
- 利用者契約通知先URL:https://regi-app.jp/
重要:本番環境の クライアントID と クライアントシークレット を控えます。
クライアントシークレットは初回のみ表示されるため、必ず保存してください。
※開発環境のID等は控えなくてOKです。
控え終わったら 「登録」 をクリックします。
5. スコープ設定(権限)
スコープ設定タブで、次の2つをONにして登録します。
- pos.customers:read(会員/ポイントの参照)
- pos.customers:write(会員/ポイントの更新)
6. 利用状況タブでアクティベート
利用状況タブでアプリを アクティベート して完了です。
7. Regi-App に契約ID / Client ID / Client Secret を登録
最後に Regi-App の店舗管理画面ダッシュボードから 「スマレジ連携設定」 を開き、以下を入力して登録します。
- 契約ID(スマレジの契約ID)
- クライアントID(本番環境)
- クライアントシークレット(本番環境)
これでAPI設定は完了です
登録後、接続テスト(または会員登録・会員参照)が正常に動けば連携成功です。