**Show HN:** *Stripe‑no‑webhooks – Stripe のデータを Postgres DB に同期する方法*

Stripe‑No‑Webhooks

このライブラリを選ぶ理由

• Stripe の決済処理を手軽に実装できるオピニオン付きヘルパー
• コード内でプランを定義 → Stripe アカウントと自動同期
• 手動で Webhook を設定する必要がない ― ライブラリ側が Webhook を受信し、ローカル DB と同期します
• サブスクリプション・クレジット・ウォレット残高・トップアップ・使用量課金のシンプル API
• シートベースの請求、税額計算、プランのアップ／ダウングレード（適切なクレジット処理付き）に対応
• カスタムロジック用に

  onSubscriptionCreated

  などオプションコールバックを提供

クイックスタート

このガイドは Next.js アプリと PostgreSQL データベースを想定しています。
ローカルで試すため、まずテストモードで始めましょう。

1. インストール

   npm install stripe-no-webhooks stripe
   npx stripe-no-webhooks init
   

   すると次の入力が求められます：

   • Stripe テストキー（例：

     sk_test_…

     ） – ダッシュボードから取得
   • データベース URL – PostgreSQL 接続文字列 (

     postgresql://user:pass@localhost:5432/app_db

     )
   • サイト URL – 例

     http://localhost:3000

   コマンドは

   .env

   を更新し、以下を作成します：

   billing.config.ts          # プラン定義
   lib/billing.ts             # 本体の課金クライアント
   app/api/stripe/[...all]/route.ts  # Webhook ハンドラ & API エンドポイント
   

2. データベースをセットアップ

   npx stripe-no-webhooks migrate
   

   これで Stripe スキーマ（同期テーブル、クレジット、使用量など）が作成されます。

3. プランを定義する

   billing.config.ts

   を編集します。テスト用例：

   const billingConfig: BillingConfig = {
     test: {
       plans: [
         { name: "Free", price: [{ amount: 0, currency: "usd", interval: "month" }] },
         {
           name: "Pro",
           price: [
             { amount: 2000, currency: "usd", interval: "month" }, // $20/月
             { amount: 20000, currency: "usd", interval: "year" }   // $200/年
           ],
         },
       ],
     },
     production: {
       plans: [], // 本番用に追加
     },
   };
   

   プランにはクレジット、ウォレット、使用量課金も含められます：

   {
     name: "Pro",
     price: [{ amount: 2000, currency: "usd", interval: "month" }],
     features: {
       api_calls: {
         credits: { allocation: 1000 },          // 月間 1 000 コールが含まれる
         pricePerCredit: 1,                     // 追加コールは $0.01/回
         trackUsage: true,                      // 使用量課金を有効化
       },
     },
     wallet: { allocation: 500 },                // $5 のプリペイド残高
   }
   

4. Stripe と同期

   npx stripe-no-webhooks sync
   

   プロダクト/価格が Stripe に作成され、ID が設定ファイルに反映されます。

5. 課金クライアントを更新

   lib/billing.ts

   でユーザー ID を解決する方法を指定します（Clerk の例）：

   import { Billing } from "stripe-no-webhooks";
   import { auth } from "@clerk/nextjs/server";
   import billingConfig from "../billing.config";
   
   export const billing = new Billing({
     billingConfig,
     successUrl: process.env.NEXT_PUBLIC_APP_URL || "http://localhost:3000",
     cancelUrl: process.env.NEXT_PUBLIC_APP_URL || "http://localhost:3000",
     resolveUser: async () => {
       const { userId } = await auth();
       return userId ? { id: userId } : null;
     },
   });
   

6. テスト

   • Next.js アプリを起動

   • 別ターミナルで Stripe Webhook を転送

     stripe listen --forward-to localhost:3000/api/stripe/webhook
     

ライブラリの使い方

チェックアウトをトリガー

import { checkout } from "stripe-no-webhooks/client";

<button onClick={() => checkout({ planName: "Pro", interval: "month" })}>
  Upgrade to Pro
</button>

テストカード：

4242 4242 4242 4242

サブスクリプション状態を確認

import { billing } from "@/lib/billing";

const subscription = await billing.subscriptions.get({ userId });

if (subscription?.status === "active") {
  console.log("Plan:", subscription.plan?.name);
}

背景で起こること

1. ユーザーがチェックアウト完了 → Stripe が Webhook を送信
2. ライブラリがデータを DB に同期し、クレジット/ウォレットを更新（有効なら）

3. billing.subscriptions.get

   は同期テーブルから読み込み
4. クレジット・ウォレット・使用量は内部 API で idempotent に追跡

stripe.subscriptions

stripe.credit_balances

stripe.credit_ledger

クレジット／ウォレット／使用量課金を使う

// クレジット：含まれる単位を消費
if (await billing.credits.hasCredits({ userId, key: "api_calls", amount: 1 })) {
  await billing.credits.consume({ userId, key: "api_calls", amount: 1 });
}

// ウォレット：プリペイド残高から差し引き（セント単位）
await billing.wallet.consume({
  userId,
  amount: 50,
  description: "AI generation",
});

// 使用量：期間末の課金用に記録
await billing.usage.record({ userId, key: "api_calls", amount: 1 });

課金ポータルを開く

import { customerPortal } from "stripe-no-webhooks/client";

<button onClick={() => customerPortal()}>
  Manage Billing
</button>

イベントに反応する

export const billing = new Billing({
  billingConfig,
  callbacks: {
    onSubscriptionCreated: async (subscription) => {
      // ウェルカムメール送信など
    },
    onSubscriptionCancelled: async (subscription) => {
      // リソースのクリーンアップ
    },
    // docs/reference.md にすべてのコールバックを掲載
  },
});

プライシングページを生成

npx stripe-no-webhooks generate pricing-page

components/PricingPage.tsx

import { PricingPage } from "@/components/PricingPage";

export default function Pricing() {
  return <PricingPage />;
}

コンポーネントはプラン取得・現在のサブスクリプション検出・月額/年額切替・チェックアウトフロー・リダイレクト・エラー処理などをハンドルします。

本番環境へ

1. billing.config.ts

   に本番プランを追加

2. 実行：

   npx stripe-no-webhooks sync
   

   「Set up for production」を選択すると CLI が以下を実施：

   • プランを Stripe ライブモードへ同期
   • Stripe で Webhook エンドポイント作成
   • Webhook URL とシークレットを表示

3. 環境変数に秘密情報を設定（例：Vercel）：

   STRIPE_WEBHOOK_SECRET=whsec_…
   STRIPE_SECRET_KEY=sk_live_…          # 重要: ライブキー
   DATABASE_URL=postgresql://user:pass@host:5432/dbname
   NEXT_PUBLIC_APP_URL=https://your-production-app.com
   

機能一覧

CLI コマンド

init

.env

migrate

sync

generate pricing-page

backfill

API リファレンス

完全な API は

docs/reference.md

LLM 固有の使い方も含めた詳細は以下で確認できます：

https://github.com/pretzelai/stripe-no-webhooks/blob/main/docs/llms.txt