Cancellation API
Document Hotel API Cancellation

Description of penalties for cancellation
If you do not check in, or if you cancel or modify this reservation after the check-in time, you may be subject to a penalty fee of up to 100% of the booking value.
Penalties
Example 1: Cancellation fee per night
[{
"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": ""
}]
Free cancellation before
2021-05-12T18:00:00.000+07:00
1 night fee for cancellation from
2021-05-12T18:00:00.000+07:00
to2021-05-13T18:00:00.000+07:00
Example 2: Cancellation fee by price
[{
"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": ""
}]
Free cancellation before
2021-05-12T18:00:00.000+07:00
Cancellation fee of 200,000 VND from May 12, 2021, 18:00 (GMT+7) to May 13, 2021, 18:00 (GMT+7).
Example 3: Cancellation fee by percentage
[{
"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": ""
}]
Free cancellation before
2021-05-12T18:00:00.000+07:00
Cancellation fee 70% of room value from
2021-05-12T18:00:00.000+07:00
to2021-05-13T18:00:00.000+07:00
Example 4: Various types of cancellation fees
[{
"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": ""
}]
Free cancellation before
2021-05-10T18:00:00.000+07:00
Cancellation fee 50% of room value from
2021-05-10T18:00:00.000+07:00
to2021-05-12T18:00:00.000+07:00
Cancellation fee 70% of room value from
2021-05-12T18:00:00.000+07:00
to2021-05-13T18:00:00.000+07:00
Example 5: Cancellation fee with various fee
[{
"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": ""
}]
Free cancellation before
2021-05-10T18:00:00.000+07:00
Cancellation fee 50% of room value from
2021-05-10T18:00:00.000+07:00
to2021-05-12T18:00:00.000+07:00
with various fee.Cancellation fee of 25,000 VND from
2021-05-10T18:00:00.000+07:00
to2021-05-12T18:00:00.000+07:00
Example 6: Free cancellation
[{
"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": ""
}]
Free cancellation before
2021-05-12T18:00:00.000+07:00
1. API to Check Cancellation Eligibility and Fees
POST: /api/v3/hotel/check-cancel-penalty
Returns room cancelability status information, and cancellation penalty information.
Request Body
Model
Example
Response
Code 200
OK
2. API request to cancel hotel booking
POST: /api/partner/cancellation
API sends a cancellation request for a hotel booking and waits for a response from the provider
Notice:
Security Requirements: Data must be encrypted and include a digital signature.
Request: Encryption and digital signature are not required.
Response: Certain parts of the response must be encrypted and include a digital signature.
Request Body
Response
Code 200
OK
3. API to Check Room Cancellation Status
POST: /api/partner/cancellation-check
API to check room cancellation status
Note
Security Requirements: Encryption and Digital Signature Required
Request: Encryption and digital signature are not required.
Response: Certain parts of the response must be encrypted and include a digital signature.
Request Body
Response
Code 200
OK
Last updated