Kỹ thuật & AI
Sổ cái giao dịch cho ví, điểm thưởng và thanh toán: làm đúng từ đầu (Part 1)
Khi mạng chập chờn, một yêu cầu thanh toán có thể được gửi hai lần. Thiết kế sổ cái và kiểm tra mỗi giao dịch chỉ ghi một lần.
Tóm tắt
- Thiết kế sổ cái từ các ca cần qua ngay ở bản đầu, như gửi lại yêu cầu thanh toán mà số dư chỉ bị trừ một lần.
- Idempotency key và khóa tài khoản theo thứ tự cố định chặn trừ tiền hai lần và deadlock.
- Ghi sự kiện vào bảng outbox trong cùng transaction để không mất thông báo khi hệ thống lỗi.

Khách bấm thanh toán, mạng chập chờn và ứng dụng gửi lại yêu cầu: nếu hệ thống xử lý cả hai, khách có thể bị trừ tiền hai lần. Bài này chỉ cách thiết kế sổ cái cho ví hoặc điểm thưởng và kiểm thử năm tình huống dễ làm sai số dư, ghi trùng giao dịch hoặc mất thông báo.
Bài tổng hợp từ tài liệu của Stripe, PostgreSQL, microservices.io, Modern Treasury và một bài chia sẻ trong group Back-end Golang từ A-Z (ngày 18/11/2026).
Khi nào một cột số dư không còn đủ?
- Doanh nghiệp giữ số dư cho khách: ví, điểm thưởng, tiền trả trước, hoa hồng đối tác hoặc công nợ.
- Bản đầu thường chỉ có một cột
balancevà cộng trừ trực tiếp vào đó. Cách này chạy được khi còn ít giao dịch. - Lỗi bắt đầu xuất hiện khi giao dịch tăng, khi có nhiều yêu cầu cùng lúc, hoặc khi phải đối soát với cổng thanh toán và kế toán.
- Chưa cần đọc tiếp nếu mọi khoản thanh toán đi thẳng qua cổng thanh toán bên ngoài và hệ thống không giữ số dư.
1. Số dư sai nhưng không biết sai từ đâu
Vấn đề
Số dư trong hệ thống lệch với cổng thanh toán. Cột balance chỉ cho biết con số hiện tại, không cho biết vì sao nó thành như vậy.
Đánh giá
- Thêm bảng lịch sử bên cạnh cột số dư: dễ làm, nhưng hai nơi có thể lệch nhau mà không ai phát hiện.
- Kế toán kép: mỗi giao dịch ghi ít nhất hai bút toán, một bên trừ và một bên cộng, tổng bằng 0. Số dư là tổng các bút toán. Modern Treasury gọi đây là cách theo dõi tiền đáng tin cậy nhất.
Giải pháp
- Tạo ba bảng:
accounts,transactionsvàledger_entries(mỗi dòng một bút toán: tài khoản, số tiền có dấu, giao dịch). - Kiểm tra tổng bút toán bằng 0 cho mỗi giao dịch, trong cùng database transaction, trước khi commit.
- Chặn
UPDATEvàDELETEtrênledger_entriesbằng phân quyền database hoặc trigger. Ghi sai thì thêm bút toán đảo, liên kết với giao dịch gốc. - Cột số dư lưu sẵn chỉ để đọc nhanh và phải luôn bằng tổng bút toán.
- Kiểm tra: mọi giao dịch có tổng bằng 0, số dư lưu sẵn bằng tổng bút toán, và lệnh
UPDATElên một bút toán bị từ chối.
2. Lệch vài đồng sau nhiều giao dịch
Vấn đề
Cộng dồn nhiều khoản lẻ cho ra kết quả lệch vài đồng so với tính tay, và đối soát cuối ngày không khớp.
Đánh giá
FLOAT,DOUBLE: số thực dấu phẩy động làm tròn theo hệ nhị phân, sai số cộng dồn qua từng giao dịch.DECIMAL: chính xác, hợp khi cần nhiều chữ số lẻ.BIGINTtheo đơn vị nhỏ nhất (đồng, cent): chính xác và đơn giản, chỉ cần quy đổi khi hiển thị.
Giải pháp
- Lưu tiền bằng
BIGINTtheo đơn vị nhỏ nhất, hoặcDECIMALnếu cần chữ số lẻ. Không dùngFLOAT. - Kiểm tra: cộng dồn hàng nghìn khoản lẻ rồi so với kết quả tính trước, không lệch đồng nào.
3. Khách bấm hai lần hoặc mạng lỗi, tiền bị trừ hai lần
Vấn đề
Client không nhận được phản hồi nên gửi lại yêu cầu. Server xử lý cả hai, và khách bị trừ tiền hai lần.
Đánh giá
- Khóa nút sau khi bấm: nên có, nhưng không chặn được app hay cổng thanh toán tự gửi lại.
- Tìm giao dịch trùng trong code rồi mới ghi: hai yêu cầu đến cùng lúc vẫn lọt qua cả hai.
- Idempotency key với ràng buộc
UNIQUE: database chặn bản trùng, kể cả khi hai yêu cầu đến cùng lúc. Stripe dùng cách này cho API thanh toán.
Giải pháp
- Client tạo key (thường là UUID) và gửi kèm header
Idempotency-Keyvới mọi yêu cầu ghi tiền. - Server lưu key cùng kết quả, với ràng buộc
UNIQUE. Key lặp lại thì trả kết quả cũ; cùng key mà khác tham số thì báo lỗi. - Đặt thời hạn cho key. Stripe cho key dài tối đa 255 ký tự, xóa key sau ít nhất 24 giờ, và khuyên không dùng email hay thông tin cá nhân làm key.
- Kiểm tra: gửi cùng một yêu cầu hai lần song song, chỉ có một giao dịch được ghi.
4. Hai giao dịch cùng lúc làm âm số dư hoặc treo hệ thống
Vấn đề
Hai lệnh trừ tiền cùng đọc số dư cũ nên cả hai đều qua, và số dư âm. Hoặc A chuyển cho B đúng lúc B chuyển cho A, hai transaction chờ khóa của nhau mãi (deadlock).
Đánh giá
- Khóa lạc quan (cột
version): nhanh khi ít va chạm. Với tài khoản nhận nhiều giao dịch, lệnh ghi thất bại và phải thử lại liên tục. - Khóa bi quan (
SELECT … FOR UPDATE): an toàn, nhưng giảm thông lượng nếu giữ khóa lâu, và gây deadlock nếu các transaction khóa theo thứ tự khác nhau. - Với bản chạy đầu tiên, khóa bi quan theo thứ tự cố định dễ làm đúng hơn.
Giải pháp
- Khóa các tài khoản liên quan bằng
SELECT … FOR UPDATE, theoaccount_idtăng dần. Tài liệu PostgreSQL khuyên khóa theo một thứ tự nhất quán để tránh deadlock. - Kiểm tra số dư sau khi đã khóa, rồi mới ghi bút toán.
- Giữ transaction ngắn. Không gọi cổng thanh toán hay gửi email bên trong transaction. Gặp deadlock thì thử lại.
- Kiểm tra: chạy song song A chuyển cho B và B chuyển cho A nhiều lần, không deadlock và số dư cuối đúng.
5. Đã ghi sổ nhưng khách không nhận được thông báo
Vấn đề
Ghi sổ xong mới gửi thông báo hoặc đẩy sự kiện sang hệ thống khác. Hệ thống lỗi giữa hai bước thì sự kiện mất. Gửi bên trong transaction thì có lúc transaction rollback nhưng thông báo đã đi.
Đánh giá
- Gửi sự kiện sau khi commit: đơn giản, nhưng có thể mất sự kiện khi lỗi.
- 2PC giữa database và message broker: microservices.io nêu lý do không nên dùng. Nhiều hệ thống không hỗ trợ, và nó buộc chặt service vào cả hai.
- Outbox: ghi sự kiện vào một bảng trong cùng transaction, một worker gửi đi sau. Không mất sự kiện, nhưng có thể gửi lặp, nên bên nhận phải xử lý trùng an toàn.
Giải pháp
- Tạo bảng
outbox_events, ghi cùng transaction với bút toán. - Worker đọc bảng và gửi đi (hàng đợi, thông báo số dư), rồi đánh dấu đã gửi.
- Bên nhận dùng ID sự kiện để bỏ qua sự kiện đã xử lý.
- Kiểm tra: tắt worker rồi bật lại, mọi sự kiện vẫn được gửi đủ.
Chuẩn bị cho AI agent
- Các loại tài khoản: ví khách hàng, doanh thu, phí, tài khoản trung gian của cổng thanh toán.
- Đơn vị tiền và số chữ số lẻ cần lưu.
- Các luồng giao dịch: nạp, thanh toán, hoàn tiền, chuyển giữa các tài khoản.
- Database đang dùng (PostgreSQL, MySQL…) và cách client gọi vào (HTTP, hàng đợi).
- Quy tắc số dư âm: tài khoản nào được phép âm.
- Một dòng yêu cầu rõ ràng: không bao giờ sửa hay xóa bút toán, chỉ thêm bút toán đảo.
Không nằm trong bài này
Tách luồng đọc và ghi (CQRS, read replica), chia shard theo tài khoản, tách tài khoản nhận nhiều giao dịch thành tài khoản con, Saga với giao dịch bù trừ giữa nhiều service, và đối soát tự động với ngân hàng. Các phần này sẽ ở Part 2.
Thuật ngữ trong bài (6)
- Sổ cái giao dịch (ledger)
- Nơi ghi mọi biến động tiền hoặc giá trị quy đổi, mỗi dòng là một bút toán không sửa được.
- Kế toán kép (double-entry)
- Mỗi giao dịch ghi ít nhất hai bút toán, một bên trừ và một bên cộng, tổng bằng 0.
- Bút toán đảo
- Bút toán mới ghi ngược lại một bút toán sai, thay cho việc sửa hay xóa dòng cũ.
- Idempotency
- Gửi cùng một yêu cầu nhiều lần nhưng kết quả chỉ xảy ra một lần.
- Deadlock
- Hai transaction chờ khóa của nhau nên không cái nào chạy tiếp được.
- Outbox pattern
- Ghi sự kiện vào một bảng trong cùng transaction với dữ liệu, rồi một tiến trình khác đọc bảng đó và gửi sự kiện đi.
Câu hỏi thường gặp
Vì sao không chỉ lưu một cột số dư trong bảng tài khoản?
Vì không truy được số dư thay đổi do đâu. Sổ cái kép ghi mọi biến động thành bút toán, nên số dư luôn đối soát được.
Idempotency key nên do ai tạo?
Client tạo, thường là UUID, và gửi kèm mỗi yêu cầu ghi tiền. Server lưu key với ràng buộc UNIQUE và trả lại kết quả cũ khi key lặp lại.
Khi nào cần đến Part 2?
Khi một tài khoản nhận rất nhiều giao dịch cùng lúc, khi dữ liệu sổ cái lớn tới mức một database không chịu nổi, hoặc khi giao dịch đi qua nhiều service.
Nguồn tham khảo
- Idempotent requests, Stripe
- Pattern: Transactional outbox, microservices.io
- Explicit Locking, PostgreSQL
- Accounting for Developers, Part I, Modern Treasury
- Thiết kế hệ thống giao dịch ngân hàng: tính nhất quán tuyệt đối và khả năng kiểm toán, Back-end Golang từ A-Z (Facebook)