Case Studies
Thiết kế hệ thống thanh toán
Trừ tiền thẻ một cách tin cậy khi mạng timeout và nhà cung cấp chậm: idempotency key, sổ cái ghi kép, state machine, webhook và đối soát — và vì sao một lần retry ngây thơ tính tiền khách hai lần.
Nâng cao 6 phút đọc· Cập nhật 2026-11-18
Sau bài này bạn sẽ
- Giải thích vì sao timeout cộng retry sinh ra trừ tiền kép.
- Thiết kế API thanh toán idempotent bằng idempotency key.
- Mô hình hoá thanh toán bằng state machine dựa trên sổ cái ghi kép.
- Bịt các khoảng hở bằng webhook, outbox và đối soát hằng ngày.
Nên đọc trước
Yêu cầu
- Chức năng: checkout tạo một khoản thanh toán, thẻ được uỷ quyền và trừ tiền qua nhà cung cấp dịch vụ thanh toán (PSP), có thể hoàn tiền, và tiền được chuyển cho người bán.
- Phi chức năng: không bao giờ trừ tiền hai lần, không bao giờ mất một khoản thanh toán; mọi thay đổi trạng thái đều kiểm toán được; tính đúng quan trọng hơn độ trễ.
- Ràng buộc: PSP ở bên ngoài, có thể chậm, và có thể vẫn trừ tiền xong dù request của bạn đã timeout.
Ước lượng nhanh
| Đại lượng | Giả định | Kết quả |
|---|---|---|
| Thanh toán | 10 triệu mỗi ngày | ~120/giây trung bình, cao điểm ~1.000/giây vào ngày sale |
| Bút toán sổ cái | ~4 bút toán mỗi khoản (nợ/có, phí) | ~40 triệu dòng mỗi ngày, lưu nhiều năm |
| Ngân sách độ trễ | Checkout chờ kết quả uỷ quyền | PSP p50 ~200 ms, p99 vài giây |
Throughput không lớn; phần khó là tính đúng khi hỏng một phần. Một lần timeout chẳng cho bạn biết ngân hàng đã trừ tiền thẻ hay chưa.
Tiến hoá thiết kế
Giai đoạn 1 / 2
Retry khi timeout
- Kiến trúc hiện tại
- Checkout gọi PSP với timeout 1 s và retry hai lần.
- Giới hạn
- Request đã timeout vẫn có thể thành công ở ngân hàng; lần retry là một lượt trừ tiền hoàn toàn mới.
- Điểm nghẽn
- Không phải năng lực — mà là tính đúng. Lượt uỷ quyền chậm nào cũng có thể thành trừ tiền kép.
- Cải tiến
- Làm request idempotent: cùng một khoản thanh toán phải ứng với cùng một lượt trừ tiền, gửi bao nhiêu lần cũng vậy.
- Tác động tới hiệu năng
- Nhanh, nhưng ~15% lượt thử chậm sinh ra lượt trừ tiền thứ hai (127 lần trong lần chạy này).
- Độ phức tạp & chi phí vận hành
- Hoàn tiền, chargeback, ticket hỗ trợ và mất lòng tin.
- Trade-off
- Retry chỉ tăng tỉ lệ thành công khi lặp lại là an toàn — ở đây thì không.
Đang tải mô phỏng…
State machine thanh toán và sổ cái
CREATE TABLE payments (
id uuid PRIMARY KEY,
idempotency_key text UNIQUE NOT NULL, -- key của client: lần retry tìm thấy đúng dòng cũ
amount_minor bigint NOT NULL, currency char(3) NOT NULL,
status text NOT NULL, -- CREATED → AUTHORISED → CAPTURED | FAILED | REFUNDED
psp_reference text,
updated_at timestamptz NOT NULL
);
-- Tiền không tự sinh ra hay mất đi: mỗi lần dịch chuyển là hai dòng có tổng bằng 0.
INSERT INTO ledger_entries (payment_id, account, amount_minor) VALUES
(:id, 'customer_receivable', -:amount),
(:id, 'merchant_payable', :amount);- Chuyển trạng thái có điều kiện:
UPDATE payments SET status = 'CAPTURED' WHERE id = ? AND status = 'AUTHORISED'— webhook tới sai thứ tự không thể kéo khoản thanh toán lùi lại. - Webhook từ PSP xác nhận kết quả cuối; xử lý chúng một cách idempotent và kiểm tra chữ ký.
- Outbox cho các hiệu ứng phụ (biên lai, giao hàng): ghi event trong cùng transaction với lần đổi trạng thái (transactional outbox).
- Đối soát: mỗi ngày, so sổ cái của bạn với file quyết toán của PSP; chênh lệch không giải thích được thì báo người trực.
Đánh đổi
| Được | Mất | |
|---|---|---|
| Uỷ quyền đồng bộ | Người mua biết kết quả ngay lúc checkout. | Độ trễ checkout phụ thuộc PSP; timeout để lại các trạng thái chưa rõ phải xử lý. |
| Sổ cái | Từng xu đều truy vết được và luôn cân bằng theo cấu trúc. | Ghi nhiều hơn và phải duy trì một mô hình dữ liệu chặt chẽ. |
| Xác nhận bất đồng bộ | Vẫn đúng kể cả khi lời gọi timeout hay client biến mất. | Trạng thái cuối tới muộn hơn; UI phải hiển thị 'đang xử lý'. |
Checklist khi phỏng vấn
- Nói sớm rằng tính đúng quan trọng hơn độ trễ, và timeout là mập mờ.
- Idempotency key từ đầu tới cuối: client → API của bạn → PSP.
- State machine + sổ cái ghi kép + webhook + đối soát.
- Nhắc tới bảo mật (phạm vi PCI, thẻ đã token hoá) và cách hoàn tiền, chi trả cho người bán khớp vào thiết kế.
Đọc thêm
Bài liên quan
Microservice Patterns
Idempotent Consumer
Xử lý một message hai lần phải cho kết quả như xử lý một lần — vì sớm hay muộn, broker nào cũng sẽ giao trùng message.
Microservice Patterns
Retry
Tự động gọi lại khi lỗi chỉ là chập chờn tạm thời — có backoff, jitter và giới hạn số lần, để retry giúp hệ thống vượt qua trục trặc thay vì làm sự cố nặng thêm.
Microservice Patterns
Transactional Outbox
Ghi thay đổi nghiệp vụ và event tương ứng trong cùng một transaction, rồi publish event từ bảng đó — không bao giờ mất event, cũng không publish event cho dữ liệu đã rollback.
Microservice Patterns
Saga
Giữ dữ liệu nhất quán giữa nhiều service mà không cần transaction phân tán: chạy lần lượt các local transaction, và khi một bước lỗi thì hoàn tác các bước trước đó.
Real Problems
Kho có 100 máy mà bán ra 400: race condition trong flash sale
Một đợt flash sale bán gấp ba lượng hàng có trong kho mà không hề báo lỗi. Code kiểm tra tồn kho rồi lưu tồn kho − 1 — và hàng trăm người mua làm việc đó cùng một lúc. Tái hiện lỗi, rồi sửa cho đúng.
Microservice Patterns
Asynchronous Request-Reply
Với việc mất vài giây hay vài phút, hãy trả lời HTTP request ngay bằng 202 Accepted kèm URL trạng thái, làm việc ở chế độ nền, và để client hỏi định kỳ hoặc được báo — thay vì giữ kết nối mở cho tới khi có thứ gì đó timeout.