7. Hold booking

API gửi yêu cầu đặt vé.

Parameters

Field name	Type	Required	Description
is_round_trip	boolean	yes	Tuỳ chọn mua vé khứ hồi - True: 2 chiều - False: 1 chiều
orders	array		Thông tin đơn hàng
orders[0].booker_info	object	yes	Thông tin người đặt vé - orders[0] Chiều đi - orders[1] Chiều về
orders[0].booker_info.address	string	no	Địa chỉ
orders[0].booker_info.booker	string	yes	Họ và tên
orders[0].booker_info.email	string	yes	Email
orders[0].booker_info.phone	string	yes	Điện thoại
orders[0].schedule_id	string	yes	Mã lịch trình
orders[0].ticket_infos	array	yes	Thông tin hành khách
orders[0].ticket_infos[0].full_nm	string	yes	Họ và tên
orders[0].ticket_infos[0].gender	string	yes	Giới tính
orders[0].ticket_infos[0].email	string	no	Email
orders[0].ticket_infos[0].phone	string	no	Điện thoại
orders[0].ticket_infos[0].yob	string	yes	Ngày sinh
orders[0].ticket_infos[0].nation_id	string	yes	Mã Quốc gia, lấy từ API get nations
orders[0].ticket_infos[0].ticket_price_id	string	yes	Mã giá vé, lấy từ API get seats
orders[0].ticket_infos[0].seat_id	string	yes	Mã chỗ ngồi, lấy từ API get seats
request_id	string	yes	Mã tham chiếu để tạo yêu cầu giữ chỗ được tạo từ phía đối tác
signature	string	yes	`client_Id`+`request_Id` key = `securekey`

Signature Example

https://tools.onecompiler.com/hmac-sha512

client_Id : rci_e51db537-5dcf-4055-b138-21fbeb4610f9
request_Id : request_id_20250219
securekey rsk_7fd14b85-d703-4d2b-a9fa-21926e7817ef

signature : 6a1496b16fc266f433f1af7b71e52e26b2455c3388664df6ce12eb5007f0fd0878baef608dc1c168cb8f4d09e730130f501afc74efd9daee808663971b3a12f3

Response Description

Field name	Type	Description
booking_id	string	Mã đặt chỗ
request_id	string	Mã tham chiếu để tạo yêu cầu giữ chỗ được tạo từ phía đối tác
status	string	Trạng thái của đặt chỗ: request, holding, canceled, paid, failed
fee_amount	number	Tổng cộng các loại phí
ticket_amount	number	Tổng cộng giá vé
total_amount	number	Tổng cộng số tiền phải thanh toán

Lưu ý:

Sau khi gửi yêu cầu đặt vé thành công, Trạng thái đơn hàng sẽ là holding

API này sẽ tiến hành giữ chỗ để khách hàng thực hiện thanh toán trong vòng 15 phút (theo quy định của nhà cung cấp)

Sau 15 phút, nếu đơn hàng:

chưa được thanh toán, Trạng thái đơn hàng sẽ là canceled

thanh toán thành công, Trạng thái đơn hàng sẽ là paid

Request

Authorization

Send your HTTP requests with an

Authorization

header that contains the word Basic followed by a space and a base64-encoded string username:password

Example:

Authorization: Basic *****************

Body Params application/json

Example

