Thiết kế hệ thống thanh toán với Event Sourcing và CQRS
Thiết kế kiến trúc hệ thống thanh toán chịu lỗi cao, chống thanh toán trùng, kiểm toán bất biến với Event Sourcing, CQRS và Apache Kafka.
Trong lĩnh vực công nghệ tài chính (Fintech) và thương mại điện tử, hệ thống thanh toán (Payment System) là thành phần cốt lõi đòi hỏi tính chính xác tuyệt đối, khả năng chịu lỗi cao và dấu vết kiểm toán (audit trail) không thể làm giả. Chỉ một lỗi làm tròn tiền, một giao dịch thanh toán trùng lặp (double-spending), hay sự cố mất dữ liệu khi ngân hàng đối tác phản hồi chậm cũng có thể dẫn đến thất thoát hàng tỷ đồng và vi phạm quy định pháp lý tài chính.
Các mô hình CRUD truyền thống — nơi ta ghi đè trực tiếp số dư tài khoản bằng câu lệnh UPDATE — hoàn toàn không đủ độ tin cậy. Khi xảy ra tranh chấp hoặc kiểm toán, database CRUD không thể chứng minh tiền đã đi đâu và vì sao số dư bị thay đổi.
Kết hợp Event Sourcing và CQRS (Command Query Responsibility Segregation) là lựa chọn tiêu chuẩn vàng được các tập đoàn tài chính hàng đầu như Stripe, Wise hay PayPal áp dụng để giải quyết bài toán này.
1. Giải thích theo kiểu ELI5 (Dễ hiểu cho bé 10 tuổi)#
Hãy tưởng tượng hệ thống thanh toán giống như một két sắt ngân hàng có camera giám sát và tập phiếu thu chi:
- Mô hình CRUD thông thường: Người thủ quỹ mở két sắt ra, lấy bút xóa đi con số 10 triệu dán trên cánh cửa và dán đè lên con số 7 triệu. Nếu ai đó hỏi “3 triệu đã đi đâu?”, thủ quỹ chỉ có thể nhớ mang máng hoặc lục tìm sổ nháp bên ngoài. Nếu con số bị dán nhầm, không ai biết ai đã dán và vào lúc nào.
- Event Sourcing + CQRS: Người thủ quỹ không bao giờ dán đè số tiền. Mỗi khi có tiền vào hoặc ra, thủ quỹ bắt buộc phải viết một tờ phiếu không thể tẩy xóa:
- Phiếu #1: Khách hàng nộp 10 triệu vào két.
- Phiếu #2: Rút 3 triệu thanh toán tiền điện thoại cho hóa đơn INV-999.
Bên cạnh két sắt có một màn hình điện tử (Read Model / CQRS): Màn hình này tự động đọc các tờ phiếu vừa xuất và hiển thị ngay lập tức: “Số dư hiện tại: 7 triệu”. Khách hàng chỉ cần nhìn vào màn hình để biết tiền của mình, còn két sắt và hòm phiếu gốc (Event Store) được bảo vệ tuyệt mật, không ai có quyền sửa hay xé bỏ.
[!NOTE] Trong Event Sourcing, tiền không phải là một con số tĩnh trong bảng cơ sở dữ liệu. Tiền là tổng hợp của mọi biến động đã từng xảy ra trong lịch sử.
2. Kiến trúc Microservices cho hệ thống thanh toán#
Hệ thống được module hóa thành các dịch vụ độc lập, giao tiếp với nhau bất đồng bộ qua Message Broker (như Apache Kafka) để đảm bảo không mất mát dữ liệu khi lưu lượng truy cập tăng đột biến.
Hệ thống bao gồm các dịch vụ chuyên biệt:
- Payment Gateway Service: Cổng tiếp nhận yêu cầu thanh toán từ người dùng hoặc đối tác (Merchant). Đảm nhiệm kiểm tra bảo mật (HMAC/mTLS), rate limiting, kiểm tra tính duy nhất (Idempotency Key qua Redis) và phản hồi kết quả tức thì.
- Payment Ledger Service (Write Service): Trái tim của kiến trúc Event Sourcing. Tiếp nhận lệnh (
Commands), kiểm tra tính hợp lệ của ví/tài khoản, thực thi logic nghiệp vụ và ghi sự kiện vào Event Store. - Payment Query Service (Read Service): Phục vụ tra cứu lịch sử giao dịch, biến động số dư và trạng thái hóa đơn với độ trễ thấp từ Read Database đã được chuẩn hóa.
- Payment PSP Worker: Lắng nghe sự kiện để gọi API sang các cổng thanh toán bên thứ ba (Stripe, Visa, Napas). Khi có phản hồi, worker gửi tiếp command hoàn tất thanh toán.
- Reconciliation Service (Đối soát): Tiến trình xử lý ngầm định kỳ (Batch Job) để so khớp dòng sự kiện trong Event Store nội bộ với sao kê thanh quyết toán từ phía ngân hàng (Bank Statement) nhằm phát hiện sai lệch từng xu.
3. Thiết kế Database: Event Store & Read Model#
Mô hình Event Sourcing phân định ranh giới rõ ràng giữa dữ liệu nguồn sự thật (Event Store) và dữ liệu tối ưu hiển thị (Read Model).
A. Event Store (Write DB) - Chuỗi sự kiện bất biến#
Bảng này chỉ có thao tác INSERT, nghiêm cấm mọi thao tác UPDATE và DELETE. Ta có thể triển khai trên PostgreSQL (kèm kỹ thuật Table Partitioning theo tháng) hoặc các cơ sở dữ liệu chuyên dụng như 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)
);
-- Index tối ưu cho việc replay toàn bộ event của một giao dịch theo thời gian
CREATE INDEX idx_payment_events_aggregate ON payment_events (aggregate_id, version ASC);sql| Tên trường | Kiểu dữ liệu | Mô tả chi tiết |
|---|---|---|
event_id (PK) | UUID | Khóa chính, định danh duy nhất của mỗi sự kiện. |
aggregate_id | UUID | Định danh thực thể (ví dụ: transaction_id hoặc wallet_id). |
version | INT | Thứ tự tăng dần của sự kiện trong aggregate (phục vụ Optimistic Concurrency Control). |
event_type | VARCHAR | Loại sự kiện (PaymentInitiated, PaymentAuthorized, PaymentCompleted, PaymentFailed). |
event_data | JSONB | Toàn bộ payload chi tiết của sự kiện. |
created_at | TIMESTAMP | Thời điểm chính xác sự kiện phát sinh trong thực tế. |
Ví dụ về nội dung payload event_data của sự kiện PaymentInitiated:
{
"amount": 500000,
"currency": "VND",
"source_wallet": "wallet-abc-123",
"destination_merchant": "merchant-xyz-999",
"idempotency_key": "idem-uuid-9999",
"payment_method": "DOMESTIC_ATM"
}jsonB. Read Model (Read DB) - Tối ưu truy vấn đọc tốc độ cao#
Dữ liệu ở phía đọc được các Consumer đồng bộ bất đồng bộ từ Kafka. Do phục vụ truy vấn của Client và hệ thống báo cáo, bảng này có thể tổ chức phi chuẩn hóa (Denormalized) trên PostgreSQL, MySQL hoặc Elasticsearch.
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. Quy trình dòng chảy dữ liệu (Data Flow)#
Quy trình xử lý một giao dịch thanh toán chuẩn diễn ra qua 5 bước nghiêm ngặt:
- Gửi lệnh (Command): Khách hàng nhấn thanh toán.
Payment Gatewaykiểm tra tính hợp lệ của token và tra cứuIdempotency-Keytrong Redis. Nếu hợp lệ, Gateway gửiCreatePaymentCommandsangPayment Ledger Service. - Xác thực & Ghi Event:
Ledger Servicenạp các sự kiện cũ của ví để dựng lại số dư tức thời. Nếu số dư đủ, dịch vụ tạo sự kiệnPaymentInitiatedvà ghi vàoEvent Store. - Phát sóng sự kiện: Sự kiện vừa ghi được đưa vào hàng đợi
Apache Kafka(thông qua Transactional Outbox Pattern để bảo đảm không bao giờ mất thông điệp). - Cập nhật Read Model (Projection):
Payment Query Serviceconsume event từ Kafka và tạo một dòng giao dịch với trạng tháiPENDINGvào bảngtransactionsở Read DB. - Ủy quyền bên thứ ba & Hoàn tất:
Payment PSP Workerlắng nghe sự kiệnPaymentInitiated, thực hiện lệnh gọi API sang cổng ngân hàng đối tác. Khi ngân hàng xác nhận thành công, một command mới được gửi đến Ledger để ghi tiếp sự kiệnPaymentCompleted(version 2), từ đó cập nhật trạng tháiSUCCESStrên Read DB.
5. Giải pháp xử lý sự cố đặc thù ngành thanh toán#
Chống thanh toán trùng lặp (Idempotency Pattern)#
Trong mạng Internet, việc rớt gói tin hoặc timeout mạng khiến client vô tình bấm nút thanh toán nhiều lần là điều rất phổ biến.
- Giải pháp: Mọi yêu cầu thanh toán bắt buộc phải đính kèm một
Idempotency-Keydạng UUID từ client. Payment Gatewaysử dụng Redis Distributed Lock (SET NX EX 86400) để khóa key này trong 24 giờ.- Nếu client gửi lại cùng key trong khi request trước đang chạy, hệ thống trả về HTTP
409 Conflict. Nếu request trước đã hoàn thành, hệ thống lập tức trả lại kết quả đã cache mà không kích hoạt xử lý giao dịch lần hai.
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: 'Thiếu header Idempotency-Key bắt buộc' });
}
const cacheKey = `idempotency:${idempotencyKey}`;
const existingResult = await redis.get(cacheKey);
if (existingResult) {
const cachedResponse = JSON.parse(existingResult);
return res.status(cachedResponse.status).json(cachedResponse.body);
}
// Khóa phân tán chống race condition gửi 2 request cùng lúc
const acquired = await redis.set(`lock:${idempotencyKey}`, 'LOCKED', 'EX', 10, 'NX');
if (!acquired) {
return res.status(409).json({ error: 'Giao dịch đang được xử lý, vui lòng không gửi lặp lại' });
}
next();
}typescriptChống tranh chấp số dư (Race Condition & Optimistic Concurrency Control)#
Nếu khách hàng chỉ có 1 triệu đồng nhưng cùng lúc mở 2 ứng dụng để bấm thanh toán 2 đơn hàng 800.000 đ tại cùng một mili-giây:
- Khóa dòng vật lý (
SELECT ... FOR UPDATE) trong DB thông thường dễ gây nghẽn cổ chai và deadlock nghiêm trọng. - Với Event Sourcing, ta sử dụng Ràng buộc duy nhất
(aggregate_id, version). - Khi giao dịch A và B cùng đọc số dư ở phiên bản
version = 5:- Giao dịch A thực thi nhanh hơn, ghi sự kiện mới với
version = 6thành công. - Giao dịch B cố gắng ghi sự kiện với
version = 6sẽ bị PostgreSQL từ chối ngay lập tức do vi phạmUNIQUE (aggregate_id, version). - Hệ thống tự động bắt lỗi xung đột phiên bản, nạp lại dữ liệu mới nhất (lúc này số dư đã bị trừ bởi A) và từ chối giao dịch B do không đủ số dư.
- Giao dịch A thực thi nhanh hơn, ghi sự kiện mới với
Đối soát sai lệch tiền (Reconciliation Service)#
Dù hệ thống có tin cậy đến đâu, mạng viễn thông giữa hệ thống của bạn và ngân hàng đối tác vẫn có thể bị đứt gãy giữa chừng (ví dụ ngân hàng trừ tiền thành công nhưng gửi Webhook thất bại).
- Cơ chế: Dịch vụ đối soát định kỳ chạy cuối ngày (T+1) lấy file sao kê điện tử từ ngân hàng (chuẩn ISO 20022 hoặc CSV).
- Thực hiện so khớp 3 chiều (Three-way matching): Event Store nội bộ vs Nhật ký Gateway vs Sao kê ngân hàng.
- Nếu phát hiện giao dịch ngân hàng đã trừ tiền nhưng Event Store vẫn ở
PaymentInitiated, hệ thống tự động phát sinh sự kiện bù trừ (PaymentAutoResolvedhoặcCompensatingRefundIssued) để hoàn tiền hoặc mở khóa dịch vụ cho khách.
6. Minh họa triển khai Aggregate bằng TypeScript#
// 1. Định nghĩa các Event
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 quản lý trạng thái và nghiệp vụ
export class PaymentTransactionAggregate {
public id: string = '';
public userId: string = '';
public amount: number = 0;
public status: 'INITIAL' | 'PENDING' | 'SUCCESS' | 'FAILED' = 'INITIAL';
public version: number = 0;
// Replay các event trong quá khứ để tái tạo trạng thái
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;
}
}
// Khởi tạo giao dịch mới
public initiatePayment(transactionId: string, userId: string, amount: number): PaymentInitiatedEvent {
if (this.status !== 'INITIAL') {
throw new Error('Giao dịch đã tồn tại');
}
if (amount <= 0) {
throw new Error('Số tiền thanh toán phải lớn hơn 0');
}
const event: PaymentInitiatedEvent = {
type: 'PaymentInitiated',
transactionId,
userId,
amount,
timestamp: new Date().toISOString()
};
this.applyEvent(event);
return event;
}
// Xác nhận thành công từ phía ngân hàng
public completePayment(bankRefId: string): PaymentCompletedEvent {
if (this.status !== 'PENDING') {
throw new Error(`Không thể hoàn tất giao dịch ở trạng thái: ${this.status}`);
}
const event: PaymentCompletedEvent = {
type: 'PaymentCompleted',
transactionId: this.id,
bankRefId,
timestamp: new Date().toISOString()
};
this.applyEvent(event);
return event;
}
}typescript7. Tổng kết#
Kết hợp Event Sourcing và CQRS không đơn thuần là một giải pháp kỹ thuật, mà là nền tảng kiến trúc bắt buộc cho bất kỳ hệ thống thanh toán và tài chính chuyên nghiệp nào:
- Bảo toàn dữ liệu tuyệt đối: Bất kỳ thay đổi nào cũng là một bản ghi bất biến trong Event Store.
- Tối ưu hóa hiệu năng đọc/ghi độc lập: Phía ghi đẩy nhanh tốc độ nhờ cơ chế chèn nối tiếp, trong khi phía đọc phục vụ người dùng bằng các bảng dữ liệu chuyên biệt.
- Giải quyết triệt để sự cố tài chính: Tự nhiên tích hợp khả năng chống thanh toán trùng, chống xung đột số dư qua Optimistic Concurrency và đối soát tự động hóa.
Tài liệu tham khảo#
- 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 ↗