> 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-price-check.md).

# API Price Check

Endpoint: `price-check`

Chốt giá một `offerId`, nhận `bookingToken`.

**Request**

| Field     | Kiểu   | Bắt buộc |
| --------- | ------ | -------- |
| `offerId` | string | ✔        |

```json
{ "offerId": "of_8Jk2..." }
```

**Response (`00`)**

| Field              | Kiểu      | Mô tả                             |
| ------------------ | --------- | --------------------------------- |
| `bookingToken`     | string    | Chuỗi mờ, **hết hạn sau 15 phút** |
| `price`            | `Money`   | Giá đã chốt                       |
| `cancelPolicies[]` | array     | Bản **chốt cuối** cho booking     |
| `expiresAt`        | date-time |                                   |

```json
{
  "bookingToken": "bt_Qw9x...",
  "price": { "total": 2400000, "perNight": 1200000, "currency": "VND", "taxIncluded": true },
  "cancelPolicies": [{ "from": "2026-11-18T12:00:00+07:00", "penaltyAmount": 1200000 }],
  "expiresAt": "2026-11-15T15:15:00+07:00"
}
```

{% hint style="warning" %}
**Giá đổi: mã `20 PRICE_CHANGED`** — `payload` có cùng dạng `PriceCheckResponse`, với `price` mới và `bookingToken` mới. Hỏi lại khách; khách đồng ý thì dùng token mới. **Hết phòng: mã `21 SOLD_OUT`.**
{% endhint %}
