Waffo Pancake への移行

すでに Stripe や Creem を運用していますか？ @waffo/pancake-migrate CLI は、商品・価格・Webhook・ブランディングを Waffo Pancake ストアにコピーします。手入力での再登録は不要です。

移行されるのはカタログと設定であり、稼働中の課金ではありません。アクティブなサブスクリプション・顧客・支払い方法はそのままの場所に残ります。理由と対処については移行されないものを参照してください。

他のプラットフォームをご利用ですか？現在 Stripe と Creem からの移行に対応しており、対応プラットフォームは順次拡大予定です。お問い合わせいただき、移行元のプラットフォームをお知らせください。優先的に対応します。

概念のマッピング

何かを実行する前に、既存のセットアップが Waffo Pancake とどう対応するかを確認しておきましょう。このマッピングは CLI が自動で処理します。この表は、何が起きるかを把握するためのものです。

Stripe / Creem	Waffo Pancake	備考
Product + Price	1 つの商品（`prices` を含む）	Pancake は価格を商品に統合します。Stripe のマルチ通貨価格は保持されます。Creem は単一通貨です。
Recurring interval	`billingPeriod`	`week`→`weekly`、`month`→`monthly`、3 か月ごと→`quarterly`、`year`→`yearly`。
Webhook endpoint	ストア Webhook	Stripe のエンドポイントは URL + イベントタイプのマッピングとともに移行されます。（Creem の Webhook は CLI では読み取りません。）
Account branding	ストアブランディング	Stripe のサポートメール + Web サイトが移行されます。
Tax behavior	`taxCategory`	Creem のカテゴリは自動的にマッピングされます。Stripe では `--tax-category` で 1 つのデフォルトを指定します。
Test / live keys	`test` / `production`	キーのプレフィックスから自動検出されます（`sk_test_`→test、`sk_live_`→production）。

始める前に

3 つのものが必要です。

Node.js 18+
Waffo Pancake API キー — Merchant ID（MER_...）と RSA 秘密鍵。Dashboard → API & Development で作成できます。キーの扱い方は SDK ガイドを参照してください。
移行元プラットフォームのキー — Stripe Secret Key（sk_test_... / sk_live_...）または Creem API Key（creem_test_... / creem_...）。

移行は、キーが示す対象環境（test と live）に商品を作成します。何が作成されるかを正確にプレビューするため、必ず最初に --dry-run を実行してください。

最短ルート: インタラクティブモード

npx @waffo/pancake-migrate

ステップごとにガイドします。

移行元を選択

Stripe または Creem。

移行先ストアを選択

既存のストアを選ぶか、その場で新規作成します。

プレビュー

何かが作成される前に、移行される内容を正確に確認します。

移行

商品・価格・画像・Webhook・ブランディングがストアに作成されます。

スクリプトによる移行

すべてをフラグで渡したい場合（CI や実行の繰り返し向け）は、移行元ごとのサブコマンドを使います。

Stripe から

# Full migration (products + webhooks + branding)
npx @waffo/pancake-migrate stripe \
  --stripe-key sk_test_xxx \
  --merchant-id MER_xxx \
  --private-key ./private.pem \
  --store-id STO_xxx \
  --tax-category saas

まず --dry-run でプレビューします。

npx @waffo/pancake-migrate stripe \
  --stripe-key sk_test_xxx \
  --merchant-id MER_xxx \
  --private-key ./private.pem \
  --store-id STO_xxx \
  --tax-category saas \
  --dry-run

ストアがまだない場合は、--store-id new を渡して移行中に作成します。

npx @waffo/pancake-migrate stripe \
  --stripe-key sk_test_xxx \
  --merchant-id MER_xxx \
  --private-key ./private.pem \
  --store-id new \
  --tax-category saas

不要なステップは --skip-products、--skip-webhooks、--skip-branding でスキップします。

npx @waffo/pancake-migrate stripe ... --skip-webhooks --skip-branding

Stripe フラグ

Flag	説明
`--stripe-key <key>`	Stripe Secret Key（`sk_test_...` または `sk_live_...`）
`--merchant-id <id>`	Pancake Merchant ID（`MER_...`）
`--private-key <path>`	Pancake API 秘密鍵ファイルへのパス、または生のキー内容
`--store-id <id>`	移行先 Store ID（`STO_...`）、または `new` で新規作成
`--tax-category <cat>`	デフォルトの税カテゴリ: `saas`、`digital_goods`、`software`、`ebook`、`online_course`、`consulting`、`professional_service`
`--dry-run`	何も作成せずにプレビュー
`--yes`	確認プロンプトをスキップ
`--skip-products`	商品の移行をスキップ
`--skip-webhooks`	Webhook の移行をスキップ
`--skip-branding`	ブランディングの移行をスキップ

