Các loại lỗi của Partner API

Partner API trả về lỗi ở định dạng application/problem+json (RFC 9457). Trường type chứa địa chỉ của một trong các trang dưới đây và là mã định danh ổn định của loại lỗi. Hãy xử lý type (hoặc trạng thái HTTP) trong mã của bạn, không dựa vào nội dung title hoặc detail vì chúng có thể thay đổi.

Loại lỗi	Trạng thái	Ý nghĩa
Yêu cầu không hợp lệ	400	Yêu cầu không thể đọc được vì body không phải JSON hợp lệ hoặc đã gửi sai Content-Type.
Chưa được xác thực	401	API key bị thiếu, không hợp lệ hoặc đã bị thu hồi.
Truy cập bị từ chối	403	API key hợp lệ nhưng merchant không có gói đăng ký API đang hoạt động.
Không tìm thấy	404	Đơn hàng được yêu cầu không tồn tại hoặc thuộc về một merchant khác.
Đơn hàng đã tồn tại	409	Đã tồn tại một đơn hàng với external_order_id này (hoặc Idempotency-Key này), nhưng body được gửi khác với body ban đầu.
Đơn hàng không thể hủy	409	Đơn hàng không thể hủy qua API nữa vì đã được merchant chấp nhận.
Lỗi xác thực dữ liệu	422	Yêu cầu là JSON hợp lệ nhưng nội dung không được chấp nhận.
Quá nhiều yêu cầu	429	API key của bạn đã vượt quá giới hạn tần suất (trong thời gian beta là 60 yêu cầu mỗi phút).
Lỗi nội bộ	500	Đã xảy ra sự cố tạm thời từ phía chúng tôi.