Tại sao cần Idempotency-Key?
Trong thanh toán trực tuyến, khi ứng dụng gửi request và bị mất mạng hoặc timeout, ứng dụng không thể biết giao dịch đã được hệ thống xử lý hay chưa. Bằng cách gửi header Idempotency-Key (UUID duy nhất), BankGateway sẽ tự động nhận diện và trả về kết quả đã xử lý trước đó mà KHÔNG trừ tiền lần thứ hai.
Idempotency-Key: 7b3a4e92-31fa-4f2a-b732-479e0a29c118Quy tắc hoạt động chuẩn RFC
| Tình huống gửi lại | Cách hệ thống xử lý |
|---|---|
| Cùng Key + Cùng Body | Trả lại kết quả đã xử lý tức thì (0ms); không trừ tiền thêm |
| Cùng Key nhưng Khác Body | Trả về HTTP 409 Conflict (IDEMPOTENCY_PAYLOAD_MISMATCH) |
| Đang xử lý (In-flight) | Chờ tác vụ đầu tiên hoàn thành và trả chung kết quả |