Creem から

npx @waffo/pancake-migrate creem \
  --api-key creem_test_xxx \
  --merchant-id MER_xxx \
  --private-key ./private.pem \
  --store-id STO_xxx

まずプレビューします。

npx @waffo/pancake-migrate creem \
  --api-key creem_test_xxx \
  --merchant-id MER_xxx \
  --private-key ./private.pem \
  --store-id STO_xxx \
  --dry-run

Creem フラグ

Flag	説明
`--api-key <key>`	Creem API Key（`creem_test_...` または `creem_...`）
`--merchant-id <id>`	Pancake Merchant ID（`MER_...`）
`--private-key <path>`	Pancake API 秘密鍵ファイルへのパス、または生のキー内容
`--store-id <id>`	移行先 Store ID（`STO_...`）、または `new` で新規作成
`--dry-run`	何も作成せずにプレビュー
`--yes`	確認プロンプトをスキップ

移行されるもの

Stripe から

データ	移行
Products + Prices	はい — マルチ通貨、画像、説明
Billing periods	はい — `week`→`weekly`、`month`→`monthly`、3 か月ごと→`quarterly`、`year`→`yearly`
Webhook endpoints	はい — URL + イベントタイプのマッピング
ストアブランディング	はい — サポートメール + Web サイト
Environment	自動検出 — `sk_test_`→test、`sk_live_`→production

Creem から

データ	移行
Products + Prices	はい — 単一通貨、画像、説明
Billing periods	はい — 毎月→`monthly`、3 か月ごと→`quarterly`、毎年→`yearly`
Tax categories	はい — `saas`→`saas`、`digital-goods-service`→`digital_goods`、`ebooks`→`ebook`

移行されないもの

これらは意図的なものです。それぞれの対処方法は次のとおりです。

移行されないもの	理由	対処
アクティブなサブスクリプション	サブスクリプションは顧客の銀行との稼働中の課金承認であり、決済処理事業者間でコピーできません	既存の購読者は Waffo Pancake のチェックアウトで再購読します。移行期間中は旧来と新規の決済処理事業者を並行運用してください。
顧客データ	初回購入時に自動作成されます	不要 — 顧客は最初の Pancake 支払い時に作成されます
支払い方法	PCI 準拠 — カードデータは元の決済処理事業者から外に出ません	顧客はチェックアウトで支払い情報を再入力します
クーポン / 割引	Pancake は未対応です	—
チェックアウトのテーマカラー	Stripe は API でこれらを公開していません	Dashboard → Settings → Checkout で設定してください

移行後

カタログを確認

Dashboard → Products を開き、価格・課金周期・画像が正しく移行されたか確認します。

本番に公開

商品はキーが示す環境に作成されます。test に移行した場合は、各商品を公開して本番稼働させます。

チェックアウトを接続

アプリを Waffo Pancake のチェックアウトセッションと Webhook に向けます。

並行運用してから切り替え

既存の購読者がそれぞれの更新タイミングで移行する間、旧来の決済処理事業者を稼働させたままにします。Pancake チェックアウトが稼働したら、旧来の決済処理事業者での新規登録を停止します。

移行後に統合を構築しますか？ Waffo Pancake Skill は、チェックアウト・Webhook・サブスクリプション向けの正確な @waffo/pancake-ts ワークフローを AI コーディングエージェントに提供します。

はじめに

機能

マーチャント

ストア

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

Waffo Pancake への移行

概念のマッピング

始める前に

最短ルート: インタラクティブモード

スクリプトによる移行

Stripe から

Creem から

移行されるもの

Stripe から

Creem から

移行されないもの

移行後

​概念のマッピング

​始める前に

​最短ルート: インタラクティブモード

​スクリプトによる移行

​Stripe から

​Creem から

​移行されるもの

​Stripe から

​Creem から

​移行されないもの

​移行後

概念のマッピング

始める前に

最短ルート: インタラクティブモード

スクリプトによる移行

Stripe から

Creem から

移行されるもの

Stripe から

Creem から

移行されないもの

移行後