{
    "is_round_trip": false,
    "orders": [
        {
            "booker_info": {
                "address": "Hồ Chí Minh",
                "booker": "Nguyen Thi Test", //Tên người đặt vé
                "buyer": "Nguyễn Văn Book", // Tên người đặt vé trên hoá đơn VAT 
                "company_addr": "Hồ Chí Minh", // Địa chỉ công ty trên hoá đơn VAT
                "company_nm": "Công ty Việt Nam", // Tên công ty trên hoá đơn VAT
                "email": "bpoker@gmail.com", //email người đặt vé
                "phone": "0973123456", // số điện thoại người đặt vé
                "taxcode": "3212442210" //Mã số thuế
            },
            "schedule_id": "67aaf75d072c910c5069e3b2",
            "ticket_infos": [
                {
                    "email": "guest1@gmail.com",
                    "full_nm": "Nguyễn Văn Guest 1",
                    "gender": "male",
                    "id_no": "079012345680",
                    "nation_id": "67aaf6c86d975d8237cc8aab",
                    "phone": "0973123456",
                    "pob": "Hồ Chí Minh",
                    "seat_id": "67b2be31bf0a57532e0678c2",
                    "ticket_price_id": "67aaf75d072c910c5069e3b3", 
                    "yob": "1950-01-02"
                },
                {
                    "email": "guest2@gmail.com",
                    "full_nm": "Nguyễn Văn Guest 2",
                    "gender": "male",
                    "id_no": "079112345680",
                    "nation_id": "67aaf6c86d975d8237cc8aab",
                    "phone": "0973123456",
                    "pob": "Hồ Chí Minh",
                    "seat_id": "67b2be31bf0a57532e0678c0",
                    "ticket_price_id": "67aaf75d072c910c5069e3b5",
                    "yob": "1950-01-02"
                }
            ]
        }
    ],
    "request_id": "request_id_20250220", //Mã request tự quy định
    "signature": "e7580c8f8002f133c15cbe5ed71503a475024ac1546362c914cfa4b8f289aceb02d477767e0de2e9337b71a07718fd6c03877bef60d460f95f3399135eb9bca9"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://stg-api-hub.suntraveltech.com/waterbuses/bookings/hold' \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "is_round_trip": false,
    "orders": [
        {
            "booker_info": {
                "address": "Hồ Chí Minh",
                "booker": "Nguyen Thi Test", //Tên người đặt vé
                "buyer": "Nguyễn Văn Book", // Tên người đặt vé trên hoá đơn VAT 
                "company_addr": "Hồ Chí Minh", // Địa chỉ công ty trên hoá đơn VAT
                "company_nm": "Công ty Việt Nam", // Tên công ty trên hoá đơn VAT
                "email": "bpoker@gmail.com", //email người đặt vé
                "phone": "0973123456", // số điện thoại người đặt vé
                "taxcode": "3212442210" //Mã số thuế
            },
            "schedule_id": "67aaf75d072c910c5069e3b2",
            "ticket_infos": [
                {
                    "email": "guest1@gmail.com",
                    "full_nm": "Nguyễn Văn Guest 1",
                    "gender": "male",
                    "id_no": "079012345680",
                    "nation_id": "67aaf6c86d975d8237cc8aab",
                    "phone": "0973123456",
                    "pob": "Hồ Chí Minh",
                    "seat_id": "67b2be31bf0a57532e0678c2",
                    "ticket_price_id": "67aaf75d072c910c5069e3b3", 
                    "yob": "1950-01-02"
                },
                {
                    "email": "guest2@gmail.com",
                    "full_nm": "Nguyễn Văn Guest 2",
                    "gender": "male",
                    "id_no": "079112345680",
                    "nation_id": "67aaf6c86d975d8237cc8aab",
                    "phone": "0973123456",
                    "pob": "Hồ Chí Minh",
                    "seat_id": "67b2be31bf0a57532e0678c0",
                    "ticket_price_id": "67aaf75d072c910c5069e3b5",
                    "yob": "1950-01-02"
                }
            ]
        }
    ],
    "request_id": "request_id_20250220", //Mã request tự quy định
    "signature": "e7580c8f8002f133c15cbe5ed71503a475024ac1546362c914cfa4b8f289aceb02d477767e0de2e9337b71a07718fd6c03877bef60d460f95f3399135eb9bca9"
}'

application/json

Body

Example

{
    "booking_id": "67b2c564bf0a57532e067a81",
    "request_id": "request_id_20250219",
    "status": "holding",
    "fee_amount": 36000,
    "ticket_amount": 900000,
    "total_amount": 936000
}

7. Hold booking

Parameters#

Signature Example#

Response Description#

Request

Request Code Samples

Responses

Parameters

Signature Example

Response Description