> 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/api/api-booking-commit.md).

# API Booking Commit

Endpoint: `bookings/commit`

Báo đã thu tiền; Gotadi trừ số dư agency và xác nhận với khách sạn.

**Request**

| Field            | Kiểu   | Bắt buộc | Mô tả                                               |
| ---------------- | ------ | -------- | --------------------------------------------------- |
| `bookingNumber`  | string | ✔        |                                                     |
| `partnerTransId` | string | ✔        | Mã giao dịch thu tiền của đối tác, dùng để đối soát |
| `amount`         | int    | ✔        | \*\*Phải bằng `totalAmount`\*\*                     |

```json
{ "bookingNumber": "HTL2611150001", "partnerTransId": "PAY-778899", "amount": 2400000 }
```

**Response**

| Field                   | Kiểu   | Mô tả                                   |
| ----------------------- | ------ | --------------------------------------- |
| `bookingNumber`         | string |                                         |
| `status`                | enum   | `CONFIRMED` \| `PENDING` \| `FAILED`    |
| `hotelConfirmationCode` | string | Mã xác nhận của khách sạn; có thể thiếu |

```json
{ "bookingNumber": "HTL2611150001", "status": "CONFIRMED", "hotelConfirmationCode": "DN-55821" }
```

* `status: PENDING` (mã `09`) — khách sạn chưa xác nhận hoặc chưa rõ kết quả. **Không hoàn tiền cho khách**, tra lại bằng `bookings/get` mỗi 1 phút cho đến khi `CONFIRMED` hoặc `FAILED`.
* `CONFIRMED` có thể thiếu `hotelConfirmationCode` khi Gotadi chưa đọc lại được booking; lấy mã bằng `bookings/get` sau.
* `FAILED` — booking không thành công; tiền khách đã trả xử lý theo thoả thuận đối soát giữa hai bên.

{% hint style="warning" %}
Một booking chỉ có **một lệnh `commit`** chạy tại một thời điểm, khoá tối đa **120 giây**; lệnh chồng lên nhận mã `01` và **không bị trừ tiền lần hai**. `commit` một booking không còn `PENDING_PAYMENT` trả `08`; quá `paymentDeadline` trả `24`.
{% endhint %}
