カテゴリ
決済・課金（Stripe / サブスク / 冪等性）の実装ガイド
決済は「正しさ」を運用の注意深さではなく、コードの構造で保証する領域です。ネットワークは切れ、リクエストは重複し、Webhookは順不同で二重に届く——これを前提に、冪等性キー・署名検証・状態機械・サーバー側を真実源とする設計で、二重課金や残高不整合を構造的に不可能にします。Stripe実装から、AWSサーバーレスでの決済信頼性レイヤーまでを扱います。
全 7 記事
基礎ガイド
基礎ガイド（まずはここから）
StripeのWebhookと冪等性を本番品質で実装する：署名検証・順不同/少なくとも1回配信耐性・サブスク状態機械
Stripe公式ドキュメントに忠実な、決済の「壊れない」実装ガイド。Idempotency-Keyによる冪等なAPI呼び出し、Webhookの署名検証（raw body必須）と二重配信・順不同への耐性、サブスクのライフサイクルを状態機械として設計する手法、Stripe CLIでの検証までをTypeScriptの動くコードで解説します。
関連する実践記事
- AWSDynamoDBPythonサーバーレスアーキテクチャ設計
サーバーレス決済基盤で「二重課金ゼロ」を設計する — DynamoDBで冪等性・原子性・ゼロダウンタイム移行を実装した話
実際の金銭を扱うサーバーレス決済基盤の信頼性レイヤー設計。冪等性キーと条件付き書き込みで二重課金を防ぎ、DynamoDBトランザクションで残高整合性を担保し、二重書き込みで本番を止めずにスキーマを進化させた実装パターンを、実コードに基づいて解説します。
17分 - Stripe決済サブスクリプションNext.jsTypeScript
Stripe Billing 実装ガイド（2026年版・公式準拠）：サブスク・従量課金（Billing Meters / Metronome）・顧客ポータル・プロレーションを実コードで
Stripe Billing公式準拠の実装ガイド。サブスク開始（Checkout / Subscriptions API）、従量課金（Billing Meters）、Customer Portal、プロレーション、Webhook冪等処理をNext.js 16 + TypeScriptの実コードで解説。
20分 - Stripe決済Next.jsTypeScriptWebhook
Stripe決済を本番品質で実装する完全ガイド（2026年版・公式ドキュメント準拠）：Checkout Sessions・Webhook・冪等性・Connectを実コードで
Stripe公式ドキュメントに忠実な本番決済の実装ガイド。2026年標準の Checkout Sessions API でホスト型/埋め込み型決済を Next.js 16 に実装し、Webhook を唯一の真実源として冪等に処理、Idempotency-Key と event.id で二重課金を防ぎ、Connect でマーケットプレイスまで対応。本番二重課金0件の実務知見つき。
21分 - StripeStripe Connect決済AWSアーキテクチャ設計
Stripe Connect マーケットプレイス決済 本番ガイド：アカウント種別・課金モデル・Webhook冪等化を安全に設計する
Stripe Connectでマーケットプレイス/プラットフォーム決済を本番構築する実装ガイド。アカウント種別(Standard/Express/Custom)、direct/destination/separateの課金モデル、application fee、Account Linksオンボーディング、Webhook署名検証と冪等化、サーバ側金額解決のセキュリティを実コードで解説します。
26分 - StripeB2B SaaSTypeScriptアーキテクチャ設計決済
サブスク売上を取り戻すStripe実装ガイド2026：支払い失敗・ダンニング・スマートリトライで非自発的チャーンを減らす
サブスクの「静かな売上漏れ」=非自発的チャーンを止めるStripe実装ガイド。支払い失敗の状態機械（active→past_due→unpaid/canceled）、冪等なWebhook処理、Smart Retriesと独自リトライの使い分け、ダンニングメールと顧客ポータルでのSCA再認証、past_dueを尊重する権限制御まで、TypeScriptの実コードで解説します。
23分 - B2B SaaSアーキテクチャ設計Next.jsTypeScriptStripe
サブスク学習プラットフォームのアーキテクチャ徹底解剖：マルチチャネル課金・冪等な決済・代理店コミッション・型安全規律
Next.js 16 × Prisma のモノレポで作られた金融リテラシー教育のサブスク基盤を、実コードを唯一の真実源として解剖します。6系統の入力から料金を決定的に解決する純粋関数、Stripe Webhookの冪等性・順序保証・PII墨消し、銀行振込サブスクの状態機械、代理店コミッションの追記専用台帳、tokenVersionとOTPの認証、NeverErrorによる網羅検査までを実装レベルで解説。
20分