Cancel

Cancel a hotel booking order with enterprise-grade reliability and state management.

This endpoint handles hotel order cancellation with comprehensive state validation,
audit logging, and enterprise reliability mechanisms. It supports both full and
partial cancellation based on supplier policies and order state.

Critical Prerequisites:

Order ID: Must be provided to identify the target order

JWT Authentication: Bearer token required in Authorization header

Valid Order State: Order must be in a cancellable state

Cancellation Types:

Full Cancellation: Complete order cancellation (most common)

Partial Cancellation: Cancel specific nights or rooms (supplier-dependent)

State-Dependent: Cancellation rules vary by order status and supplier policies

Enterprise Reliability Features:

Order state machine validation and transitions

Comprehensive audit logging and tracking

Automatic rollback on processing failures

CQRS event publishing for downstream processing

Processing time monitoring and performance tracking

State Validation:

Validates order exists and is accessible

Checks current order state for cancellation eligibility

Prevents cancellation of non-cancellable orders

Returns appropriate validation errors for invalid states

Processing Flow:

Validate order existence and accessibility

Check order state for cancellation eligibility

Update order state to NeedCancel

Publish cancellation event to CQRS queue

Handle rollback if processing fails

Record comprehensive audit logs

Error Handling:

Order not found errors with appropriate HTTP status

State validation errors for non-cancellable orders

Downstream timeout errors for supplier delays

Automatic rollback on critical processing failures

Common Use Cases:

Customer-initiated order cancellations

Administrative order cancellations

Policy-based cancellation processing

Order lifecycle management

curl --location --request POST 'https://api-test.hotelbyte.com/api/trade/cancel' \ --header 'Client-Request-Timestamp;' \ --header 'Currency;' \ --header 'IP;' \ --header 'Language;' \ --header 'Request-Id;' \ --header 'Session-Id;' \ --header 'Test;' \ --header 'Timeout-Milliseconds;' \ --header 'Trace-Id;' \ --header 'Authorization: Bearer ' \ --header 'Content-Type: application/json' \ --data-raw '{ "customerReferenceNo": "string", "supplierReferenceNo": "string", "reason": "string" }'

Request

Responses