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

# 好きな金額を支払う価格設定

> 顧客が最低価格以上の金額を選択できるようにします。オプションで推奨価格を表示します。一回限りの購入に最適化されています。

**好きな金額を支払う (PWYW)** は、顧客が支払う金額を決定できるモデルです。これは、商人が定義した最低価格以上での支払いを可能にします。顧客の関与を高め、コミュニティのサポートを促し、デジタル製品に対して柔軟な価格設定を提供します。

<Frame>
  <iframe className="w-full aspect-video rounded-md" src="https://www.youtube.com/embed/Lh0Q01b33NY" title="Pay What You Want Pricing | Dodo Payments" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />
</Frame>

## 好きな金額を支払うとは？

PWYWは、顧客があなたが定義したガードレール内で自分の価格を設定する価格モデルです。これは以下のような場合に最適です：

* **デジタル製品とメディア**: テンプレート、電子書籍、コース、プラグイン
* **実験的なローンチ**: 早期アクセス、ベータリリース、期間限定プロモーション
* **バンドルと追加**: 参加を促進するためにPWYW層を追加

## 主な利点

* **顧客主導の価格設定**: 購入者が支払う金額を選択
* **収益の底**: マージンを保護するための最低価格を強制
* **期待の固定**: 選択を導くためのオプションの推奨価格
* **シームレスなチェックアウト**: ホストされたチェックアウトと領収書が自動的に処理される
* **開発者ファースト**: 作成、返金、Webhookのための明確なAPI

<Warning>
  PWYW は**Single Payment**（一度限り）の商品のみに対応しています。
</Warning>

## 好きな金額を支払うの作成

一回限りの製品を作成し、Dodo PaymentsダッシュボードでPWYWを有効にします。以下のセクションは作成フォームに直接対応しています。

### 製品の作成

#### 製品の詳細

* **製品名**（必須）: チェックアウトと請求書に表示される名前
* **製品説明**（必須）: 顧客が支払う前に見る明確な価値声明
* **製品画像**（必須）: PNG/JPG/WebP 最大3MB
* **ブランド**: テーマやメールのために特定のブランドに製品を関連付ける
* **税カテゴリ**（必須）: 税ルールを決定するために正しいカテゴリを選択

<Tip>
  地域ごとに正しく税金を徴収するには、最も正確な税カテゴリを選択してください。
</Tip>

#### 価格設定

* **価格タイプ**: <b>単一支払い</b>を選択
* **好きな金額を支払う**（トグル）: 購入者が金額を選択できるようにする
* **最低価格**（必須）: 顧客が支払うことができる最低金額
* **推奨価格**（オプション）: 製品ページに表示される推奨金額

<Tip>
  後でイベントや領収書を照合できるように、metadata を使用して自システムの識別子（orderId など）を保存してください。
</Tip>

## API管理

<AccordionGroup>
  <Accordion title="Create checkout sessions (PWYW)">
    `POST /checkouts` を使用して、製品から一度限りのチェックアウトセッションを作成します。チェックアウトでは、バイヤーにPWYWの最低額を満たす金額を入力するよう促します。

    <Card title="API Reference" icon="code" href="/api-reference/checkout-sessions/create">
      チェックアウトセッション作成 API を確認してください。
    </Card>
  </Accordion>

  <Accordion title="Refund payments">
    Use `POST /refunds` を使用して全額または一部の返金を作成します。顧客には支払った正確な金額が返金されます。

    <Card title="API Reference" icon="code" href="/api-reference/refunds/post-refunds">
      支払いを返金する方法を確認してください。
    </Card>
  </Accordion>

  <Accordion title="List and retrieve">
    Use `GET /payments` を使用して支払いを一覧表示し、`GET /payments/{payment_id}` で単一の支払いを取得します。`GET /payments/{payment_id}/line-items` で品目を取得してください。

    <Card title="List Payments" icon="code" href="/api-reference/payments/get-payments">
      一覧表示 API を参照してください。
    </Card>

    <Card title="Get Payment Detail" icon="code" href="/api-reference/payments/get-payments-1">
      取得 API をご覧ください。
    </Card>

    <Card title="Retrieve Line Items" icon="code" href="/api-reference/payments/retrieve-line-items">
      支払いに対する購入済みアイテムを検査してください。
    </Card>
  </Accordion>

  <Accordion title="Payment webhooks">
    バックエンドで payment.succeeded や payment.failed のようなイベントに対応してください。

    <Card title="Webhook Guide" icon="code" href="/developer-resources/webhooks/intents/payment">
      支払いのライフサイクルイベントを処理します。
    </Card>
  </Accordion>
</AccordionGroup>

## 一般的なユースケース

* **デジタル資産**: テーマ、テンプレート、アイコンセット、メディア、またはプラグイン
* **コンテンツと教育**: 電子書籍、コース、支援者価格のワークショップ
* **コミュニティと寄付**: 資金調達、オープンソースのスポンサーシップ、クリエイターのサポート
* **ローンチ実験**: ベータアクセスと期間限定キャンペーンで需要を測定

## 統合例

### チェックアウトセッション（単一支払い、PWYW）

PWYW製品をカートに追加します。チェックアウトは購入者の金額を収集します（最低価格を尊重） — 追加のフィールドは必要ありません。

```typescript theme={null}
const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'prod_pwyw_demo', quantity: 1 }
  ],
  return_url: 'https://yoursite.com/checkout/success'
});
```

## ベストプラクティス

* **妥当な最低価格を選択**: コストをカバーしつつ参加を容易にする
* **推奨価格を使用**: 期待を固定して平均注文額を改善
* **価値を明確に説明**: 購入者に貢献が何を解放するかを伝える
* **A/Bテストキャンペーン**: 提供を期間限定にし、メッセージングを実験する
* **配分を監視**: 支払った金額を追跡して最低価格と推奨価格を調整

<Info>
  PWYW は、収益の下限を維持しながらより多くの顧客を誘引する柔軟な方法です。シンプルに始めて、コンバージョン、寄与分布、返金率に基づいて十分にテストし、反復してください。
</Info>