Get list of ancillary services for a booking.
# 1. Tổng quan
- Action URL:
/api/v1/vj/flight/ancillary - Đặc tả chi tiết: Swagger UI (opens new window)
- Chức năng:
API cho phép lấy danh sách dịch vụ bổ sung (ancillary services) cho một booking của Vietjet Air.
GửibookingKeyđể nhận về danh sách dịch vụ tương ứng. - Điều kiện sử dụng:
Chỉ áp dụng cho tài khoản có quyền truy cập hợp lệ.
# 2. Hướng dẫn sử dụng
# Các bước thực hiện
- Xây dựng request với đầy đủ header và body.
- Gửi request
POSTtới Action URL. - Nhận response chứa danh sách các dịch vụ bổ sung cho booking.
# 3. Request
# 3.1 Ví dụ
{
"bookingKey": "nlBxOkrƒeWPjoL8DOWVTrVyfSBx2UQƒV6JNyRUAx¥NmI1lWEqjFb9gmPƒUB2kbaIrZN2PjDmH40JSxq¥BJKc5ki6quEm8ƒ
...",
"languageCode": "en"
}
# 3.2 Cấu trúc dữ liệu Request
| Thuộc tính | Bắt buộc | Kiểu dữ liệu | Mô tả | Ví dụ |
|---|---|---|---|---|
bookingKey | Có | String | Khóa định danh của đặt chỗ (Booking Key) do hệ thống trả về sau khi tìm kiếm hoặc giữ chỗ. Dùng để xác định chuyến bay cụ thể cần truy vấn thông tin dịch vụ bổ sung. | "nlBxOkrƒeWPjoL8D..." |
languageCode | Không | String | Mã ngôn ngữ hiển thị kết quả. | "en" |
# 4.Response
# 4.1 Ví dụ
{
"statusCode": 200,
"timestamp": "2025-10-27T08:23:12.853Z",
"path": "/api/v1/vj/flight/ancillary",
"message": "Lấy danh sách dịch vụ bổ sung thành công",
"data": [
{
"key": "ZDBfƒS6Biqƒhc0nRtaDj2Uv6fLef¥vb406CSvfaELvFiaEi6zW6Zh9xQqp0HKBli24BWPIhScuffCbHyqJ00 ...",
"purchaseKey": "yq2CZ1dVlybyxQETDp1D5X94m3Iu0¥ƒIdNy3tSRzghowhclg8k4¥qXƒDIMzOuwhNtdjieil ...",
"ancillaryItem": {
"key": "eU9Fu4zikmtsn4VBXmWLNEm¥sXwPmL8¥U4GxoB6j8oM=",
"name": "Bag 20kgs",
"description": "Baggage 20kgs",
"index": 33,
"ancillaryCategory": {
"key": "JwSyxxbv9z51Gcƒw6TjYlMCd2GzEmb2nD4TluvSs¥uk=",
"name": "Baggage",
"description": "Choose the appropriate luggage package",
"index": 1,
"purchaseConditions": {
"allowMultipleItems": false
},
"requestedTranslation": null
},
"ancillaryOptionType": {
"airportOption": false,
"cityPairOption": true,
"flightOption": false,
"reservationOption": false
},
"purchaseConditions": {
"maximumPerPassengerCount": 1
},
"requestedTranslation": null,
"refundable": true,
"removable": true
},
"requirementLocation": {
"date": "2025-11-09",
"airport": null,
"cityPair": {
"identifier": "HAN-SGN"
},
"flight": null
},
"availability": null,
"purchaseApplicability": {
"available": true,
"package": false,
"unavailable": false
},
"ancillaryCharges": [
{
"description": "Add Ons Bag 20kgs",
"chargeType": {
"code": "SR",
"description": "SSR",
"feeCategory": null,
"index": 41
},
"currencyAmounts": [
{
"baseAmount": 0,
"discountAmount": 0,
"taxAmount": 0,
"taxRateAmounts": [
{
"name": "Tax 1",
"amount": 0
},
{
"name": "Tax 2",
"amount": 0
},
{
"name": "Tax 3",
"amount": 0
}
],
"totalAmount": 0,
"currency": {
"code": "VND",
"description": "Vietnam Dong"
}
}
],
"taxConfiguration": {
"feeCategory": null
}
}
]
},
{
"key": "ZDBfƒS6Biqƒhc0nRtaDj2Uv6fLef¥vb406CSvfaELvFiaEi6zW6Zh9xQqp0HKBli24BWPIhScuffCbHyqJ00 ...",
"purchaseKey": "yq2CZ1dVlybyxQETDp1D5X94m3Iu0¥ƒIdNy3tSRzghoIANim0hIr9dCfSrIUxr9J86PLllmjMJLl ... ",
"ancillaryItem": {
"key": "eU9Fu4zikmtsn4VBXmWLNMKdIfDPa5j41UJw7WRZxLY=",
"name": "Bag 30kgs",
"description": "Baggage 30kgs",
"index": 51,
"ancillaryCategory": {
"key": "JwSyxxbv9z51Gcƒw6TjYlMCd2GzEmb2nD4TluvSs¥uk=",
"name": "Baggage",
"description": "Choose the appropriate luggage package",
"index": 1,
"purchaseConditions": {
"allowMultipleItems": false
},
"requestedTranslation": null
},
"ancillaryOptionType": {
"airportOption": false,
"cityPairOption": true,
"flightOption": false,
"reservationOption": false
},
"purchaseConditions": {
"maximumPerPassengerCount": 1
},
"requestedTranslation": null,
"refundable": true,
"removable": true
},
"requirementLocation": {
"date": "2025-11-09",
"airport": null,
"cityPair": {
"identifier": "HAN-SGN"
},
"flight": null
},
"availability": null,
"purchaseApplicability": {
"available": true,
"package": false,
"unavailable": false
},
"ancillaryCharges": [
{
"description": "Add Ons Bag 30kgs",
"chargeType": {
"code": "SR",
"description": "SSR",
"feeCategory": null,
"index": 41
},
"currencyAmounts": [
{
"baseAmount": 300000,
"discountAmount": 0,
"taxAmount": 24000,
"taxRateAmounts": [
{
"name": "Tax 1",
"amount": 24000
},
{
"name": "Tax 2",
"amount": 0
},
{
"name": "Tax 3",
"amount": 0
}
],
"totalAmount": 324000,
"currency": {
"code": "VND",
"description": "Vietnam Dong"
}
}
],
"taxConfiguration": {
"feeCategory": null
}
}
]
},
{
"key": "ZDBfƒS6Biqƒhc0nRtaDj2Uv6fLef¥vb406CSvfaELvFiaEi6zW6Zh9xQqp0HKBli24B ...",
"purchaseKey": "yq2CZ1dVlybyxQETDp1D5X94m3Iu0¥ƒIdNy3tSRzghqs3Su1GwJsmSkbSuRw6nW6VJOnl ...",
"ancillaryItem": {
"key": "eU9Fu4zikmtsn4VBXmWLNB5sQXn7ErL¥eT7GbEMvr4Q=",
"name": "Bag 40kgs",
"description": "Baggage 40kgs",
"index": 65,
"ancillaryCategory": {
"key": "JwSyxxbv9z51Gcƒw6TjYlMCd2GzEmb2nD4TluvSs¥uk=",
"name": "Baggage",
"description": "Choose the appropriate luggage package",
"index": 1,
"purchaseConditions": {
"allowMultipleItems": false
},
"requestedTranslation": null
},
"ancillaryOptionType": {
"airportOption": false,
"cityPairOption": true,
"flightOption": false,
"reservationOption": false
},
"purchaseConditions": {
"maximumPerPassengerCount": 1
},
"requestedTranslation": null,
"refundable": true,
"removable": true
},
"requirementLocation": {
"date": "2025-11-09",
"airport": null,
"cityPair": {
"identifier": "HAN-SGN"
},
"flight": null
},
"availability": null,
"purchaseApplicability": {
"available": true,
"package": false,
"unavailable": false
},
"ancillaryCharges": [
{
"description": "Add Ons Bag 40kgs",
"chargeType": {
"code": "SR",
"description": "SSR",
"feeCategory": null,
"index": 41
},
"currencyAmounts": [
{
"baseAmount": 500000,
"discountAmount": 0,
"taxAmount": 40000,
"taxRateAmounts": [
{
"name": "Tax 1",
"amount": 40000
},
{
"name": "Tax 2",
"amount": 0
},
{
"name": "Tax 3",
"amount": 0
}
],
"totalAmount": 540000,
"currency": {
"code": "VND",
"description": "Vietnam Dong"
}
}
],
"taxConfiguration": {
"feeCategory": null
}
}
]
},
{
"key": "ZDBfƒS6Biqƒhc0nRtaDj2Uv6fLef¥vb406CSvfaELvFiaEi6zW6Zh9xQqp0HKBli24BWPIhScuffCbH ...",
"purchaseKey": "yq2CZ1dVlybyxQETDp1D5X94m3Iu0¥ƒIdNy3tSRzghp6cO¥XxTBjVZ40¥A9NsdFzfFBzs7H ...",
"ancillaryItem": {
"key": "eU9Fu4zikmtsn4VBXmWLNMHMFS3QSw39yAXiTMknJLE=",
"name": "Oversize 20kgs",
"description": "1 Oversize piece 20kgs",
"index": 218,
"ancillaryCategory": {
"key": "JwSyxxbv9z51Gcƒw6TjYlMCd2GzEmb2nD4TluvSs¥uk=",
"name": "Baggage",
"description": "Choose the appropriate luggage package",
"index": 1,
"purchaseConditions": {
"allowMultipleItems": false
},
"requestedTranslation": null
},
"ancillaryOptionType": {
"airportOption": false,
"cityPairOption": true,
"flightOption": false,
"reservationOption": false
},
"purchaseConditions": {
"maximumPerPassengerCount": 1
},
"requestedTranslation": null,
"refundable": true,
"removable": true
},
"requirementLocation": {
"date": "2025-11-09",
"airport": null,
"cityPair": {
"identifier": "HAN-SGN"
},
"flight": null
},
"availability": null,
"purchaseApplicability": {
"available": true,
"package": false,
"unavailable": false
},
"ancillaryCharges": [
{
"description": "Add Ons Oversize 20kgs",
"chargeType": {
"code": "SR",
"description": "SSR",
"feeCategory": null,
"index": 41
},
"currencyAmounts": [
{
"baseAmount": 486100,
"discountAmount": 0,
"taxAmount": 38900,
"taxRateAmounts": [
{
"name": "Tax 1",
"amount": 38900
},
{
"name": "Tax 2",
"amount": 0
},
{
"name": "Tax 3",
"amount": 0
}
],
"totalAmount": 525000,
"currency": {
"code": "VND",
"description": "Vietnam Dong"
}
}
],
"taxConfiguration": {
"feeCategory": null
}
}
]
},
{
"key": "ZDBfƒS6Biqƒhc0nRtaDj2Uv6fLef¥vb406CSvfaELvFiaEi6zW6Zh9xQqp0HKBli24BWPIhScuf ...",
"purchaseKey": "yq2CZ1dVlybyxQETDp1D5X94m3Iu0¥ƒIdNy3tSRzghq8O0oirKOwSƒsn7y¥pbV7seZJ ...",
"ancillaryItem": {
"key": "eU9Fu4zikmtsn4VBXmWLNJJVJV5E1oIDanyGLdwqCuE=",
"name": "Oversize 30kgs",
"description": "1 Oversize piece 30kgs",
"index": 219,
"ancillaryCategory": {
"key": "JwSyxxbv9z51Gcƒw6TjYlMCd2GzEmb2nD4TluvSs¥uk=",
"name": "Baggage",
"description": "Choose the appropriate luggage package",
"index": 1,
"purchaseConditions": {
"allowMultipleItems": false
},
"requestedTranslation": null
},
"ancillaryOptionType": {
"airportOption": false,
"cityPairOption": true,
"flightOption": false,
"reservationOption": false
},
"purchaseConditions": {
"maximumPerPassengerCount": 1
},
"requestedTranslation": null,
"refundable": true,
"removable": true
},
"requirementLocation": {
"date": "2025-11-09",
"airport": null,
"cityPair": {
"identifier": "HAN-SGN"
},
"flight": null
},
"availability": null,
"purchaseApplicability": {
"available": true,
"package": false,
"unavailable": false
},
"ancillaryCharges": [
{
"description": "Add Ons Oversize 30kgs",
"chargeType": {
"code": "SR",
"description": "SSR",
"feeCategory": null,
"index": 41
},
"currencyAmounts": [
{
"baseAmount": 594100,
"discountAmount": 0,
"taxAmount": 47600,
"taxRateAmounts": [
{
"name": "Tax 1",
"amount": 47600
},
{
"name": "Tax 2",
"amount": 0
},
{
"name": "Tax 3",
"amount": 0
}
],
"totalAmount": 641700,
"currency": {
"code": "VND",
"description": "Vietnam Dong"
}
}
],
"taxConfiguration": {
"feeCategory": null
}
}
]
},
{
"key": "ZDBfƒS6Biqƒhc0nRtaDj2Uv6fLef¥vb406CSvfaELvFiaEi6zW6Zh9xQqp0HKBli24BWPIhScuffCbHyqJ00 ...",
"purchaseKey": "yq2CZ1dVlybyxQETDp1D5X94m3Iu0¥ƒIdNy3tSRzghrYtV1SEe0lh9uX0ƒF6urƒRcOcIJFHuW0 ...C",
"ancillaryItem": {
"key": "eU9Fu4zikmtsn4VBXmWLNEUPDv6Pfgbi5qosiXT9gGA=",
"name": "Bag 50kgs",
"description": "Baggage 50kgs",
"index": 300,
"ancillaryCategory": {
"key": "JwSyxxbv9z51Gcƒw6TjYlMCd2GzEmb2nD4TluvSs¥uk=",
"name": "Baggage",
"description": "Choose the appropriate luggage package",
"index": 1,
"purchaseConditions": {
"allowMultipleItems": false
},
"requestedTranslation": null
},
"ancillaryOptionType": {
"airportOption": false,
"cityPairOption": true,
"flightOption": false,
"reservationOption": false
},
"purchaseConditions": {
"maximumPerPassengerCount": 1
},
"requestedTranslation": null,
"refundable": true,
"removable": true
},
"requirementLocation": {
"date": "2025-11-09",
"airport": null,
"cityPair": {
"identifier": "HAN-SGN"
},
"flight": null
},
"availability": null,
"purchaseApplicability": {
"available": true,
"package": false,
"unavailable": false
},
"ancillaryCharges": [
{
"description": "Add Ons Bag 50kgs",
"chargeType": {
"code": "SR",
"description": "SSR",
"feeCategory": null,
"index": 41
},
"currencyAmounts": [
{
"baseAmount": 594100,
"discountAmount": 0,
"taxAmount": 47600,
"taxRateAmounts": [
{
"name": "Tax 1",
"amount": 47600
},
{
"name": "Tax 2",
"amount": 0
},
{
"name": "Tax 3",
"amount": 0
}
],
"totalAmount": 641700,
"currency": {
"code": "VND",
"description": "Vietnam Dong"
}
}
],
"taxConfiguration": {
"feeCategory": null
}
}
]
},
{
"key": "ZDBfƒS6Biqƒhc0nRtaDj2Uv6fLef¥vb406CSvfaELvFiaEi6zW6Zh9xQqp0HKBli24BWPIhScuffCbHyqJ00SUN ...",
"purchaseKey": "yq2CZ1dVlybyxQETDp1D5X94m3Iu0¥ƒIdNy3tSRzghqyvEgS54bG50iJYhA9XyiWoi ...",
"ancillaryItem": {
"key": "eU9Fu4zikmtsn4VBXmWLNCxO7EMXNKbK1n¥RC4dXvY0=",
"name": "Bag 60kgs",
"description": "Baggage 60kgs",
"index": 301,
"ancillaryCategory": {
"key": "JwSyxxbv9z51Gcƒw6TjYlMCd2GzEmb2nD4TluvSs¥uk=",
"name": "Baggage",
"description": "Choose the appropriate luggage package",
"index": 1,
"purchaseConditions": {
"allowMultipleItems": false
},
"requestedTranslation": null
},
"ancillaryOptionType": {
"airportOption": false,
"cityPairOption": true,
"flightOption": false,
"reservationOption": false
},
"purchaseConditions": {
"maximumPerPassengerCount": 1
},
"requestedTranslation": null,
"refundable": true,
"removable": true
},
"requirementLocation": {
"date": "2025-11-09",
"airport": null,
"cityPair": {
"identifier": "HAN-SGN"
},
"flight": null
},
"availability": null,
"purchaseApplicability": {
"available": true,
"package": false,
"unavailable": false
},
"ancillaryCharges": [
{
"description": "Add Ons Bag 60kgs",
"chargeType": {
"code": "SR",
"description": "SSR",
"feeCategory": null,
"index": 41
},
"currencyAmounts": [
{
"baseAmount": 702100,
"discountAmount": 0,
"taxAmount": 56200,
"taxRateAmounts": [
{
"name": "Tax 1",
"amount": 56200
},
{
"name": "Tax 2",
"amount": 0
},
{
"name": "Tax 3",
"amount": 0
}
],
"totalAmount": 758300,
"currency": {
"code": "VND",
"description": "Vietnam Dong"
}
}
],
"taxConfiguration": {
"feeCategory": null
}
}
]
},
{
"key": "ZDBfƒS6Biqƒhc0nRtaDj2Uv6fLef¥vb406CSvfaELvFiaEi6zW6Zh9x ....",
"purchaseKey": "yq2CZ1dVlybyxQETDp1D5X94m3Iu0¥ƒIdNy3tSRzghqyEnlQ¥vyTqFJmBiCvK3AWhEV3 ...",
"ancillaryItem": {
"key": "eU9Fu4zikmtsn4VBXmWLNFvN2rU7ODNF9QUhN3oB4Gs=",
"name": "Bag 70kgs",
"description": "Baggage 70kgs",
"index": 302,
"ancillaryCategory": {
"key": "JwSyxxbv9z51Gcƒw6TjYlMCd2GzEmb2nD4TluvSs¥uk=",
"name": "Baggage",
"description": "Choose the appropriate luggage package",
"index": 1,
"purchaseConditions": {
"allowMultipleItems": false
},
"requestedTranslation": null
},
"ancillaryOptionType": {
"airportOption": false,
"cityPairOption": true,
"flightOption": false,
"reservationOption": false
},
"purchaseConditions": {
"maximumPerPassengerCount": 1
},
"requestedTranslation": null,
"refundable": true,
"removable": true
},
"requirementLocation": {
"date": "2025-11-09",
"airport": null,
"cityPair": {
"identifier": "HAN-SGN"
},
"flight": null
},
"availability": null,
"purchaseApplicability": {
"available": true,
"package": false,
"unavailable": false
},
"ancillaryCharges": [
{
"description": "Add Ons Bag 70kgs",
"chargeType": {
"code": "SR",
"description": "SSR",
"feeCategory": null,
"index": 41
},
"currencyAmounts": [
{
"baseAmount": 810100,
"discountAmount": 0,
"taxAmount": 64900,
"taxRateAmounts": [
{
"name": "Tax 1",
"amount": 64900
},
{
"name": "Tax 2",
"amount": 0
},
{
"name": "Tax 3",
"amount": 0
}
],
"totalAmount": 875000,
"currency": {
"code": "VND",
"description": "Vietnam Dong"
}
}
],
"taxConfiguration": {
"feeCategory": null
}
}
]
},
{
"key": "ZDBfƒS6Biqƒhc0nRtaDj2Uv6fLef¥vb406CSvfaELvFiaEi6zW6Zh9xQqp0HKBli24BWPIhScuffCbHyqJ ...",
"purchaseKey": "yq2CZ1dVlybyxQETDp1D5X94m3Iu0¥ƒIdNy3tSRzghouRrTGsg1DuPeGsI1AqTm3NttWSrHYfNtT¥l ...",
"ancillaryItem": {
"key": "eU9Fu4zikmtsn4VBXmWLNCAsRRZc4DqhmoBz0QKeKQg=",
"name": "My YWBisc",
"description": "Combo Spaghetti and Water and Cashew",
"index": 224,
"ancillaryCategory": {
"key": "JwSyxxbv9z51Gcƒw6TjYlFUb1hSpai81aOXHSe¥ZLaA=",
"name": "Meal",
"description": "Choose your favorite meal and enjoy your trip",
"index": 5,
"purchaseConditions": {
"allowMultipleItems": true
},
"requestedTranslation": null
},
"ancillaryOptionType": {
"airportOption": false,
"cityPairOption": true,
"flightOption": false,
"reservationOption": false
},
"purchaseConditions": {
"maximumPerPassengerCount": 2
},
"requestedTranslation": null,
"refundable": true,
"removable": true
},
"requirementLocation": {
"date": "2025-11-09",
"airport": null,
"cityPair": {
"identifier": "HAN-SGN"
},
"flight": null
},
"availability": null,
"purchaseApplicability": {
"available": true,
"package": false,
"unavailable": false
},
"ancillaryCharges": [
{
"description": "Add Ons My YWBisc",
"chargeType": {
"code": "SR",
"description": "SSR",
"feeCategory": null,
"index": 41
},
"currencyAmounts": [
{
"baseAmount": 107000,
"discountAmount": 0,
"taxAmount": 8600,
"taxRateAmounts": [
{
"name": "Tax 1",
"amount": 8600
},
{
"name": "Tax 2",
"amount": 0
},
{
"name": "Tax 3",
"amount": 0
}
],
"totalAmount": 115600,
"currency": {
"code": "VND",
"description": "Vietnam Dong"
}
}
],
"taxConfiguration": {
"feeCategory": null
}
}
]
},
{
"key": "ZDBfƒS6Biqƒhc0nRtaDj2Uv6fLef¥vb406CSvfaELvFiaEi6zW6Zh9xQqp0HKBli24BWPIhScuffCbHyqJ0 ... ",
"purchaseKey": "yq2CZ1dVlybyxQETDp1D5X94m3Iu0¥ƒIdNy3tSRzghrXGaXAJSorHnIsd2I6JT4zwyhpT0vhl5s ...",
"ancillaryItem": {
"key": "eU9Fu4zikmtsn4VBXmWLNLKHNOkXn9i5z10Mk8WldiU=",
"name": "C.ThaiWBisc",
"description": "Combo Thai Fried rice and Water and Cashew",
"index": 226,
"ancillaryCategory": {
"key": "JwSyxxbv9z51Gcƒw6TjYlFUb1hSpai81aOXHSe¥ZLaA=",
"name": "Meal",
"description": "Choose your favorite meal and enjoy your trip",
"index": 5,
"purchaseConditions": {
"allowMultipleItems": true
},
"requestedTranslation": null
},
"ancillaryOptionType": {
"airportOption": false,
"cityPairOption": true,
"flightOption": false,
"reservationOption": false
},
"purchaseConditions": {
"maximumPerPassengerCount": 2
},
"requestedTranslation": null,
"refundable": true,
"removable": true
},
"requirementLocation": {
"date": "2025-11-09",
"airport": null,
"cityPair": {
"identifier": "HAN-SGN"
},
"flight": null
},
"availability": null,
"purchaseApplicability": {
"available": true,
"package": false,
"unavailable": false
},
"ancillaryCharges": [
{
"description": "Add Ons C.ThaiWBisc",
"chargeType": {
"code": "SR",
"description": "SSR",
"feeCategory": null,
"index": 41
},
"currencyAmounts": [
{
"baseAmount": 107000,
"discountAmount": 0,
"taxAmount": 8600,
"taxRateAmounts": [
{
"name": "Tax 1",
"amount": 8600
},
{
"name": "Tax 2",
"amount": 0
},
{
"name": "Tax 3",
"amount": 0
}
],
"totalAmount": 115600,
"currency": {
"code": "VND",
"description": "Vietnam Dong"
}
}
],
"taxConfiguration": {
"feeCategory": null
}
}
]
},
{
"key": "ZDBfƒS6Biqƒhc0nRtaDj2Uv6fLef¥vb406CSvfaELvFiaEi6zW6Zh9xQqp0HKBli24BWPIhScuff ... ",
"purchaseKey": "yq2CZ1dVlybyxQETDp1D5X94m3Iu0¥ƒIdNy3tSRzghp0W4zJoOTQ4RoWs8s8¥C6¥vd5Qysy ...",
"ancillaryItem": {
"key": "eU9Fu4zikmtsn4VBXmWLNM7ScE64yMkMqkxsƒlGKDk4=",
"name": "MienWBisc",
"description": "Combo Crab and Shrimp Glass Noodles and Water and Cashew",
"index": 229,
"ancillaryCategory": {
"key": "JwSyxxbv9z51Gcƒw6TjYlFUb1hSpai81aOXHSe¥ZLaA=",
"name": "Meal",
"description": "Choose your favorite meal and enjoy your trip",
"index": 5,
"purchaseConditions": {
"allowMultipleItems": true
},
"requestedTranslation": null
},
"ancillaryOptionType": {
"airportOption": false,
"cityPairOption": true,
"flightOption": false,
"reservationOption": false
},
"purchaseConditions": {
"maximumPerPassengerCount": 2
},
"requestedTranslation": null,
"refundable": true,
"removable": true
},
"requirementLocation": {
"date": "2025-11-09",
"airport": null,
"cityPair": {
"identifier": "HAN-SGN"
},
"flight": null
},
"availability": null,
"purchaseApplicability": {
"available": true,
"package": false,
"unavailable": false
},
"ancillaryCharges": [
{
"description": "Add Ons MienWBisc",
"chargeType": {
"code": "SR",
"description": "SSR",
"feeCategory": null,
"index": 41
},
"currencyAmounts": [
{
"baseAmount": 107000,
"discountAmount": 0,
"taxAmount": 8600,
"taxRateAmounts": [
{
"name": "Tax 1",
"amount": 8600
},
{
"name": "Tax 2",
"amount": 0
},
{
"name": "Tax 3",
"amount": 0
}
],
"totalAmount": 115600,
"currency": {
"code": "VND",
"description": "Vietnam Dong"
}
}
],
"taxConfiguration": {
"feeCategory": null
}
}
]
},
{
"key": "ZDBfƒS6Biqƒhc0nRtaDj2Uv6fLef¥vb406CSvfaELvFiaEi6zW6Zh9xQqp0HKBli24BWPIhScuffCbHy ...",
"purchaseKey": "yq2CZ1dVlybyxQETDp1D5X94m3Iu0¥ƒIdNy3tSRzghr1qwquqIhDwbGbFCFLokkd1kNLwgCx0fJqjp ...",
"ancillaryItem": {
"key": "eU9Fu4zikmtsn4VBXmWLNIXoDRIAQrC1bhtgbm7e8Mk=",
"name": "BunWBisc",
"description": "Combo Singapore Noodles and Water and Cashew",
"index": 231,
"ancillaryCategory": {
"key": "JwSyxxbv9z51Gcƒw6TjYlFUb1hSpai81aOXHSe¥ZLaA=",
"name": "Meal",
"description": "Choose your favorite meal and enjoy your trip",
"index": 5,
"purchaseConditions": {
"allowMultipleItems": true
},
"requestedTranslation": null
},
"ancillaryOptionType": {
"airportOption": false,
"cityPairOption": true,
"flightOption": false,
"reservationOption": false
},
"purchaseConditions": {
"maximumPerPassengerCount": 2
},
"requestedTranslation": null,
"refundable": true,
"removable": true
},
"requirementLocation": {
"date": "2025-11-09",
"airport": null,
"cityPair": {
"identifier": "HAN-SGN"
},
"flight": null
},
"availability": null,
"purchaseApplicability": {
"available": true,
"package": false,
"unavailable": false
},
"ancillaryCharges": [
{
"description": "Add Ons BunWBisc",
"chargeType": {
"code": "SR",
"description": "SSR",
"feeCategory": null,
"index": 41
},
"currencyAmounts": [
{
"baseAmount": 107000,
"discountAmount": 0,
"taxAmount": 8600,
"taxRateAmounts": [
{
"name": "Tax 1",
"amount": 8600
},
{
"name": "Tax 2",
"amount": 0
},
{
"name": "Tax 3",
"amount": 0
}
],
"totalAmount": 115600,
"currency": {
"code": "VND",
"description": "Vietnam Dong"
}
}
],
"taxConfiguration": {
"feeCategory": null
}
}
]
},
{
"key": "ZDBfƒS6Biqƒhc0nRtaDj2Uv6fLef¥vb406CSvfaELvFiaEi6zW6Zh9xQqp0HKBli24BWPIhScuffCbHyqJ0 ...",
"purchaseKey": "yq2CZ1dVlybyxQETDp1D5X94m3Iu0¥ƒIdNy3tSRzghpxw0V8EjtA36iEr0MQSanvKZvU03oKT7 ... ",
"ancillaryItem": {
"key": "eU9Fu4zikmtsn4VBXmWLNHgtyVNjFY38F6ShwUPQZVQ=",
"name": "C.ChayWBisc",
"description": "Combo Vegetarian Yang Chow Fried Rice and Water and Cashew",
"index": 236,
"ancillaryCategory": {
"key": "JwSyxxbv9z51Gcƒw6TjYlFUb1hSpai81aOXHSe¥ZLaA=",
"name": "Meal",
"description": "Choose your favorite meal and enjoy your trip",
"index": 5,
"purchaseConditions": {
"allowMultipleItems": true
},
"requestedTranslation": null
},
"ancillaryOptionType": {
"airportOption": false,
"cityPairOption": true,
"flightOption": false,
"reservationOption": false
},
"purchaseConditions": {
"maximumPerPassengerCount": 2
},
"requestedTranslation": null,
"refundable": true,
"removable": true
},
"requirementLocation": {
"date": "2025-11-09",
"airport": null,
"cityPair": {
"identifier": "HAN-SGN"
},
"flight": null
},
"availability": null,
"purchaseApplicability": {
"available": true,
"package": false,
"unavailable": false
},
"ancillaryCharges": [
{
"description": "Add Ons C.ChayWBisc",
"chargeType": {
"code": "SR",
"description": "SSR",
"feeCategory": null,
"index": 41
},
"currencyAmounts": [
{
"baseAmount": 107000,
"discountAmount": 0,
"taxAmount": 8600,
"taxRateAmounts": [
{
"name": "Tax 1",
"amount": 8600
},
{
"name": "Tax 2",
"amount": 0
},
{
"name": "Tax 3",
"amount": 0
}
],
"totalAmount": 115600,
"currency": {
"code": "VND",
"description": "Vietnam Dong"
}
}
],
"taxConfiguration": {
"feeCategory": null
}
}
]
},
{
"key": "ZDBfƒS6Biqƒhc0nRtaDj2Uv6fLef¥vb406CSvfaELvFiaEi6zW6Zh9xQqp0HKBli24BWPIhScuffCbHyqJ00S ...",
"purchaseKey": "yq2CZ1dVlybyxQETDp1D5X94m3Iu0¥ƒIdNy3tSRzghrITx¥qYbwT6M6OgƒHLPOVQItT¥lUJsZrM ...",
"ancillaryItem": {
"key": "eU9Fu4zikmtsn4VBXmWLNNqX5Ux¥0F435ZSV8D5ƒkKk=",
"name": "XoiKhucWBisc",
"description": "Combo cudweed cake with Vietnamese pork sausage and Water and Cashew",
"index": 475,
"ancillaryCategory": {
"key": "JwSyxxbv9z51Gcƒw6TjYlFUb1hSpai81aOXHSe¥ZLaA=",
"name": "Meal",
"description": "Choose your favorite meal and enjoy your trip",
"index": 5,
"purchaseConditions": {
"allowMultipleItems": true
},
"requestedTranslation": null
},
"ancillaryOptionType": {
"airportOption": false,
"cityPairOption": true,
"flightOption": false,
"reservationOption": false
},
"purchaseConditions": {
"maximumPerPassengerCount": 2
},
"requestedTranslation": null,
"refundable": true,
"removable": true
},
"requirementLocation": {
"date": "2025-11-09",
"airport": null,
"cityPair": {
"identifier": "HAN-SGN"
},
"flight": null
},
"availability": null,
"purchaseApplicability": {
"available": true,
"package": false,
"unavailable": false
},
"ancillaryCharges": [
{
"description": "Add Ons XoiKhucWBisc",
"chargeType": {
"code": "SR",
"description": "SSR",
"feeCategory": null,
"index": 41
},
"currencyAmounts": [
{
"baseAmount": 107000,
"discountAmount": 0,
"taxAmount": 8600,
"taxRateAmounts": [
{
"name": "Tax 1",
"amount": 8600
},
{
"name": "Tax 2",
"amount": 0
},
{
"name": "Tax 3",
"amount": 0
}
],
"totalAmount": 115600,
"currency": {
"code": "VND",
"description": "Vietnam Dong"
}
}
],
"taxConfiguration": {
"feeCategory": null
}
}
]
},
{
"key": "ZDBfƒS6Biqƒhc0nRtaDj2Uv6fLef¥vb406CSvfaELvFiaEi6zW6Zh9xQqp0HKBli24BWPIhScuffCbHyqJ00SUNOQr ...",
"purchaseKey": "yq2CZ1dVlybyxQETDp1D5X94m3Iu0¥ƒIdNy3tSRzghpƒTqjboazKDGZeOƒySnHhw85Z3XkC6M ...",
"ancillaryItem": {
"key": "eU9Fu4zikmtsn4VBXmWLNDY0EHw¥672ZVtKvGaUCpXc=",
"name": "XoiManWBisc",
"description": "Combo Savory sticky rice and Water and Cashew",
"index": 476,
"ancillaryCategory": {
"key": "JwSyxxbv9z51Gcƒw6TjYlFUb1hSpai81aOXHSe¥ZLaA=",
"name": "Meal",
"description": "Choose your favorite meal and enjoy your trip",
"index": 5,
"purchaseConditions": {
"allowMultipleItems": true
},
"requestedTranslation": null
},
"ancillaryOptionType": {
"airportOption": false,
"cityPairOption": true,
"flightOption": false,
"reservationOption": false
},
"purchaseConditions": {
"maximumPerPassengerCount": 2
},
"requestedTranslation": null,
"refundable": true,
"removable": true
},
"requirementLocation": {
"date": "2025-11-09",
"airport": null,
"cityPair": {
"identifier": "HAN-SGN"
},
"flight": null
},
"availability": null,
"purchaseApplicability": {
"available": true,
"package": false,
"unavailable": false
},
"ancillaryCharges": [
{
"description": "Add Ons XoiManWBisc",
"chargeType": {
"code": "SR",
"description": "SSR",
"feeCategory": null,
"index": 41
},
"currencyAmounts": [
{
"baseAmount": 107000,
"discountAmount": 0,
"taxAmount": 8600,
"taxRateAmounts": [
{
"name": "Tax 1",
"amount": 8600
},
{
"name": "Tax 2",
"amount": 0
},
{
"name": "Tax 3",
"amount": 0
}
],
"totalAmount": 115600,
"currency": {
"code": "VND",
"description": "Vietnam Dong"
}
}
],
"taxConfiguration": {
"feeCategory": null
}
}
]
},
{
"key": "ZDBfƒS6Biqƒhc0nRtaDj2Uv6fLef¥vb406CSvfaELvFiaEi6zW6Zh9xQqp0HKBli24BWPIhScuffCbHyqJ0 ...",
"purchaseKey": "yq2CZ1dVlybyxQETDp1D5X94m3Iu0¥ƒIdNy3tSRzghoIqGhjTƒ9¥3DGSf5YJs2Dph ...",
"ancillaryItem": {
"key": "eU9Fu4zikmtsn4VBXmWLNEuUWHcGqUqMQEĴZCxbIUM=",
"name": "ComBoWBisc",
"description": "Combo beef rice and Water and Cashew",
"index": 478,
"ancillaryCategory": {
"key": "JwSyxxbv9z51Gcƒw6TjYlFUb1hSpai81aOXHSe¥ZLaA=",
"name": "Meal",
"description": "Choose your favorite meal and enjoy your trip",
"index": 5,
"purchaseConditions": {
"allowMultipleItems": true
},
"requestedTranslation": null
},
"ancillaryOptionType": {
"airportOption": false,
"cityPairOption": true,
"flightOption": false,
"reservationOption": false
},
"purchaseConditions": {
"maximumPerPassengerCount": 2
},
"requestedTranslation": null,
"refundable": true,
"removable": true
},
"requirementLocation": {
"date": "2025-11-09",
"airport": null,
"cityPair": {
"identifier": "HAN-SGN"
},
"flight": null
},
"availability": null,
"purchaseApplicability": {
"available": true,
"package": false,
"unavailable": false
},
"ancillaryCharges": [
{
"description": "Add Ons ComBoWBisc",
"chargeType": {
"code": "SR",
"description": "SSR",
"feeCategory": null,
"index": 41
},
"currencyAmounts": [
{
"baseAmount": 107000,
"discountAmount": 0,
"taxAmount": 8600,
"taxRateAmounts": [
{
"name": "Tax 1",
"amount": 8600
},
{
"name": "Tax 2",
"amount": 0
},
{
"name": "Tax 3",
"amount": 0
}
],
"totalAmount": 115600,
"currency": {
"code": "VND",
"description": "Vietnam Dong"
}
}
],
"taxConfiguration": {
"feeCategory": null
}
}
]
},
{
"key": "ZDBfƒS6Biqƒhc0nRtaDj2Uv6fLef¥vb406CSvfaELvFiaEi6zW6Zh9xQqp0HKBli24BWPIhScuffCbHyqJ00SUNOQrnx ...",
"purchaseKey": "yq2CZ1dVlybyxQETDp1D5X94m3Iu0¥ƒIdNy3tSRzghoclXp9VJMFb0GPQ7jZB8EeƒAltqe08rbQƒrƒ9nA4Hg0O9 ...",
"ancillaryItem": {
"key": "eU9Fu4zikmtsn4VBXmWLNDNI0ZSOyhi6ZjSplA58j6Q=",
"name": "BanhChungWBisc",
"description": "Combo Vietnamese steamed cake with pork floss and Water and Cashew",
"index": 480,
"ancillaryCategory": {
"key": "JwSyxxbv9z51Gcƒw6TjYlFUb1hSpai81aOXHSe¥ZLaA=",
"name": "Meal",
"description": "Choose your favorite meal and enjoy your trip",
"index": 5,
"purchaseConditions": {
"allowMultipleItems": true
},
"requestedTranslation": null
},
"ancillaryOptionType": {
"airportOption": false,
"cityPairOption": true,
"flightOption": false,
"reservationOption": false
},
"purchaseConditions": {
"maximumPerPassengerCount": 2
},
"requestedTranslation": null,
"refundable": true,
"removable": true
},
"requirementLocation": {
"date": "2025-11-09",
"airport": null,
"cityPair": {
"identifier": "HAN-SGN"
},
"flight": null
},
"availability": null,
"purchaseApplicability": {
"available": true,
"package": false,
"unavailable": false
},
"ancillaryCharges": [
{
"description": "Add Ons BanhChungWBisc",
"chargeType": {
"code": "SR",
"description": "SSR",
"feeCategory": null,
"index": 41
},
"currencyAmounts": [
{
"baseAmount": 107000,
"discountAmount": 0,
"taxAmount": 8600,
"taxRateAmounts": [
{
"name": "Tax 1",
"amount": 8600
},
{
"name": "Tax 2",
"amount": 0
},
{
"name": "Tax 3",
"amount": 0
}
],
"totalAmount": 115600,
"currency": {
"code": "VND",
"description": "Vietnam Dong"
}
}
],
"taxConfiguration": {
"feeCategory": null
}
}
]
},
{
"key": "ZDBfƒS6Biqƒhc0nRtaDj2Uv6fLef¥vb406CSvfaELvFiaEi6zW6Zh9xQqp0HKBli24BWPIhScuffCbHyqJ00S ...",
"purchaseKey": "yq2CZ1dVlybyxQETDp1D5X94m3Iu0¥ƒIdNy3tSRzghpEx01aoOAdDnDO6LXWuss6cZƒrT ...",
"ancillaryItem": {
"key": "eU9Fu4zikmtsn4VBXmWLNCOwƒWz2Z2sDz9bzbFGFQqI=",
"name": "Cabin Bag 7k",
"description": "Cabin Bag 7k",
"index": 351,
"ancillaryCategory": {
"key": "JwSyxxbv9z51Gcƒw6TjYlAAD2ePIQezLmDqzIS7olDk=",
"name": "Free Service",
"description": "Free Service",
"index": 17,
"purchaseConditions": {
"allowMultipleItems": false
},
"requestedTranslation": null
},
"ancillaryOptionType": {
"airportOption": false,
"cityPairOption": true,
"flightOption": false,
"reservationOption": false
},
"purchaseConditions": {
"maximumPerPassengerCount": 1
},
"requestedTranslation": null,
"refundable": true,
"removable": true
},
"requirementLocation": {
"date": "2025-11-09",
"airport": null,
"cityPair": {
"identifier": "HAN-SGN"
},
"flight": null
},
"availability": null,
"purchaseApplicability": {
"available": false,
"package": true,
"unavailable": false
},
"ancillaryCharges": [
{
"description": "Add Ons Cabin Bag 7k",
"chargeType": {
"code": "SR",
"description": "SSR",
"feeCategory": null,
"index": 41
},
"currencyAmounts": [
{
"baseAmount": 0,
"discountAmount": 0,
"taxAmount": 0,
"taxRateAmounts": [
{
"name": "Tax 1",
"amount": 0
},
{
"name": "Tax 2",
"amount": 0
},
{
"name": "Tax 3",
"amount": 0
}
],
"totalAmount": 0,
"currency": {
"code": "VND",
"description": "Vietnam Dong"
}
}
],
"taxConfiguration": {
"feeCategory": null
}
}
]
},
{
"key": "ZDBfƒS6Biqƒhc0nRtaDj2Uv6fLef¥vb406CSvfaELvFiaEi6zW6Zh9xQqp0HKBli24BWPIhScuffCbHyqJ00SUN ...",
"purchaseKey": "yq2CZ1dVlybyxQETDp1D5X94m3Iu0¥ƒIdNy3tSRzghqbsJr3uhFywgXMd1Sp¥QfaffIm8 ...",
"ancillaryItem": {
"key": "eU9Fu4zikmtsn4VBXmWLNMCQnAIj9pCO57EVBBvJYkk=",
"name": "Lux 15",
"description": "Lux Car 15km",
"index": 492,
"ancillaryCategory": {
"key": "JwSyxxbv9z51Gcƒw6TjYlJLDzobvbvJ5Xuso1uQGC5Y=",
"name": "Taxi",
"description": "Xanh SM",
"index": 28,
"purchaseConditions": {
"allowMultipleItems": true
},
"requestedTranslation": null
},
"ancillaryOptionType": {
"airportOption": false,
"cityPairOption": true,
"flightOption": false,
"reservationOption": false
},
"purchaseConditions": {
"maximumPerPassengerCount": 3
},
"requestedTranslation": null,
"refundable": true,
"removable": true
},
"requirementLocation": {
"date": "2025-11-09",
"airport": null,
"cityPair": {
"identifier": "HAN-SGN"
},
"flight": null
},
"availability": null,
"purchaseApplicability": {
"available": true,
"package": false,
"unavailable": false
},
"ancillaryCharges": [
{
"description": "Add Ons Lux 15",
"chargeType": {
"code": "SR",
"description": "SSR",
"feeCategory": null,
"index": 41
},
"currencyAmounts": [
{
"baseAmount": 237700,
"discountAmount": 0,
"taxAmount": 19100,
"taxRateAmounts": [
{
"name": "Tax 1",
"amount": 19100
},
{
"name": "Tax 2",
"amount": 0
},
{
"name": "Tax 3",
"amount": 0
}
],
"totalAmount": 256800,
"currency": {
"code": "VND",
"description": "Vietnam Dong"
}
}
],
"taxConfiguration": {
"feeCategory": null
}
}
]
}
],
"erros": null
}
# 4.2 Cấu trúc dữ liệu Reponse
| Thuộc tính | Bắt buộc | Kiểu dữ liệu | Mô tả | Ví dụ |
|---|---|---|---|---|
| StatusCode | Có | String | Tình trạng tạo sub | |
| Timestamp | Có | String | Thời gian xử lý request | |
| Path | Có | String | ||
| Message | Có | String | Thông báo kết quả | |
| Errors | Không | String | Thông tin lỗi nếu có | |
| purchaseKey | Có | String | Mã để xác định dịch vụ khi thực hiện mua | |
| ancillaryItem | Có | Object | Thông tin chi tiết về dịch vụ bổ sung | |
| requirementLocation | Có | Object | Thông tin vị trí hoặc chuyến bay áp dụng dịch vụ | |
| availability | Không | Boolean | Trạng thái khả dụng của dịch vụ | |
| key | Có | String | Mã định danh danh mục | |
| name | Có | String | Tên danh mục | |
| description | Có | String | Mô tả danh mục | |
| index | Có | Number | Thứ tự hiển thị | |
| purchaseConditions | Có | Object | Điều kiện mua cho danh mục | |
| requestedTranslation | Không | String | Bản dịch nếu có | |
| airportOption | Có | Boolean | Dịch vụ theo sân bay | |
| cityPairOption | Có | Boolean | Dịch vụ theo cặp thành phố | |
| flightOption | Có | Boolean | Dịch vụ theo chuyến bay cụ thể | |
| reservationOption | Có | Boolean | Dịch vụ theo mã đặt chỗ | |
| date | Có | String | Ngày bay áp dụng | |
| airport | Không | String | Mã sân bay | |
| cityPair | Có | Object | Cặp điểm đi - đến | |
| flight | Không | Object | Thông tin chuyến bay cụ thể | |
| description | Có | String | Mô tả chi tiết phí | |
| chargeType | Có | Object | Loại phí áp dụng | |
| currencyAmounts | Có | Array | Danh sách chi tiết về giá, thuế và tiền tệ | |
| taxConfiguration | Có | Object | Cấu hình thuế liên quan | |
| baseAmount | Có | Number | Giá gốc của dịch vụ | |
| discountAmount | Có | Number | Giảm giá | |
| taxAmount | Có | Number | Tổng số tiền thuế | |
| taxRateAmounts | Có | Array | Danh sách từng loại thuế | |
| totalAmount | Có | Number | Tổng cộng | |
| currency | Có | Object | Đơn vị tiền tệ |
# Bảng mô tả mã tình trạng tạo sub
| Mã | Ý nghĩa |
|---|---|
| 200 | Thành công |
| 400 | Dữ liệu không hợp lệ |
| 401 | Không có quyền tạo sub |
| 404 | DealId không tồn tại trong hệ thống |
| 500 | Lỗi từ phía server |
Last Updated: 10/28/2025, 9:58:11 AM
← Confirm booking price. Get list of ancillary services for multiple bookings.→