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

# ストアエンドポイント

> ストアの作成、更新、管理

ストアは、商品、注文、チェックアウト体験を整理するためのトップレベルエンティティです。各マーチャントは最大 **20ストア**を所有でき、各ストアには独自の Webhook、通知、チェックアウトテーマ設定があります。

## ストアステータス値

| ステータス       | 説明                                          |
| ----------- | ------------------------------------------- |
| `active`    | ストアが稼働中で運用可能                                |
| `inactive`  | マーチャントによって無効化されたストア。データは保持されますがチェックアウトは利用不可 |
| `suspended` | プラットフォームによって停止されたストア。マーチャントは再有効化できません       |

## ロールベースのアクセス制御

ストア内の各マーチャントには3つのロールのいずれかが割り当てられます。ストア作成者には自動的に `owner` が割り当てられます。

| 権限       | `owner` | `admin` | `member` |
| -------- | ------- | ------- | -------- |
| ストア詳細の閲覧 | はい      | はい      | はい       |
| ストア設定の更新 | はい      | はい      | いいえ      |
| ストアの削除   | はい      | いいえ     | いいえ      |
| ストアの作成   | --      | --      | --       |

<Note>
  ストアの作成にはロール制限がありません -- 認証済みのマーチャントなら誰でも新しいストアを作成できます（20ストアの上限まで）。ロールは既存のストアに対する操作にのみ適用されます。
</Note>

## エンドポイント

<CardGroup cols={3}>
  <Card title="ストアの作成" icon="plus" href="/api-reference/endpoints/stores/create-store">
    認証済みマーチャント用の新しいストアを作成します。
  </Card>

  <Card title="ストアの更新" icon="pen" href="/api-reference/endpoints/stores/update-store">
    ストア名、ステータス、または設定を更新します。
  </Card>

  <Card title="ストアの削除" icon="trash" href="/api-reference/endpoints/stores/delete-store">
    ストアを論理削除します（owner のみ）。
  </Card>
</CardGroup>