Event SourcingとCQRSによる決済システム設計
不変の監査証跡、二重決済防止、楽観的ロックを備えた高信頼決済システムのアーキテクチャ設計。Event SourcingとCQRSの連携を解説。
フィンテック(Fintech)や大規模ECにおいて、決済システム(Payment System) は絶対的な正確性、高い耐障害性、改ざん不可能な監査証跡(Audit Trail)が求められる最重要インフラです。わずかな丸め誤差やタイムアウト時の二重引き落とし、取引データの不整合は、多額の金銭被害と法的な信用の失墜を招きます。
従来のCRUDモデル(データベースの行を UPDATE 文で直接上書きして口座残高を書き換える方式)は、決済領域において極めて脆弱です。ユーザーから異議申し立てがあった際、上書きされたデータベースでは「なぜその残高になったのか」を客観的に証明することができません。
この課題を根本から解決するため、StripeやWise、PayPalなどの世界的フィンテック企業は Event Sourcing と CQRS(Command Query Responsibility Segregation:コマンドクエリ責務分離) を組み合わせたアーキテクチャを標準として採用しています。
1. 10歳でもわかる説明(ELI5)#
決済システムを、「防犯カメラと消せない伝票がある銀行の金庫」 に例えてみましょう。
- 従来のCRUDモデル: 金庫番が金庫を開け、扉に貼られた「10万円」という紙を消しゴムで消して「7万円」と書き直します。監査の人が「差額の3万円はどこへ行ったの?」と聞いても、金庫番の記憶や外部のメモ帳に頼るしかありません。もし書き間違えていたら、誰がいつ間違えたのか検証不可能です。
- Event Sourcing + CQRS: 金庫番は絶対に金額を上書きしません。お金が動くたびに、破棄できない通し番号付きの「入出金伝票」を1行ずつ書き足します。
- 伝票1: お客様が口座に10万円を入金した。
- 伝票2: 電気代の請求書(INV-999)として3万円を出金した。
金庫の外側には、リアルタイムの電光掲示板(Read Model / CQRS) が設置されています。この掲示板は最新の伝票を読み取り、「現在の口座残高: 7万円」と即座に表示します。利用者は掲示板を瞬時に確認でき、金庫の中にある元の伝票束(Event Store)は厳重に保管され、何者も改ざんできません。
[!NOTE] Event Sourcingにおいて、残高はお金そのものではありません。残高とは、過去に発生したすべての取引イベントを合算した結果にすぎません。
2. マイクロサービスアーキテクチャの全体像#
決済システムは役割ごとに独立したマイクロサービス群に分割され、Apache Kafkaなどのメッセージブローカーを介して非同期連携することで、トラフィック急増時でもデータ欠落を防ぎます。
主なコンポーネントの役割は以下の通りです:
- Payment Gateway Service: クライアントからのリクエストを受信する境界サービス。暗号署名検証、レートリミット、Redisを用いたべき等キー(Idempotency Key)の検証を高速に処理します。
- Payment Ledger Service(書き込みサービス): Event Sourcingのコアとなる元帳エンジン。コマンドを受け取り、残高や整合性のルールを検証した上で、不変のイベントをEvent Storeに追記します。
- Payment Query Service(読み取りサービス): 事前集計された読み取り専用DBから、ミリ秒未満の超低レイテンシで取引履歴や残高の照会に応答します。
- Payment PSP Worker:
PaymentInitiatedイベントを購読し、外部銀行APIやカード決済ネットワーク(Stripe、Visaなど)を呼び出します。応答を受け取った後、完了コマンドをLedgerに送ります。 - Reconciliation Service(照合・対照): 内部のEvent Storeと提携銀行から提供される日次の清算データ(ISO 20022形式の取引明細)を突き合わせ、1円の狂いもないかを検証するバッチサービスです。
3. データベース設計:Event Store と Read Model#
Event Sourcingでは、信頼できる唯一の情報源(Event Store)と、クエリ表示に最適化されたビュー(Read Model)を明確に分離します。
A. Event Store(書き込みDB) - 不変のイベントログ#
このテーブルは INSERT 操作のみ が許可され、UPDATE や DELETE は物理的に禁止されます。PostgreSQLのパーティショニング機能、またはEventStoreDBなどの専用ストレージを活用します。
CREATE TABLE payment_events (
event_id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
aggregate_id UUID NOT NULL,
version INT NOT NULL,
event_type VARCHAR(64) NOT NULL,
event_data JSONB NOT NULL,
created_at TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP,
CONSTRAINT uq_aggregate_version UNIQUE (aggregate_id, version)
);
-- 集約単位でのイベント時系列リプレイを高速化するインデックス
CREATE INDEX idx_payment_events_aggregate ON payment_events (aggregate_id, version ASC);sql| カラム名 | データ型 | 説明 |
|---|---|---|
event_id (PK) | UUID | 各イベントの一意な識別子。 |
aggregate_id | UUID | 対象の集約ID(例: transaction_id または wallet_id)。 |
version | INT | 集約内での連番(楽観的ロック制御に使用)。 |
event_type | VARCHAR | イベント種別(PaymentInitiated, PaymentAuthorized, PaymentCompleted, PaymentFailed)。 |
event_data | JSONB | 金額、通貨、決済手段などの詳細ペイロード。 |
created_at | TIMESTAMP | イベントが発生した正確な時刻。 |
PaymentInitiated の event_data ペイロード例:
{
"amount": 50000,
"currency": "JPY",
"source_wallet": "wallet-abc-123",
"destination_merchant": "merchant-xyz-999",
"idempotency_key": "idem-uuid-9999",
"payment_method": "CREDIT_CARD"
}jsonB. Read Model(読み取りDB) - 高速照会用テーブル#
読み取りDBはKafka経由で非同期に更新されます。検索や表示の利便性を優先し、非正規化された構造で設計されます。
CREATE TABLE transactions (
transaction_id UUID PRIMARY KEY,
user_id UUID NOT NULL,
source_wallet VARCHAR(64) NOT NULL,
destination_merchant VARCHAR(64) NOT NULL,
amount DECIMAL(18, 2) NOT NULL,
currency VARCHAR(8) NOT NULL,
status VARCHAR(32) NOT NULL, -- PENDING, SUCCESS, FAILED
failure_reason TEXT,
updated_at TIMESTAMP WITH TIME ZONE NOT NULL
);
CREATE INDEX idx_transactions_user_status ON transactions (user_id, status);sql4. エンドツーエンドのデータフロー#
1件の決済処理は、以下の5つのステップを経て厳格に実行されます。
- コマンド発行: クライアントが「決済」ボタンを押下。Gatewayは認証およびRedis内の
Idempotency-Keyを確認し、CreatePaymentCommandを送信。 - 検証とイベント追記: Ledger Serviceは過去のイベントを再生して残高の整合性を確認し、
PaymentInitiatedイベントをEvent Storeに追記。 - イベント配信: 追記されたイベントはApache Kafkaへパブリッシュ(Transactional Outboxパターンによりメッセージの欠落を防止)。
- プロジェクション更新: Payment Query Serviceがイベントを消費し、Read DBにステータス
PENDINGのレコードを作成。 - 外部決済と完了処理: PSP Workerが銀行決済を実行し、成功確認後に
PaymentCompletedイベント(version 2)を発行。Read DBのステータスがSUCCESSに更新されます。
5. 決済特有の障害対策と設計プラクティス#
二重決済の防止(べき等性パターン)#
ネットワークの切断や利用者の連打による多重リクエストを防止します。
- クライアントは一意のUUIDである
Idempotency-Keyヘッダーを送信。 - GatewayはRedisの分散ロック(
SET NX EX 86400)を用いて24時間キーを保持。 - 処理中に同一キーのリクエストが来た場合は HTTP
409 Conflictを返し、処理完了後であればキャッシュされた実行結果を即座に再返却します。
import type { Request, Response, NextFunction } from 'express';
import Redis from 'ioredis';
const redis = new Redis(process.env.REDIS_URL!);
export async function idempotencyMiddleware(req: Request, res: Response, next: NextFunction) {
const idempotencyKey = req.header('Idempotency-Key');
if (!idempotencyKey) {
return res.status(400).json({ error: 'Idempotency-Key ヘッダーが必要です' });
}
const cacheKey = `idempotency:${idempotencyKey}`;
const cachedResponse = await redis.get(cacheKey);
if (cachedResponse) {
const parsed = JSON.parse(cachedResponse);
return res.status(parsed.status).json(parsed.body);
}
// 二重送信を防ぐ分散ロックの取得
const acquired = await redis.set(`lock:${idempotencyKey}`, 'LOCKED', 'EX', 10, 'NX');
if (!acquired) {
return res.status(409).json({ error: '現在リクエストを処理中です。しばらくお待ちください' });
}
next();
}typescript残高競合の防止(楽観的ロック制御)#
残高1万円の口座に対して、ミリ秒単位で同時に8,000円の引き落としが2件発生した場合:
- Event Sourcingでは、テーブルの複合ユニーク制約
UNIQUE (aggregate_id, version)が自動的に防波堤となります。 - トランザクションAとBが共に
version = 5から開始した場合、先に書き込みを完了したAがversion = 6を獲得。 - 直後に到達したBの書き込みはPostgreSQLのユニーク制約違反により即座に失敗。
- Ledgerは衝突を検知して最新状態を再読み込みし、残高不足として取引Bを安全に拒否します。
レコンシリエーション(対照照合)#
外部ネットワークの障害により、銀行側では引き落とされたがWebhook通知が届かなかったケースを救済します。
- 毎日深夜(T+1)に外部銀行から送られる確定決済明細データを取り込みます。
- 3者間照合(Three-way Matching):内部Event Store vs ゲートウェイログ vs 銀行確定明細を全件比較。
- 状態の不整合を検知した場合は、補償イベント(
PaymentAutoResolved等)を自動発行してシステムを修復します。
6. TypeScriptによる集約(Aggregate)の実装例#
// 1. ドメインイベントの定義
export interface PaymentInitiatedEvent {
type: 'PaymentInitiated';
transactionId: string;
userId: string;
amount: number;
timestamp: string;
}
export interface PaymentCompletedEvent {
type: 'PaymentCompleted';
transactionId: string;
bankRefId: string;
timestamp: string;
}
export interface PaymentFailedEvent {
type: 'PaymentFailed';
transactionId: string;
reason: string;
timestamp: string;
}
export type PaymentEvent = PaymentInitiatedEvent | PaymentCompletedEvent | PaymentFailedEvent;
// 2. 集約ルート(Aggregate Root)
export class PaymentTransactionAggregate {
public id: string = '';
public userId: string = '';
public amount: number = 0;
public status: 'INITIAL' | 'PENDING' | 'SUCCESS' | 'FAILED' = 'INITIAL';
public version: number = 0;
// 過去のイベント履歴を適用して状態を復元
public loadFromHistory(events: PaymentEvent[]): void {
for (const event of events) {
this.applyEvent(event);
this.version += 1;
}
}
private applyEvent(event: PaymentEvent): void {
switch (event.type) {
case 'PaymentInitiated':
this.id = event.transactionId;
this.userId = event.userId;
this.amount = event.amount;
this.status = 'PENDING';
break;
case 'PaymentCompleted':
this.status = 'SUCCESS';
break;
case 'PaymentFailed':
this.status = 'FAILED';
break;
}
}
// コマンド:決済の初期化
public initiatePayment(transactionId: string, userId: string, amount: number): PaymentInitiatedEvent {
if (this.status !== 'INITIAL') {
throw new Error('取引は既に初期化されています');
}
if (amount <= 0) {
throw new Error('決済金額は0より大きい必要があります');
}
const event: PaymentInitiatedEvent = {
type: 'PaymentInitiated',
transactionId,
userId,
amount,
timestamp: new Date().toISOString()
};
this.applyEvent(event);
return event;
}
// コマンド:提携銀行からの完了確認
public completePayment(bankRefId: string): PaymentCompletedEvent {
if (this.status !== 'PENDING') {
throw new Error(`ステータス ${this.status} の取引は完了できません`);
}
const event: PaymentCompletedEvent = {
type: 'PaymentCompleted',
transactionId: this.id,
bankRefId,
timestamp: new Date().toISOString()
};
this.applyEvent(event);
return event;
}
}typescript7. まとめ#
Event SourcingとCQRSの組み合わせは、決済システムにおける多くの難問を根本から解決します:
- 完全な監査証跡: 全ての金銭移動が不変の事実として記録され、タイムトラベル検証が可能。
- 書き込みと読み取りの最適化: 追記専用ログによる高い書き込み性能と、非正規化DBによる高速なユーザー照会を両立。
- 金融グレードの耐障害性: べき等性キー、楽観的ロック制御、日次レコンシリエーションが一体となった堅牢なアーキテクチャを実現。
参考文献#
- Martin Fowler - Event Sourcing Pattern ↗
- Martin Fowler - CQRS (Command Query Responsibility Segregation) ↗
- Stripe Engineering: Designing Robust and Idempotent Payment APIs ↗
- Designing Data-Intensive Applications - Martin Kleppmann ↗
- Microsoft Architecture: Event Sourcing Pattern ↗
- Enterprise Integration Patterns - Gregor Hohpe & Bobby Woolf ↗