Đến nội dung
BankGatewayBankGateway
Console ↗
↑ ↓ Điều hướng↵ ChọnEsc Đóng
Mục lục tài liệu:Bảng mã lỗi & HTTP Status ▾
Tài liệu›Xử lý lỗi & Vận hành›Bảng mã lỗi & HTTP Status
Phiên bản:v1.0.5 (Chính thức)

Bảng mã lỗi & HTTP Status

Danh mục chi tiết toàn bộ các mã phản hồi HTTP và error.code chuẩn OpenBanking.

Danh mục mã lỗi hoàn chỉnh

HTTP CodeMã lỗi (error.code)Ý nghĩa nghiệp vụCách xử lý
200SUCCESSTra cứu thành công, tìm thấy chủ tài khoảnSử dụng data.accountName và signature
400INVALID_BANK_CODEMã ngân hàng không đúng hoặc không hỗ trợKiểm tra bảng mã bankCode trong danh mục
400INVALID_ACCOUNT_NUMBERSố tài khoản rỗng hoặc không đúng quy cáchKiểm tra định dạng chuỗi số tài khoản
401UNAUTHORIZED_API_KEYKhóa API không hợp lệ hoặc đã bị khóaKiểm tra header X-API-Key trên Dashboard
402PAYMENT_REQUIREDSố dư ví hoặc số lượt trong gói đã cạn kiệtNạp tiền vào ví hoặc gia hạn gói lượt
403IP_NOT_ALLOWEDĐịa chỉ IP của máy chủ không có trong WhitelistThêm IP máy chủ vào Dashboard > API Keys
403QUOTA_EXHAUSTEDHạn mức của riêng API Key này đã hếtTăng hạn mức cho khóa trong trang quản trị
404NOT_FOUNDSố tài khoản không tồn tại tại ngân hàng đíchThông báo cho khách hàng kiểm tra lại STK
409IDEMPOTENCY_PAYLOAD_MISMATCHDùng lại Idempotency-Key nhưng đổi dữ liệuSinh Idempotency-Key mới cho giao dịch mới
429RATE_LIMIT_EXCEEDEDGọi vượt quá số lượt cho phép trong 1 giâyHạ nhịp gọi hoặc chờ theo header Retry-After
503ENDPOINT_MAINTENANCECổng API đang tạm ngưng bảo trì theo lịchTạm hoãn và gọi lại sau thời gian autoReopenAt
502UPSTREAM_FAILURECổng Napas / Ngân hàng đích tạm thời gián đoạnThử lại sau 3-5 giây (Miễn phí 100%)
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 ↗