Mã lỗi

Cập nhật lần cuối: 24/4/2025

Bảng mô tả mã lỗi trả về từ API của Checkout SDK

Error code	Description	Recommended actions
0	Thành công
-2001	Không có quyền truy cập	Kiểm tra trường msg được trả về để biết lý do bị lỗi. Lỗi này xảy ra khi: Người dùng gọi checkTransaction một Order do người khác tạo. Đối tác gọi updateOrderStatus nhưng phương thức thanh toán của Endpoint và Order khác nhau.
-2002	Session không hợp lệ	Kiểm tra Access Token đã hợp lệ hay chưa.
-2003	Gửi quá nhiều Request	Kiểm tra trường msg được trả về để biết giới hạn số lượng Request.
-2101	Giá trị MAC không đúng	Kiểm tra xem giá trị MAC được tạo có trùng với giá trị MAC Debug không. Lỗi này cũng có thể xảy ra khi: PrivateKey đang sử dụng không phải của Mini App đang gọi tới.
-2102	Request body không hợp lệ	Kiểm tra trường msg được trả về để biết thêm thông tin về lỗi. Lỗi này xảy ra khi: Nội dung Request có cú pháp không phải JSON.
-2103	Tham số không hợp lệ	Kiểm tra trường msg được trả về để biết chi tiết tham số bị lỗi. Lỗi này xảy ra khi: Đối tác truyền thiếu trường dữ liệu. Đối tác truyền sai trường dữ liệu.
-2104	Mã phương thức thanh toán Platform không hợp lệ	Kiểm tra mã phương thức thanh toán đã đúng với mã phương thức thanh toán của Platform hay chưa.
-2105	Result code không hợp lệ	Kiểm tra xem giá trị resultCode có phải các giá trị sau không: -1: Thất bại 1: Thành công 2: Đã hoàn tiền
-2201	Phương thức thanh toán không hợp lệ	Kiểm tra trường msg được trả về để biết lý do bị lỗi. Lỗi này xảy ra khi: Đối tác chưa cấu hình phương thức thanh toán.
-2203	Order không hợp lệ	Kiểm tra giá trị orderId truyền lên đã chính xác hay chưa.
-2204	Refund không hợp lệ	Kiểm tra giá trị refundId truyền lên đã chính xác hay chưa.
-2205	Transaction không hợp lệ	Kiểm tra giá trị transId truyền lên đã chính xác hay chưa.
-2301	Phương thức thanh toán chưa được kích hoạt	Kiểm tra phương thức thanh toán đã được kích hoạt hay chưa.
-5000	Lỗi không xác định	Vui lòng liên hệ Zalo Mini App để biết thêm chi tiết.