アプリを新規作成する

レシートローラーの店舗管理画面から開発者ポータルを開き、新しいアプリ（OAuthクライアント）を登録します。所要時間は3〜5分程度です。

前提

• レシートローラーの店舗アカウントを持っていること
• 組織のプランがスタータープラン以上であること
• ログイン中のメンバーがオーナーまたは開発者ロールを持っていること

満たしていない場合は利用開始までの流れを先にご確認ください。

ステップ1：開発者ポータルを開く

1. 店舗管理画面にログインします
2. 左メニューから「デベロッパー」または「開発者ポータル」を選択します
3. アプリ一覧画面が表示されます

メニューに表示されない場合は、プランがフリーのままになっていないかご確認ください（利用開始までの流れ）。

ステップ2：「アプリを登録」をクリック

アプリ一覧画面の右上にある「アプリを登録」または「新規アプリ作成」ボタンをクリックすると、登録フォームが開きます。

ステップ3：必要項目を入力

アプリ名のコツ

• 具体的に — 「APIテスト」より「自社EC連携 (本番)」のほうが管理しやすい
• 環境を含める — 開発・本番で別アプリを登録する場合は「(dev)」「(prod)」を付けるとミスを防げる
• 2〜30文字 — 認可画面のレイアウトが崩れない長さに

リダイレクトURIの入力

• HTTPS必須（本番） — http:// は localhost 以外で受け付けません
• 完全一致 — 認可URLで指定する redirect_uri は、ここで登録したURIと完全一致する必要があります（末尾のスラッシュ・大文字小文字を含めて）
• 複数登録可 — 例: http://localhost:3000/callback（開発）と https://your-app.example.com/callback（本番）を両方登録
• クエリ・フラグメント不可 — ?foo=bar や #hash は含められません

詳しくは次節のリダイレクトURLの設定で解説します。

スコープの選択

必要なスコープを最小限で選択してください。「念のため」追加するのはおすすめしません。スコープを追加・削除した場合は、既存のアクセストークンを取り直す必要があります。

• Store系のみ（store.* / crm.* / sns.* / analytics.*） → 即時利用可
• User系を含む（user.*） → 審査が必要（OAuthスコープ一覧参照）
• Store系とUser系は混ぜられません — 同一アプリで両方は要求できません。両方扱う場合はアプリを2つ登録

ステップ4：「作成」ボタンをクリック

すべての必須項目を入力したら「作成」または「登録」をクリックします。バリデーションエラーがあれば該当フィールドに赤字で表示されます。

ステップ5：クレデンシャルを保管

作成成功後、クライアントIDとクライアントシークレットが表示されます。

クライアントIDは公開しても問題ありません。アプリの設定画面でいつでも確認できます。

作成後にできること

登録したアプリは、開発者ポータルのアプリ一覧から再度開いて以下の操作ができます。

• アプリ名・説明・URLの編集 — 名前変更や説明の更新は随時可能
• リダイレクトURIの追加・削除 — 環境追加に応じて柔軟に管理
• スコープの変更 — 既存トークンは再取得が必要になります
• シークレットの再生成 — 漏洩時・定期ローテーション時に。古いシークレットは即座に無効化
• アプリの無効化・削除 — 利用終了時。既存のアクセストークンも無効になります
• 監査ログの確認 — このアプリ経由の主要なAPIアクセス・トークン発行履歴

よくあるエラー

次のステップ

アプリ登録が完了したら、続けて以下を実装してください。

• リダイレクトURIの整理 — 開発・本番の使い分け方は本章のリダイレクトURL設定
• OAuth認可フロー — クライアントID・シークレットを使った認可コードフローの実装はAPI認証ガイド
• ユースケース別ガイド — 店舗向けWebhookガイド / ウォレットアプリ向けガイド

関連ガイド

• アプリケーション登録とは
• OAuthスコープ一覧と利用可否
• API認証ガイド（OAuth 2.0 認可コードフロー）
• 開発者向けヘルプ目次に戻る