メインコンテンツへスキップ
製品はDodo Paymentsの基盤です。一回限りのダウンロード、定期的なサブスクリプション、または使用量に基づくアクセスを販売する場合、製品を作成することから始めます。各製品は、価格設定、チェックアウト時の表示、および購入後の履行方法を定義します。

一回限り

生涯アクセスまたは単一の納品物に対して一度だけ請求します。

サブスクリプション

トライアル、按分、追加機能を伴う定期的な請求を行います。

使用量に基づく

消費を計測し、実際の使用量に基づいて請求します。

​
製品を作成する

ダッシュボードまたはAPIを介して製品を作成できます。最初に価格モデルを選択し、一回限り、サブスクリプション、または使用量に基づくものを選択してから、詳細を設定します。価格モデルは後で変更できないため、異なるモデルが必要な場合は新しい製品を作成してください。
1

名前と説明

明確なタイトルと簡潔な価値指向の説明を提供します。説明にはMarkdownがサポートされています。
最初の文は顧客向けで成果指向に保ってください。これはチェックアウト時に目立つように表示されます。
製品
2

価格モデルと価格

価格モデルを選択します：
  • 一回限り: 一度だけ支払う固定価格。
  • サブスクリプション: 定期的な価格とオプションのトライアル。
  • 使用量に基づく: 計測されたイベントから導出される価格。
次に価格を設定します：
  • 価格: 基本金額と通貨。
  • 割引 (%): チェックアウトと請求書に表示されるオプションのインライン割引。
  • サブスクリプションの場合、必要に応じて毎回繰り返す（例：1か月または1年）とトライアル日数を設定します。
価格を変更すると、新しい購入にのみ影響します。既存のサブスクリプションはプラン変更ルールに従います。
3

製品メディア

チェックアウトと請求書で製品を紹介するために画像をアップロードします。サポートされている形式はPNG/JPG/WebPで、最大3MBです。いつでも順序を変更したり、置き換えたりできます。
4

自動権利（高度な設定の下）

支払い後に自動的にアクティブ化される履行を添付します：
  • ライセンスキー: ユニークなキーを発行し、検証します。
  • ファイルダウンロード: セキュアなファイルアクセスを付与します。
  • カスタム: Webhookを介して独自の権利ロジックをトリガーします。
オファーが進化するにつれて、特典を追加または削除できます。既存のサブスクライバーはそれに応じてアクセスを得たり失ったりします。

​
バリアントと価格オプション

1つの製品の下にバリアントを作成する代わりに、各価格オプション（たとえば、月額と年額）ごとに別々の製品を作成します。同じチェックアウトで複数の製品を並べて表示し、顧客がそれらの間で切り替えられるようにします。
これによりAPIが予測可能になり、レポートが簡素化されます。各製品には単一の価格モデルがあります。

​
製品の管理

ダッシュボードまたはAPIを介してプログラム的に製品を管理できます。APIは製品の作成、更新、取得、画像のアップロード、およびアーカイブに対する完全な制御を提供します。

​
ダッシュボード管理

  • 更新: 名前、説明、画像、価格、フィールド、および特典をいつでも編集できます（価格モデルは不変です）。
  • アーカイブ: 既存の顧客に影響を与えることなく、新しい購入から製品を隠します。後でアーカイブを解除できます。

​
API管理

以下の手順に従って、製品を作成、更新、管理、取得し、画像をアップロードできます。
製品は一回限りのアイテムまたはサブスクリプションベースのサービスです。新しい製品を作成するには、POSTリクエストを/productsエンドポイントに送信し、名前、説明、価格、通貨、およびそれが定期的な製品かどうかの詳細を指定します。定期的な製品の場合、recurring: trueを設定し、billing_cycleを指定します（daily、weekly、monthly、yearly）。

製品作成API

製品作成APIのドキュメントで詳細なリクエストとレスポンスの構造を確認します。
既存の製品を変更するには、PATCHリクエストを/products/{product_id}エンドポイントに送信します。名前、価格、説明などのプロパティを更新できますが、他の詳細は変更しないでください。product_idエンドポイントの値が既存の製品と一致していることを確認してください。

製品更新API

製品更新APIのドキュメントで詳細なリクエストとレスポンスの構造を確認します。
アカウントに保存されている製品のリストを取得するには、GETリクエストを/productsエンドポイントに送信します。これにより、アクティブおよびアーカイブされた製品の詳細を取得できます。

製品取得API

製品取得APIのドキュメントで詳細なリクエストとレスポンスの構造を確認します。
APIから提供された事前署名付きURLを使用して、製品に画像を関連付けることができます。まず、/products/{product_id}/imagesエンドポイントから画像アップロードURLをリクエストし、次に提供されたURLを使用して60秒以内に画像をアップロードします。
事前署名付きURLは60秒で期限切れになるため、その時間内に画像をアップロードする必要があります。
APIから事前署名付きURLを受け取ったら、PUTメソッドを使用して画像をアップロードします。これにより、画像をアップロードするためのAWS S3への安全で一時的なアクセスが確保されます。S3へのアップロードにサポートされているライブラリ：
  • Node.js: axios、node-fetch
  • Python: requests、boto3
  • Go: net/http
  • PHP: GuzzleHttp
  • Ruby: rest-client
アップロードが成功すると、AWS S3は200 OKステータスを返し、画像が正常に保存されたことを示します。

製品画像アップロードAPI

製品画像アップロードAPIのドキュメントで詳細なリクエストとレスポンスの構造を確認します。
製品を表示または使用したくない場合は、POSTリクエストを/products/{product_id}/archiveエンドポイントに送信してアーカイブできます。このアクションは製品を隠しますが、永久に削除するわけではありません。

製品アーカイブAPI

製品アーカイブAPIのドキュメントで詳細なリクエストとレスポンスの構造を確認します。
アーカイブされた製品を復元する必要がある場合は、POSTリクエストを/products/{product_id}/unarchiveエンドポイントに送信します。これにより、製品が再アクティブ化され、再び使用可能になります。

製品アーカイブ解除API

製品アーカイブ解除APIのドキュメントで詳細なリクエストとレスポンスの構造を確認します。
製品から支払いまたはサブスクリプションフローを作成し、特典やWebhookを介して自動的に履行します。

チェックアウトセッション

一回限りまたはサブスクリプション購入のためのチェックアウトセッションを作成します。

支払いWebhook

支払いライフサイクルイベントに反応します。

サブスクリプションWebhook

サブスクリプションの作成、更新、キャンセルイベントを処理します。

​
ベストプラクティス

  • 明確さから始める: 各価格オプション（毎月対毎年）ごとに別々の製品を作成します。
  • トライアルを賢く使用する: トライアルをオンボーディングと組み合わせてアクティベーションを促進します。
  • 履行を自動化する: 特典やWebhookを使用して即座に提供します。
  • メタデータでタグ付けする: 照合のためにシステムIDを保存します。
製品を作成して販売を開始する準備が整いました - 一回限り、定期的、または使用量に基づいて。