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 only field values, IDs, API keys, and any static content from the sandbox environment within the sandbox. Do not use sandbox data in test or production environments, and do not mix data or configuration between different 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.