← ブログに戻る
Tutorial公開日 2026-11-08· 9 分で読了

Creem 決済設定:Next.js チェックアウト手順

WangNan, author at Uncorne
著者 WangNan
発行 Uncorne · 更新 2026-11-17

Creem は、Merchant of Record が付いた Stripe 風のホスト型チェックアウトにもっとも近いものです。販売税と VAT を代行するため、手数料は生のプロセッサより高くなります——そのトレードオフは Merchant of Record の概要で説明されています。このチュートリアルは、Next.js SaaS をゼロから実際のサンドボックス決済へと導きます。

Next.js アプリが描画した Creem ホスト型チェックアウト
Next.js アプリが描画した Creem ホスト型チェックアウト

ステップ 0:まずドキュメントを読む

Creem ドキュメントは、一度にざっと読める長さです。ここで重要なのは製品/価格と Webhook の二ページです。Creem Webhook ガイドを開いたままにしてください——ステップ 3 で戻ります。

ステップ 1:アカウントと API キーを作成する

Creem に登録し、テストモードに切り替えて API キーを作成します。CREEM_API_KEY に保存してください。開発中は CREEM_ENV=test を設定し、サンドボックス往復がグリーンになってから live に変更します。テストキーと本番キーは別物で、混同すると混乱する 401 を最短で招きます。

PAYMENT_PROVIDER=creem
CREEM_API_KEY=creem_test_xxx
CREEM_ENV=test
CREEM_WEBHOOK_SECRET=whsec_test_xxx
CREEM_PRICE_ID_BUYOUT=price_buyout_test
CREEM_PRICE_ID_CARE=price_care_test
Creem テストモードの API キー画面
Creem テストモードの API キー画面

ステップ 2:製品と価格を作成する

Creem ダッシュボードで Buyout に一度限りの製品、Care に定期製品を作成します。価格 id を CREEM_PRICE_ID_BUYOUT と CREEM_PRICE_ID_CARE にコピーしてください——スロット名はプランと一致します。古い設定からの移行なら、旧名の CREEM_PRICE_ID_PRO と CREEM_PRICE_ID_SCALE もフォールバックとして解決されます。ブラックフライデー促销なら別の価格 id を作り、CREEM_PRICE_ID_BUYOUT_BF と CREEM_PRICE_ID_CARE_BF を設定します。Webhook のプラン推定はすでにこれらを認識します。

Buyout と Care の価格 id を示す Creem 製品画面
Buyout と Care の価格 id を示す Creem 製品画面

ステップ 3:Webhook を設定する

Creem を /api/payments/webhook/creem 端点に向け、Webhook シークレットを CREEM_WEBHOOK_SECRET にコピーします。連携はすべてのイベントで、信頼する前に署名を検証します。チェックアウトイベントは製品/価格 id からプランを解決してライセンスを付与し、返金やキャンセルイベントはそれを取り消します。

export async function POST(req: Request) {
  const body = await req.text();
  if (!verifyCreemSignature(body, req.headers)) {
    return new Response("bad signature", { status: 400 });
  }
  const evt = JSON.parse(body);
  if (evt.type === "checkout.completed") {
    await grantLicence(evt.customer, inferPlan(evt.product.id), evt.id);
  }
  if (evt.type === "subscription.canceled") {
    await revokeLicence(evt.customer);
  }
  return new Response("ok");
}
完了したチェックアウトと返金イベントを列挙した Creem Webhook ログ
完了したチェックアウトと返金イベントを列挙した Creem Webhook ログ

ハンドラーは Next.js App Router の route handler として動くため、検証はサーバーに留まります。付与は冪等にしてください。Creem はイベントを再試行し、再試行されたチェックアウトが二つ目のライセンスを作ってはいけません。イベント id とイベント種別をログに残してください。返金がアクセスを取り消していないように見えるとき、そのログが実際に届いたイベントを教えてくれます。

ステップ 4:プロバイダーを設定する

PAYMENT_PROVIDER=creem と CREEM_API_KEY、CREEM_WEBHOOK_SECRET を設定します。チェックアウト呼び出しは現在のプラン(促销中なら BF 価格 id)に合う価格 id を選び、Creem のホスト型チェックアウトへリダイレクトします。カード情報に触れることはなく、PCI の適用範囲がアプリに及びません。

ステップ 5:サンドボックスでテストする

テストモードとテスト購入を使います。Webhook が発火し、プランが正しく推定され、ライセンスキーが発行されることを確認し、次にテスト返金を発行してライセンスが取り消されるのを見届けます。この最後のステップは忘れられがちですが、あなたの収益を守るステップです。往復すべてがグリーンになってから、CREEM_ENV=live と本番キーで本番化します。

Creem サンドボックスで返金イベントがライセンスを取り消す様子
Creem サンドボックスで返金イベントがライセンスを取り消す様子

よくある三つの失敗のトラブルシューティング

Webhook が 400 を返すなら、タイムスタンプのウィンドウとシークレットを確認してください。再生されたり時刻がずれたイベントは、設計上拒否されます。プランが常に既定のままなら、Creem の価格 id と環境内のものが一致していません。返金後にアクセスが残るなら、チェックアウトだけでなくキャンセルと返金の両イベント種別を扱っているか確認してください。

