Cancel

Cancel hotel reservation

Request Method#

POST

uri: /reservation/cancel

Content-Type: application/json


Request parameter description#

RequestHeader#

Common Request Header [reference]

RequestBody#

ParameterTypeRequiredMaximum lengthExampleDescription
resIdStringY64Huazhu reservation number

Response parameter description#

Common Response Parameters [reference]

content#

ParameterTypeRequiredMaximum lengthExampleDescription
penaltyAmountBigDecimalN-Cancellation penalty, Reference field for financial reconciliation
penaltyCurrencyCodeStringN8Currency for cancellation penalty

ResponseCode#

Exception CodeException TypeDescription
1000Success
5401Reservation cannot be canceledOrder cannot be canceled
5402Reservation already canceledReservation canceled
5403Reservation not foundOrder not found
5404Reservation not belong to requesterOrder does not match current channel
5405Reservation cannot be canceled-service has startedCancellation failed , order has been checked in or out.
OthersGlobal Exception CodeGlobal Exception [Reference]

Message example#

Case1: Normal Cancel#

Request Example#

...json { "resId":"R200031####135470001" } ...

Example of successful response#

{
"code": 1000,
"content ": {
"penaltyAmount": 100,
"penaltyCurrencyCode": "CNY"
}
}

Response Failure Example#

{
"code": 5402,
"message": "Reservation already cancelled"
}