Đến nội dung
BankGatewayBankGateway
Console ↗
↑ ↓ Điều hướng↵ ChọnEsc Đóng
Mục lục tài liệu:Chống trùng lặp (Idempotency) ▾
Tài liệu›Xác thực & Bảo mật›Chống trùng lặp (Idempotency)
Phiên bản:v1.0.5 (Chính thức)

Chống trùng lặp (Idempotency)

Cơ chế bảo vệ giao dịch không bị trừ tiền hai lần khi mạng gián đoạn hoặc timeout.

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.

HTTP Header
Idempotency-Key: 7b3a4e92-31fa-4f2a-b732-479e0a29c118

Quy tắc hoạt động chuẩn RFC

Tình huống gửi lạiCách hệ thống xử lý
Cùng Key + Cùng BodyTrả 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 BodyTrả 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ả
Tài liệu phát hành theo chuẩn OpenBanking 2.0 · Cập nhật v1.0.5 (Chính thức)Góp ý tài liệu & Báo lỗi ↗