プロダクト

プロダクト = 課金オブジェクト

Waffo Pancake における プロダクト は、チェックアウト、課税、レポートに用いられるオブジェクトです。単なる商品ページのカードではなく、あなたが課金する「商業的なオファー」そのものです。

プロフェッショナルな使い方では、プロダクトを以下の課金エンティティとして捉えてください：

固定価格のオファー
サブスクリプションプラン
チェックアウト時に動的価格で利用するベースプロダクト

コアモデル

単発払い

顧客が事前定義されたオファーに対して 1 回だけ支払います。

デジタルダウンロード
永久ライセンス
テンプレート、コース、素材

サブスクリプション

顧客が定期的なスケジュールで請求されます。

SaaS プラン
メンバーシップ
サービス契約

動的価格

金額はチェックアウト時に計算されます。

使用量超過分の課金
クレジットのチャージ
個別交渉による見積り

プロダクトの作成

ダッシュボード —> プロダクト —> プロダクトを作成

{
  "storeId": "your-store-uuid",
  "name": "Pro Plan",
  "prices": {
    "USD": { "amount": "29.00", "taxIncluded": false, "taxCategory": "saas" }
  }
}

完了です。 固定価格販売向けの恒久的な購入リンク、またはプログラム経由のチェックアウトで再利用できる課金オブジェクトが得られます。

プロダクトフィールド

必須項目

フィールド	説明
名前	顧客に表示される内容
価格	請求金額（最小単位）
通貨	USD、EUR、GBP、JPY、HKD — CNY は単発商品のみ。複数通貨を同時に設定可能 — 複数通貨での価格設定を参照
タイプ	単発またはサブスクリプション
税カテゴリ	SaaS、Digital Goods、Software など

オプション項目

フィールド	デフォルト	用途
説明	—	Markdown 形式、製品のアピール用
画像	—	推奨 400x400px
リダイレクト URL	—	チェックアウト後の遷移先。支払いが成功した場合も失敗した場合も同じ URL が使われます — 設定できるのは 1 つだけです。

価格の上下限

各通貨には設定可能な最低価格と最高価格があります。範囲外の価格は商品の保存時に拒否されます。

通貨	最低	最高
USD	$1.00	$10,000.00
EUR	€1.00	€9,400.00
GBP	£1.00	£8,150.00
JPY	JP¥100	JP¥1,600,000
CNY	CN¥1.00	CN¥1,000.00
HKD	HK$8.00	HK$77,600.00

CNY は単発商品の価格設定にのみ利用できます —— サブスクリプション商品では CNY を利用できません。CNY 建ての注文は WeChat Pay のみで支払い可能で、同一購入者が WeChat であなたに支払える金額は暦月ごとに累計 ¥1,000 までです。詳細は支払い方法と通貨の対応をご覧ください。

複数通貨での価格設定

1 つの基準価格を為替レートで換算して中途半端な金額にするのではなく、市場ごとに意図した金額（$9.99、JP¥980、CN¥68）を設定できます。


設定場所	商品の作成・編集フォーム
通貨ごと	独自の価格と税カテゴリ
検証	通貨ごとに個別の価格の上下限で判定
チェックアウト時	表示通貨を確定的に解決、金額はロケールに合わせて表示

参考価格

通貨を追加すると、既存の価格を現在の為替レートで換算した金額があらかじめ入力されます。

この金額はあくまで参考価格であり、確定値ではありません。市場に合わせて端数を調整してください。レートのヒントは、2 つ以上の通貨が設定されている間は通貨の横に表示され続けます。

円と元の区別

人民元は CN¥、日本円は JP¥ と表記します。全体を通じて適用されるため、チェックアウトで両者が混同されることはありません。

通貨は換算されるのではなく個別に価格設定されるため、サブスクリプションで通貨をまたぐプラン変更はできません。プラン変更を参照してください。

動的価格

最終的な金額が実行時まで確定しない場合、動的価格が適したモデルです。例：

使用量ベースの超過課金
金額が可変のプリペイドクレジットパック
契約ごとの個別見積り
サーバー側で計算する一時的なディスカウント

仕組み

Waffo Pancake で ベースとなる単発プロダクト を作成します
サーバー側で最終金額を計算します
チェックアウトセッション作成時に priceSnapshot を渡します

const session = await client.checkout.createSession({
  storeId: "store_id",
  productId: "usage-overage-product-id",
  productType: "onetime",
  currency: "USD",
  priceSnapshot: {
    amount: calculatedAmount,
    taxIncluded: false,
    taxCategory: "saas",
  },
});

priceSnapshot は、そのチェックアウトセッションに対して保存されているプロダクト価格を上書きします。必ずサーバー側でのみ使用し、信頼できないクライアントコードからは使用しないでください。

