Cancellation API
Document Hotel API Cancellation

Mô tả hình thức phạt khi huỷ
Nếu không nhận phòng, hoặc nếu hủy hay thay đổi đặt phòng này sau thời gian nhận phòng, thì bạn có thể phải chịu phí phạt lên đến 100%
giá trị đặt phòng.
Các hình thức phạt
Ví dụ 1: Phạt theo đêm
[{
"startDate": "2021-05-12T18:00:00.000+07:00",
"endDate": "2021-05-13T18:00:00.000+07:00",
"type": "NIGHTS",
"currency": "VND",
"percent": "",
"nights": "1.0",
"amount": "",
"description": ""
}]
Được hủy miễn phí đến trước ngày
2021-05-12T18:00:00.000+07:00
Phạt
1
đêm khi hủy phòng từ ngày2021-05-12T18:00:00.000+07:00
đến ngày2021-05-13T18:00:00.000+07:00
Ví dụ 2: Phạt theo giá tiền
[{
"startDate": "2021-05-12T18:00:00.000+07:00",
"endDate": "2021-05-13T18:00:00.000+07:00",
"type": "AMOUNT",
"currency": "VND",
"percent": "",
"nights": "",
"amount": "200000",
"description": ""
}]
Được hủy miễn phí đến trước ngày
2021-05-12T18:00:00.000+07:00
Bị Phạt
200000
VND
khi hủy phòng từ ngày2021-05-12T18:00:00.000+07:00
đến ngày2021-05-13T18:00:00.000+07:00
Ví dụ 3: Phạt theo phần trăm
[{
"startDate": "2021-05-12T18:00:00.000+07:00",
"endDate": "2021-05-13T18:00:00.000+07:00",
"type": "PERCENT",
"currency": "VND",
"percent": "70%",
"nights": "",
"amount": "",
"description": ""
}]
Được hủy miễn phí đến trước ngày
2021-05-12T18:00:00.000+07:00
Bị Phạt
70%
giá trị của phòng khi hủy phòng từ ngày2021-05-12T18:00:00.000+07:00
đến ngày2021-05-13T18:00:00.000+07:00
Ví dụ 4: Nhiều hình phạt
[{
"startDate": "2021-05-10T18:00:00.000+07:00",
"endDate": "2021-05-12T18:00:00.000+07:00",
"type": "PERCENT",
"currency": "VND",
"percent": "50%",
"nights": "",
"amount": "",
"description": ""
},
{
"startDate": "2021-05-12T18:00:00.000+07:00",
"endDate": "2021-05-13T18:00:00.000+07:00",
"type": "PERCENT",
"currency": "VND",
"percent": "70%",
"nights": "",
"amount": "",
"description": ""
}]
Được hủy miễn phí đến trước ngày
2021-05-10T18:00:00.000+07:00
Bị Phạt
50%
giá trị của phòng khi hủy phòng từ ngày2021-05-10T18:00:00.000+07:00
đến ngày2021-05-12T18:00:00.000+07:00
Bị Phạt
70%
giá trị của phòng khi hủy phòng từ ngày2021-05-12T18:00:00.000+07:00
đến ngày2021-05-13T18:00:00.000+07:00
Ví dụ 5: Nhiều hình phạt
[{
"startDate": "2021-05-10T18:00:00.000+07:00",
"endDate": "2021-05-12T18:00:00.000+07:00",
"type": "PERCENT",
"currency": "VND",
"percent": "50%",
"nights": "",
"amount": "25000",
"description": ""
}]
Được hủy miễn phí đến trước ngày
2021-05-10T18:00:00.000+07:00
Bị Phạt
50%
giá trị của phòng khi hủy phòng từ ngày2021-05-10T18:00:00.000+07:00
đến ngày2021-05-12T18:00:00.000+07:00
kèm theo khoản phíBị phạt
25000
VND
tiền phí khi hủy phòng từ ngày2021-05-10T18:00:00.000+07:00
đến ngày2021-05-12T18:00:00.000+07:00
Ví dụ 6: Hủy miễn phí
[{
"startDate": "2021-05-01T18:00:00.000+07:00",
"endDate": "2021-05-12T18:00:00.000+07:00",
"type": "NIGHTS",
"currency": "VND",
"percent": "",
"nights": "0",
"amount": "",
"description": ""
}]
Được hủy miễn phí đến trước ngày
2021-05-12T18:00:00.000+07:00
1. API Kiểm tra khả năng huỷ phòng và phí phạt
POST: /api/v3/hotel/check-cancel-penalty
Trả về thông tin trạng thái khả năng huỷ phòng, và thông tin phí phạt khi huỷ.
Request Body
Model
Example
Response
Code 200
OK
2. API yêu cầu huỷ booking hotel
POST: /api/partner/cancellation
API gửi yêu cầu huỷ booking đợi trả lời từ nhà cung cấp
Chú ý
Yêu cầu bảo mật: Mã hóa dữ liệu và kèm theo chữ ký điện tử
Request: Không yêu cầu phải được mã hóa và kèm theo chữ ký điện tử
Response: Một phần dữ liệu của response được yêu cầu phải mã hóa và kèm theo chữ ký điện tử
Request Body
Response
Code 200
OK
3. API Kiểm tra trạng thái huỷ phòng
POST: /api/partner/cancellation-check
API kiểm tra trạng thái huỷ phòng
Chú ý
Yêu cầu bảo mật: Mã hóa dữ liệu và kèm theo chữ ký điện tử
Request: Không yêu cầu phải được mã hóa và kèm theo chữ ký điện tử
Response: Một phần dữ liệu của response được yêu cầu phải mã hóa và kèm theo chữ ký điện tử
Request Body
Response
Code 200
OK
Last updated