メインコンテンツへスキップ

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.

​
プロダクト = 収益

プロダクトとは、あなたが販売するものです。単発払いでもサブスクリプションでも。残りは私たちにお任せください。

​
2つのタイプ

単発払い

顧客は一度だけ支払い、完了です。
  • デジタルダウンロード
  • 永久ライセンス
  • テンプレート、コース、素材

サブスクリプション

顧客は周期的に支払います。
  • SaaS プラン
  • メンバーシップ
  • サービス契約

​
プロダクトの作成

ダッシュボード —> プロダクト —> プロダクトを作成 
{
  "storeId": "your-store-uuid",
  "name": "Pro Plan",
  "prices": {
    "USD": { "amount": "29.00", "taxIncluded": false, "taxCategory": "saas" }
  }
}
完了です。 チェックアウト URL が発行されます。ウェブサイトの商品ページに設置してください。

​
プロダクトフィールド

​
必須項目

フィールド説明
名前顧客に表示される内容
価格請求金額（最小単位）
通貨USD、EUR、GBP、CNY、JPY、HKD など
タイプ単発またはサブスクリプション
税カテゴリSaaS、Digital Goods、Software など

​
オプション項目

フィールドデフォルト用途
説明—Markdown 形式、製品のアピール用
画像—推奨 400x400px
成功リダイレクト URL—購入後のリダイレクト先

​
無料トライアル

購入前にサブスクリプション製品をお試しいただけます。

​
トライアル不正利用防止

Waffo Pancake はプラットフォームレベルで消費者のトライアル履歴を自動的に追跡します。消費者が新しいサブスクリプションを開始する際、プラットフォームはその履歴に基づいて利用可能な最大トライアル日数を計算し、マーチャント側の追加対応なしにトライアルの繰り返し不正利用を防止します。 マーチャントは API で requested_trial_days を渡すことで、特定の顧客のトライアル期間を短縮またはスキップすることもできます。
効果的なトライアル悪用防止には buyerIdentity が必要です。認証済みチェックアウトを使用して、各購入者が製品ごとに1回のみトライアルを取得できるようにしてください。

​
請求サイクル

サイクル頻度最適な用途
週次7日ごと高使用量製品
月次毎月標準 SaaS
四半期3ヶ月ごとB2B ソフトウェア
年次12ヶ月ごと長期顧客
年間プランで 15-20% の割引 = 解約率低下 + キャッシュフロー改善。

​
チェックアウトリンク

チェックアウト URL は API でチェックアウトセッションを作成して生成します： 
POST /v1/actions/checkout/create-session
生成されるチェックアウト URL は以下の形式です： 
https://checkout.waffo.ai/{store-slug}/{product-slug}
ウェブサイトに設置：
  • ウェブサイトのボタン
  • Twitter プロフィール
  • メール署名
  • Discord サーバー
チェックアウト URL の生成：
  • ダッシュボード：任意のプロダクトの「リンクをコピー」をクリック
  • API：プロダクト ID でチェックアウトセッションを作成
テストと本番環境：
  • ダッシュボード上部でテストモードを切り替え
  • テストモードはテストチェックアウトセッションを生成

​
プロダクトステータス

Active

公開中、顧客が購入可能。

Inactive

非表示、既存のサブスクリプションは継続。

​
プロダクトの更新

プロダクトはイミュータブルバージョニングを採用：
更新すると新しいバージョンが作成されます。既存のサブスクリプションは元のバージョンを維持します。
フィールド影響
名前/説明新バージョン作成
画像新バージョン作成
価格新規購入のみに影響
請求サイクル作成後は変更不可

​
環境同期

テスト環境と本番環境間でプロダクトバージョンを同期： 
POST /v1/actions/onetime-product/publish-product
{
  "id": "product-id"
}

​
サブスクリプションプロダクトグループ

サブスクリプション製品は、階層型料金プラン（例：Free / Pro / Enterprise）のためにプロダクトグループにまとめられます。各サブスクリプション製品は独自の価格と請求サイクルで独立して定義され、グループとしてまとめられます。 グループの特徴：
  • 共有トライアル：有効にすると、トライアルの利用状況がグループ内のすべての製品で共有されます——顧客一人につきトライアルは一回のみ
  • 柔軟な価格設定：各製品が独自の価格と請求サイクルを持ちます
  • 顧客はグループ内の製品間でアップグレード/ダウングレードが可能

​
ベストプラクティス

請求サイクルを含める：
  • 「Pro Plan - Monthly」
  • 「Pro Plan - Annual (Save 20%)」
  • 整数価格を使用（29、29、28.73 ではなく）
  • 年間割引（15-20%）
  • 競合他社を調査
  • 最小 400x400px
  • PNG または JPG 形式
  • 2MB 未満