Mã lỗi

Bảng tham chiếu mã lỗi cho SmartOTP. Bao gồm mọi mã do API trả về. Mã do Mobile SDK phát sinh nằm ngoài phạm vi trang này.

Cách đọc một lỗi

WARNING

SmartOTP dùng code: 1 cho thành công, khác với eKYC, eID và FaceAuthen vốn dùng code: 0. Dùng chung một response handler cho cả bốn dịch vụ sẽ khiến mọi kết quả SmartOTP bị đọc sai.

json

{
  "success": true,
  "code": 1,
  "message": "Success"
}

Thông báo lỗi được trả về bằng tiếng Việt. Chúng được sao chép nguyên văn bên dưới, kèm gloss tiếng Anh.

Bảng mã lỗi

Mã	Thông báo	Ý nghĩa
`1`	Success (OTP hợp lệ)	Thành công
`3`	Parameter invalid	Tham số không hợp lệ
`103`	Thông tin Partner không chính xác.	`partner_id` hoặc `partner_key` sai
`121`	Yêu cầu vượt giới hạn. Vui lòng thử lại sau ít phút.	Vượt giới hạn tần suất
`123`	Yêu cầu vượt giới hạn. Vui lòng thử lại sau ít phút.	Vượt giới hạn tần suất
`124`	OTP không hợp lệ.	Mã OTP sai
`125`	OTP hết hạn sử dụng.	OTP đã hết hạn
`126`	Có lỗi xảy ra vui lòng thử lại.	Lỗi không xác định
`129`	Token không hợp lệ.	Token thiết bị sai hoặc đã hết hạn
`190001`	Thông tin không hợp lệ, device_id đã kích hoạt Soft-OTP	Thiết bị đã được kích hoạt
`190005`	SmartOTP đang kích hoạt trên một thiết bị khác.	Hãy hủy kích hoạt thiết bị cũ trước
`190108`	Tài khoản chưa hoạt động.	SmartOTP chưa được kích hoạt
`190201`	Không thể tạo transaction hoặc transaction_id đã tồn tại	`transaction_id` bị trùng
`190203`	Không tìm thấy transaction.	`transaction_id` sai
`190301`	Period không chính xác.	Tham số `period` sai
`190303`	Client time không chính xác.	Đồng hồ thiết bị bị lệch

Mã lỗi theo endpoint

Endpoint	Các mã có thể gặp
Đăng ký	`3` `103` `121` `126` `190001`
Kích hoạt	`3` `103` `121` `123` `124` `125` `126` `129`
Lấy trạng thái	`103` `190005`
Hủy kích hoạt	`3` `103` `126` `129`
Tạo giao dịch	`3` `103` `126` `129` `190108` `190201`
Lấy giao dịch	`3` `103` `126` `129` `190108` `190203`
Lấy giao dịch mới nhất	`3` `103` `129` `190108` `190203`
Đồng bộ thời gian	`103` `129` `190108` `190301` `190303`
Xác minh OTP	`103` `121` `123` `124` `126` `129` `190108` `190203`

Các lỗi thường gặp

Tình huống	Mã	Cần làm gì
Người dùng nhập đúng OTP nhưng bị từ chối	`124`	Thường là do lệch đồng hồ — gọi Đồng bộ thời gian
Không thể kích hoạt thiết bị mới	`190005`	Gọi Hủy kích hoạt trên thiết bị cũ trước
Tạo giao dịch thất bại	`190201`	Tạo một `transaction_id` mới; không thử lại cùng giá trị cũ
Activation key đã hết hạn	`125`	Gọi lại Đăng ký để lấy key mới

Bước tiếp theo

Xác minh OTP — nơi phát sinh phần lớn lỗi
Đồng bộ thời gian — khắc phục lệch đồng hồ gây ra lỗi OTP

Mã lỗi ​

Cách đọc một lỗi ​

Bảng mã lỗi ​

Mã lỗi theo endpoint ​