後でゲートウェイを切り替える

Creem、Waffo、Stripe、PayPal、Lemon Squeezy は Uncorne で同じチェックアウトと Webhook 契約の背後にあるため、プロバイダー切り替えはコードの書き換えではなく設定変更です。同じ手順は Waffo 決済設定チュートリアルを、より広い判断材料は課金ゲートウェイガイドを参照してください。

チェックアウト呼び出しが実際にすること

Buyout または Care をクリックすると、サーバーアクションがプランの価格 id を解決し、Creem のチェックアウトセッションを作成します。価格 id はサーバーで選ばれるため、顧客が URL パラメータを編集して Buyout の価格で Care を買うことはできません。セッションには内部ユーザー参照が metadata として載り、Webhook が届いたとき、その参照によって正しいアカウントに付与できます。ブラウザを Creem が返した URL へリダイレクトしてください。自分のレイアウトの中でチェックアウトを描画しようとしないでください。

イベント、冪等性、リトライ契約

Creem は、端点が 2xx で応答するまで Webhook を再試行します。ハンドラーは速く冪等にしてください。まず応答し、ライセンスサービスが遅ければバックグラウンドジョブで処理します。イベント id をユニーク列に保存し、リトライされた checkout.completed が二つ目のライセンスを作らないようにします。イベント id、イベント種別、製品 id をログに残してください。返金がアクセスを解除しなかったと報告されたとき、そのログが実際にどのイベントが届いたかを教えてくれます。

定期の Care:扱うべき三つのイベント

Care はサブスクリプションなので、初回チェックアウトの成功は始まりにすぎません。subscription.active でアクセスを維持し、subscription.canceled で有料期間の終わりに取り消し、返金経路で即座に取り消します。キャンセルを今すぐ効かせるか期間末にするかは、意図的に決めてください。期間中にアクセスを切るのは、不要なサポートチケットになります。Creem が返す更新日を保存し、自分の UI で表示できるようにしましょう。

サンドボックスは一つの順調な経路ではなくマトリクスで

本番に触れる前に、テストモードでこれらを走らせてください:

  1. 標準価格 id で Buyout——一度限りのライセンスが発行される。
  2. 標準価格 id で Care——サブスクリプションが有効、更新日が保存される。
  3. プロモーションフラグを付けて BF 価格 id——正しい BF プランが推定される。
  4. 同じ checkout.completed イベントを二回配信——ライセンスは一つ、二つではない。
  5. Care でテスト返金——アクセスが取り消され、孤立したサブスクリプションが残らない。

4 行目と 5 行目は、多くの連携が壊れる場所です。一度の成功購入ではほとんど何も証明できません。

本番化チェックリスト

CREEM_ENV=live に切り替え、テストの API キーと Webhook シークレットを本番用に差し替え、Webhook URL が本番ドメインの HTTPS であることを確認します。フォールバックが不要なら、環境から古い PRO と SCALE の価格 id を削除してください。そして少額の実際の購入を一つ行い、返金し、チェーン全体——チェックアウト、署名、プラン、ライセンス、取り消し——を眺めてから、何かを発表してください。

次に読むもの

五つのアダプターが一つの契約を共有するため、プロバイダーを替えてもこれらの運用習慣は引き継がれます。Waffo チュートリアルは平行な設定を扱い、ゲートウェイ比較は Creem の Merchant of Record 手数料が元を取る時を説明します。

何をログに残すか、そしてそれがなぜ重要か

決済連携は、スタックの中で人々が夜中に電話してくる部分です。三行のログがあれば、その電話は短く済みます。Creem のイベント id、推定されたプラン、そして取ったライセンス操作です。これらのフィールドがあれば、顧客に何をクリックしたか尋ねずに、どんな事故でも再現できます。タイムスタンプを加えれば、更新が遅れたのか Webhook が再試行されたのかも判別できます。生のペイロードはログに残さないでください。顧客のメールアドレスが含まれています。必要なフィールドだけを保存しましょう。署名失敗をデバッグするなら、本文全体ではなくイベント id と検証結果を記録してください。10 秒で読めるログは、誰も開きたがらない冗長なダンプよりずっと価値があります。

FAQ

Creem は Merchant of Record ですか?+

はい。Creem が販売税/VAT とコンプライアンスを代行するため、手数料は生のプロセッサより高くなります。コミット前に Creem の料金ページで現在のレートを確認してください。

Creem Webhook の署名を検証する必要がありますか?+

はい。連携はサーバー上ですべてのイベントを CREEM_WEBHOOK_SECRET で検証します。省くと、署名なしリクエストで誰でもチェックアウトイベントを偽装できます。

返金時はどうなりますか?+

Webhook がキャンセルまたは返金イベントを受け取り、ライセンスを取り消すため、返金された顧客がアクセスを維持できません。本番前にサンドボックスでこの経路をテストしてください。

古い PRO と SCALE の価格 id 名は使えますか?+

使えます。古い設定からの移行では CREEM_PRICE_ID_PRO と CREEM_PRICE_ID_SCALE もフォールバックとして解決されますが、新規プロジェクトではプランに対応した BUYOUT と CARE の名前を使ってください。

よくある質問をすべて見る · Markdown 版(AI エージェント向け)