> For the complete documentation index, see [llms.txt](https://developer.gotadi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.gotadi.com/vietnamese/doi-tac-b2b2c/phuong-thuc-api/hotel/ma-loi.md).

# Mã Lỗi

Mã `00`–`10` và `99` giữ nguyên như kết nối B2B2C hiện tại; mã từ `20` dành cho Partner API.

| Mã   | Tên                      | Khi nào                                                                                  | Đối tác làm gì                                              |
| ---- | ------------------------ | ---------------------------------------------------------------------------------------- | ----------------------------------------------------------- |
| `00` | SUCCEEDED                | Thành công                                                                               | —                                                           |
| `01` | ON\_PROCESS              | Booking đang xử lý, hoặc request cùng `requestId` / `commit` khác cùng booking đang chạy | Đợi vài giây, tra lại bằng `bookings/get`                   |
| `02` | FAILED                   | Xử lý thất bại                                                                           | Báo khách, không tự gửi lại                                 |
| `03` | UNAUTHORIZED             | Đối tác chưa được bật Partner API                                                        | Liên hệ Gotadi                                              |
| `04` | INVALID\_SIGNATURE       | Chữ ký sai                                                                               | Kiểm chuỗi ký và private key                                |
| `06` | INVALID\_ACCESS\_CODE    | `accessCode` không khớp `apikey`                                                         | Kiểm cấu hình                                               |
| `07` | INVALID\_DATA\_FORMAT    | Envelope hoặc payload sai định dạng, thiếu field                                         | Sửa request theo `message`                                  |
| `08` | NOT\_BE\_REPROCESSED     | Booking đã thanh toán, đã huỷ, hoặc chưa xác nhận khi huỷ                                | Tra `bookings/get`                                          |
| `09` | PENDING                  | Đã nhận tiền, khách sạn chưa xác nhận                                                    | **Không hoàn tiền**, tra lại mỗi 1 phút                     |
| `10` | BOOKING\_DUPLICATED      | Trùng một booking đã thanh toán                                                          | Kiểm đơn trùng                                              |
| `20` | PRICE\_CHANGED           | Giá đổi ở `price-check`                                                                  | Hỏi khách, dùng `bookingToken` mới                          |
| `21` | SOLD\_OUT                | Hết phòng                                                                                | Chọn gói khác                                               |
| `22` | TOKEN\_EXPIRED           | `offerId` hoặc `bookingToken` hết hạn                                                    | Gọi lại `offers` / `price-check`                            |
| `23` | BOOKING\_NOT\_FOUND      | Không có booking của đối tác                                                             | Kiểm mã                                                     |
| `24` | PAYMENT\_EXPIRED         | `commit` sau `paymentDeadline`                                                           | Không thu tiền; đặt lại                                     |
| `25` | SUPPLIER\_ERROR          | Khách sạn hoặc nguồn phòng lỗi                                                           | Thử lại sau hoặc chọn gói khác                              |
| `26` | REQUEST\_EXPIRED         | `timestamp` lệch quá 300 giây                                                            | Đồng bộ giờ server (NTP)                                    |
| `27` | DUPLICATED\_REQUEST\_ID  | `requestId` đã dùng với payload khác                                                     | Sinh `requestId` mới                                        |
| `28` | CANCEL\_PENALTY\_CHANGED | Phí huỷ đã đổi                                                                           | Gọi lại `cancel-check`                                      |
| `29` | PROPERTY\_NOT\_FOUND     | Không có khách sạn (`content/property`)                                                  | Kiểm `masterId`, đồng bộ lại danh mục                       |
| `99` | UNKNOWN\_ERROR           | Lỗi hệ thống                                                                             | Thử lại; với `create`/`commit` thì tra `bookings/get` trước |
