# Xử lý BOOKING JOURNEY

### 1. API commit

* Khi gọi API Commit, sẽ được tính là bắt đầu một luồng đặt chỗ. Cần đảm bảo rằng hành trình đặt chỗ đã thực sự kết thúc trước khi tạo một luồng đặt chỗ mới.
* API Commit chỉ có nhiệm vụ kích hoạt hai hành động: thanh toán và xuất vé. Không thể chỉ sử dụng API Commit để xác định kết thúc một hành trình đặt chỗ mà còn phải kết hợp với API booking-detail [Booking API](/vietnamese/doi-tac-b2b2c/phuong-thuc-api/flight/booking-api.md#id-3api-lay-chi-tiet-thong-tin-booking) (mình sẽ chuyển sang sử dụng API final-booking-detail [/pages/9mDZFrbWTlSK6y2kstDH#id-5.-api-lay-chi-tiet-booking-sau-khi-xuat-ve](https://developer.gotadi.com/vietnamese/doi-tac-b2b2c/phuong-thuc-api/pages/9mDZFrbWTlSK6y2kstDH#id-5.-api-lay-chi-tiet-booking-sau-khi-xuat-ve "mention") theo khuyến cáo bên dưới trong document này).

### 2. API final booking detail

* API final-detail-booking được sử dụng để xác định trạng thái của một
  \
  booking thông qua các status sau:
  * Payment statuses
  * Issued statuses
* API final-detail-booking này bổ sung thêm tính năng xử lý giữa các trường hợp thành công và thất bại. Cụ thể, trong trường hợp thành công (happy case), API sẽ ngay lập tức trả về kết quả. Trong trường hợp thất bại (failure case), API sẽ tự động thử lại để lấy trạng thái mới nhất của booking và trả về kết quả đến khi hết thời gian đặt sẵn.
* Các trường hợp được coi là hành trình booking đã kết thúc và có thể
  \
  bắt đầu một hành trình mới:
  * Thanh toán thất bại: **paymentStatus** = <mark style="color:red;">**failed**</mark>
  * Thanh toán thành công và xuất vé thành công: **paymentStatus** = <mark style="color:green;">**Success**</mark> và **issueStatus** = <mark style="color:green;">**Success**</mark>
* Các cases được consider là booking journey chưa kết thúc, cần hold và xử lý tiếp.
  * Thanh toán thành công: **paymentStatus** = <mark style="color:green;">**Success**</mark> and **issueStatus&#x20;**<mark style="color:red;">**!=**</mark> <mark style="color:green;">**Success**</mark>

### 3. Khuyến cáo

* Khi gọi API Commit, có thể gặp một số thông báo lỗi ngoài bảng mã lỗi (ví dụ: lỗi không gọi được API, lỗi timeout, thời gian phản hồi quá lâu...). Người dùng cần sử dụng API final-booking-detail để xác định trạng thái của một booking.
* Sau khi get-final-booking-detail nếu: **paymentStatus =&#x20;**<mark style="color:green;">**success**</mark> mà **issueStatus&#x20;**<mark style="color:red;">**!=**</mark> <mark style="color:green;">**success**</mark> vẫn nên retry `GET` **final-booking-detail** để lấy được status đúng nhất.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.gotadi.com/vietnamese/doi-tac-b2b2c/phuong-thuc-api/xu-ly-booking-journey.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.