金額がイベントベースの場合は、顧客がすでにサブスクリプション中であっても、単発課金として扱ってください。

トライアル期間

購入を決める前に、サブスクリプション製品をお試しいただけます。トライアルは無料にすることも、料金を設定することもできます — 有料トライアルを参照してください。

トライアル不正利用防止

Waffo Pancake はプラットフォームレベルで消費者のトライアル履歴を自動的に追跡します。消費者が新しいサブスクリプションを開始する際、プラットフォームはその履歴に基づいて利用可能な最大トライアル日数を計算し、マーチャント側の追加対応なしにトライアルの繰り返し不正利用を防止します。マーチャントは API で requested_trial_days を渡すことで、特定の顧客のトライアル期間を短縮またはスキップすることもできます。

効果的なトライアル悪用防止には buyerIdentity が必要です。認証済みチェックアウトを使用して、各購入者が製品ごとに1回のみトライアルを取得できるようにしてください。

請求サイクル

サイクル	頻度	最適な用途
週次	7日ごと	高使用量製品
月次	毎月	標準 SaaS
四半期	3ヶ月ごと	B2B ソフトウェア
年次	12ヶ月ごと	長期顧客

プロダクト購入リンク

各プロダクトには有効期限のない恒久的な購入リンクが発行されます：

https://checkout.waffo.ai/{store-slug}/{product-slug}

テストモード：

https://checkout.waffo.ai/{store-slug}/{product-slug}/test

ウェブサイトに設置：

ウェブサイトのボタン
Twitter プロフィール
メール署名
Discord サーバー

主なメリット：

リンクは恒久的 — プロダクトの詳細を更新してもリンクは変わりません
セッションやトークンの管理は不要
顧客がリンクを開いた瞬間にチェックアウトセッションが自動生成されます

リンクの取得：

ダッシュボード：任意のプロダクトの「リンクをコピー」をクリック
API：高度なユースケースでは、API でカスタムパラメータ付きのチェックアウトセッションを作成（動的リンク、デフォルトの TTL は 45 分、最長 7 日間まで設定可能）

テストと本番環境：

ダッシュボード上部でテストモードを切り替えると、テストリンクでプレビューできます
テストリンクには /test サフィックスが付きます

プロダクトステータス

Active

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

Inactive

チェックアウトには表示されなくなりますが、既存のサブスクリプションは継続します。プロダクトは削除できません —— 完了した注文、請求書、精算記録が参照しているためです。名称や価格の変更は新しいバージョンを追加するだけで、プロダクト ID は変わりません。

プロダクトの更新

プロダクトはイミュータブルバージョニングを採用：

更新すると新しいバージョンが作成されます。既存のサブスクリプションは元のバージョンを維持します。

フィールド	影響
名前/説明	新バージョン作成
画像	新バージョン作成
価格	新規購入のみに影響
請求サイクル	作成後は変更不可

環境同期

プロダクトバージョンをテスト環境から本番環境に公開：

POST /v1/actions/onetime-product/publish-product
{
  "id": "product-id"
}

公開は一方向（テスト → 本番）で、初回公開時のみ必要です。

ベストプラクティス

命名

請求サイクルを含める：

「Pro Plan - Monthly」
「Pro Plan - Annual (Save 20%)」

価格設定

整数価格を使用（ $29、$ 28.73 ではなく）
競合他社を調査

画像

最小 400x400px
PNG または JPG 形式
5MB 未満

はじめに

機能

マーチャント

ストア

マーチャント・オブ・レコード

プロダクト = 課金オブジェクト

コアモデル

単発払い

サブスクリプション

動的価格

プロダクトの作成

プロダクトフィールド

必須項目

オプション項目

価格の上下限

複数通貨での価格設定

参考価格

円と元の区別

動的価格

仕組み

トライアル期間

トライアル不正利用防止

請求サイクル

プロダクト購入リンク

プロダクトステータス

Active

Inactive

プロダクトの更新

環境同期

ベストプラクティス

​プロダクト = 課金オブジェクト

​コアモデル

単発払い

サブスクリプション

動的価格

​プロダクトの作成

​プロダクトフィールド

​必須項目

​オプション項目

​価格の上下限

​複数通貨での価格設定

​参考価格

​円と元の区別

​動的価格

​仕組み

​トライアル期間

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

​請求サイクル

​プロダクト購入リンク

​プロダクトステータス

Active

Inactive

​プロダクトの更新

​環境同期

​ベストプラクティス

プロダクト = 課金オブジェクト

コアモデル

プロダクトの作成

プロダクトフィールド

必須項目

オプション項目

価格の上下限

複数通貨での価格設定

参考価格

円と元の区別

動的価格

仕組み

トライアル期間

トライアル不正利用防止

請求サイクル

プロダクト購入リンク

プロダクトステータス

プロダクトの更新

環境同期

ベストプラクティス