Webhook thanh toán gọi hai lần: vì sao khách bị trừ tiền mà tài khoản vẫn khoá, và 4 chỗ phải sửa

Chuyện này tôi gặp ba lần trong hai tháng, ở ba dự án khác nhau: khách bấm mua, ngân hàng trừ tiền, ảnh chụp màn hình gửi lên nhóm hỗ trợ, và tài khoản vẫn báo chưa thanh toán. Lần nào cũng có người nói chắc do mạng.

Hiếm khi do mạng. Phần lớn là webhook chạy hai lần, hoặc chạy trước khi trang kịp quay về, và trong code không có chỗ nào chịu được việc bị gọi lại.

Khi khách bấm “Thanh toán”, có hai con đường cùng lúc

Một là cổng thanh toán gọi webhook về server. Hai là trình duyệt quay lại trang success. Không ai bảo đảm cái nào tới trước, và cũng không ai bảo đảm chỉ tới một lần.

Với thẻ, webhook thường tới sau 1 đến 3 giây. Với chuyển khoản, có thể sau 30 giây, có khi hôm sau. Với ví điện tử, gần như tức thì, đôi khi hai lần liên tiếp.

Nếu cả hai đường cùng ghi “đã thanh toán” và mỗi đường tự bật quyền truy cập, thì việc cái sau ghi đè cái trước chỉ còn là vấn đề thời gian.

Bốn chỗ phải sửa, theo thứ tự

1. Mọi webhook phải idempotent. Mỗi gói tin có một id riêng. Ghi id đó vào bảng webhook_events với ràng buộc UNIQUE trước khi làm bất cứ việc gì. Nếu insert lỗi vì trùng khoá thì trả 200 và thoát. Nghe đơn giản, nhưng đây là chỗ chặn phần lớn lỗi trừ tiền hai lần.

2. Trạng thái đơn hàng phải có luật. Đừng dùng một cột paid = true/false. Dùng chuỗi trạng thái: created → pending → paid → fulfilled → refunded. Mỗi bước chỉ tiến, không lùi, và không nhảy cóc. Một webhook đến muộn không được phép kéo đơn đã fulfilled về pending.

3. Trang success không được cấp quyền. Nó chỉ hiển thị “đang kiểm tra thanh toán” và hỏi lại server mỗi 3 giây trong 30 giây đầu. Quyền chỉ được cấp từ webhook đã xác thực chữ ký, hoặc từ job đối soát. Nếu trang success cấp quyền, khách quay lại bằng nút Back là đủ để có quyền mà không trả tiền.

4. Job đối soát chạy mỗi 10 phút. Lấy danh sách giao dịch của cổng thanh toán trong 24 giờ gần nhất, so với bảng đơn hàng của mình. Cái nào cổng báo thành công mà mình còn pending thì chữa lại và ghi log. Đây là lưới an toàn cuối cùng: webhook mất thì job vẫn cứu được, và không cần khách phải nhắn hỗ trợ.

Kiểm tra 20 phút trước khi mở bán

Bật chế độ test của cổng thanh toán, rồi làm đúng bốn việc: thanh toán một lần và bấm Back giữa lúc chuyển trang; thanh toán rồi tải lại trang success ba lần; gửi lại cùng một webhook hai lần bằng công cụ của cổng; và đổi trạng thái một đơn trong database từ paid về pending để xem hệ thống có tự sửa không. Bốn bước này lộ ra gần hết những lỗi từng làm khách mất tiền.

Khi nào nên nhờ người ngoài làm phần này

Nếu bạn đang làm app bằng AI (Cursor, Lovable, Bolt, v0) và đã dừng ở đúng chỗ này, phần còn thiếu thường không phải giao diện mà là đúng bốn điểm trên. Tôi làm studio một người ở Seoul, nhận đúng phần này: webhook, phân quyền, trạng thái đơn, job đối soát, và đưa lên môi trường thật. Thời gian thường 3 đến 5 ngày với phạm vi đã chốt, giá cố định báo trước khi bắt đầu, và chỉ thanh toán phần còn lại sau khi bạn thấy nó chạy.

Có câu hỏi cứ để lại dưới topic này, tôi trả lời bằng tiếng Việt. Còn nếu muốn tôi xem code cụ thể thì gửi mô tả ngắn qua email: [email protected].

83% thành viên diễn đàn không hỏi bài tập, còn bạn thì sao?