blog.dopana

Quay lại

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:
    1. Phiếu #1: Khách hàng nộp 10 triệu vào két.
    2. 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.

Gửi yêu cầu thanh toánRedis Idempotency CheckLệnh CreatePaymentAppend EventPublish EventConsume EventCập nhật ProjectionConsume EventGọi cổng đối tácWebhook kết quảClient / MerchantPayment Gateway ServiceRedis CachePayment Ledger Service(Write Service)Event StorePostgreSQL / EventStoreDBApache Kafka(Message Broker)Payment Query Service(Read Service)Read DatabasePostgreSQL / ElasticClient Query Tra cứuPayment PSP WorkerNgân hàng đối tác / Visa /Napas

Hệ thống bao gồm các dịch vụ chuyên biệt:

  1. 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ì.
  2. 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.
  3. 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.
  4. 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.
  5. 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.

schema-event-store.sql
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ườngKiểu dữ liệuMô tả chi tiết
event_id (PK)UUIDKhóa chính, định danh duy nhất của mỗi sự kiện.
aggregate_idUUIDĐịnh danh thực thể (ví dụ: transaction_id hoặc wallet_id).
versionINTThứ tự tăng dần của sự kiện trong aggregate (phục vụ Optimistic Concurrency Control).
event_typeVARCHARLoại sự kiện (PaymentInitiated, PaymentAuthorized, PaymentCompleted, PaymentFailed).
event_dataJSONBToàn bộ payload chi tiết của sự kiện.
created_atTIMESTAMPThờ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:

payload-payment-initiated.json
{
  "amount": 500000,
  "currency": "VND",
  "source_wallet": "wallet-abc-123",
  "destination_merchant": "merchant-xyz-999",
  "idempotency_key": "idem-uuid-9999",
  "payment_method": "DOMESTIC_ATM"
}
json

B. 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.

schema-read-model.sql
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);
sql

4. 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:

123456789101112131415POST /payments (Kèm Idempotency-Key)Kiểm tra Idempotency KeyGửi CreatePaymentCommandKiểm tra số dư & Append sự kiện PaymentInitiatedLưu thành công (Version: 1)Phát sóng sự kiện PaymentInitiatedProjector ghi bản ghi mới (Status: PENDING)Worker nhận PaymentInitiatedGọi API thanh toán bên thứ baKết quả giao dịch (Thành công)Gửi CompletePaymentCommandAppend sự kiện PaymentCompleted (Version: 2)Phát sóng PaymentCompletedProjector cập nhật (Status: SUCCESS)Tra cứu trạng thái giao dịch: Nhận SUCCESSKhách hàngPayment GatewayRedis CachePayment Ledger ServiceEvent StoreApache KafkaRead DatabasePSP WorkerCổng Ngân hàng Đối tácKhách hàngPayment GatewayRedis CachePayment Ledger ServiceEvent StoreApache KafkaRead DatabasePSP WorkerCổng Ngân hàng Đối tác
  1. Gửi lệnh (Command): Khách hàng nhấn thanh toán. Payment Gateway kiểm tra tính hợp lệ của token và tra cứu Idempotency-Key trong Redis. Nếu hợp lệ, Gateway gửi CreatePaymentCommand sang Payment Ledger Service.
  2. Xác thực & Ghi Event: Ledger Service nạ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ện PaymentInitiated và ghi vào Event Store.
  3. 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).
  4. Cập nhật Read Model (Projection): Payment Query Service consume event từ Kafka và tạo một dòng giao dịch với trạng thái PENDING vào bảng transactions ở Read DB.
  5. Ủy quyền bên thứ ba & Hoàn tất: Payment PSP Worker lắng nghe sự kiện PaymentInitiated, 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ện PaymentCompleted (version 2), từ đó cập nhật trạng thái SUCCESS trê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-Key dạng UUID từ client.
  • Payment Gateway sử 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.

Chố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 = 6 thành công.
    • Giao dịch B cố gắng ghi sự kiện với version = 6 sẽ bị PostgreSQL từ chối ngay lập tức do vi phạm UNIQUE (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ư.

Đố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ừ (PaymentAutoResolved hoặc CompensatingRefundIssued) để 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#

7. 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#