Happy path chỉ là demo
Trong vận hành thanh toán, lỗi mạng và retry mới là sản phẩm. Nếu UI 'đã chuyển' đủ để cập nhật đơn, bạn sẽ gặp double fulfill hoặc mất bằng chứng.
Thứ tự an toàn
- Tạo intent với mã tham chiếu rõ.
- Adapter chuẩn hóa bằng chứng provider.
- Matching theo số tiền, tham chiếu, cửa sổ thời gian.
- Commit state một lần (idempotent).
- Gửi webhook ký; retry có audit.
Ranh giới ngôn ngữ
Copy công khai nói confirmation và reconciliation. Không nói giữ, chuyển hay xử lý tiền thay tổ chức được cấp phép. Đây là research/prototype, không phải sản phẩm payment live.
Đừng tin nút xanh. Tin bằng chứng và khóa chống trùng.