ETG API V3
[Beta] Sandbox
Post booking
Cancel booking

Cancel booking

🆕
The Sandbox environment is available exclusively to new partners who begin their integration in Q4 2025. 
https://api-sandbox.worldota.net/api/b2b/v3/hotel/order/cancel/

The call cancels the order with the completed or rejected status. Allows the cancellation of non-refundable bookings with charges.

Sandbox limitations

⚠️
Use all field values and API keys obtained from the sandbox environment only within the sandbox. Don’t mix them with test or production environments.
  • The call isn’t required.
  • When canceling a non-refundable booking, penalties won’t be real.

Response

  • currency_code. For every object with this field, the value is always EUR.

Request example 

curl --user '<KEY_ID>:<API_KEY>' 'https://api-sandbox.worldota.net/api/b2b/v3/hotel/order/cancel/' \
--header 'Content-Type: application/json' \
--data '{
  "partner_order_id": "1c481611-6432-5157-03d6-6093g2b75gd1"
}'

Request body

Response

Response example 

{
  "data": {
    "amount_payable": {
      "amount": "306.00",
      "amount_info": null,
      "currency_code": "USD"
    },
    "amount_refunded": {
      "amount": "0",
      "amount_info": null,
      "currency_code": "USD"
    },
    "amount_sell": {
      "amount": "306.00",
      "amount_info": null,
      "currency_code": "USD"
    }
  },
  "debug": null,
  "error": null,
  "status": "ok"
}

Errors

The error field has the value specified in the headers below.

order_not_found

  • The order is finished with other than the completed or rejected status.
  • The order with the partner_order_id field value isn’t found.

order_not_cancellable

  • The stay period has already started.
  • You don’t have permission to cancel non-refundable bookings. Contact your account manager.

sandbox_restriction

An attempt to cancel the real hotel in the test environment.

lock

This error occurs if requests for an endpoint meet both conditions:

Several requests use the same partner_order_id field value. One request is sent twice within a short amount of time.

unknown

The error occurs if something else has gone wrong.