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

# 単発商品エンドポイント

> 単発購入商品の作成と管理

単発商品は単発購入のデジタル商品を表します。各商品はマルチ通貨価格設定、イミュータブルバージョニング、テスト/本番環境の分離をサポートしています。

## 商品ステータス値

| ステータス      | 説明                         |
| ---------- | -------------------------- |
| `active`   | 商品が有効でチェックアウトから購入可能        |
| `inactive` | 商品がチェックアウトから非表示、既存の注文は影響なし |

## 一般的なワークフロー

```mermaid theme={"system"}
sequenceDiagram
    participant M as Merchant
    participant T as Test Environment
    participant P as Production

    M->>T: Create Product (test)
    T-->>M: testStatus=active, prodStatus=inactive
    M->>T: Update Product (iterate)
    T-->>M: New version created (v2, v3...)
    M->>T: Publish Product
    T->>P: Copy test version to production
    P-->>M: prodStatus=active, testStatus=active
    M->>P: Update Product (X-Environment: prod)
    P-->>M: New production version
    M->>P: Update Status (inactive)
    P-->>M: Product hidden from checkout
```

## エンドポイント

<CardGroup cols={2}>
  <Card title="商品の作成" icon="plus" href="/api-reference/endpoints/onetime-products/create-product">
    マルチ通貨対応の新しい単発購入商品を作成します。
  </Card>

  <Card title="商品の更新" icon="pen-to-square" href="/api-reference/endpoints/onetime-products/update-product">
    商品コンテンツを更新します。コンテンツが変更された場合、新しいイミュータブルバージョンが作成されます。
  </Card>

  <Card title="商品の公開" icon="rocket" href="/api-reference/endpoints/onetime-products/publish-product">
    テスト環境から本番環境に商品を公開します。
  </Card>

  <Card title="ステータスの更新" icon="toggle-on" href="/api-reference/endpoints/onetime-products/update-status">
    チェックアウト表示用に商品を有効化または無効化します。
  </Card>
</CardGroup>