{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-demand/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Troubleshoot order modifications","siteUrl":"https://developers.booking.com"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"troubleshoot-order-modifications","__idx":0},"children":["Troubleshoot order modifications"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Learn how to identify and resolve common errors when modifying accommodation orders using /orders/modify. This guide covers payment card, reservation and room modification errors, with example responses and recommended solutions."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"overview","__idx":1},"children":["Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When modifying an accommodation order, a request may fail because of invalid reservation details, unsupported changes or restrictions associated with the booked accommodation or room."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This guide explains common errors returned by /orders/modify and how to resolve them."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"understand-modification-failures","__idx":2},"children":["Understand modification failures"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The endpoint can indicate an unsuccessful modification in two ways:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Modification status"]}," - An HTTP 200 response may contain ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status: \"failed\""]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["modification_status: \"failed\""]},", indicating that the requested modification did not succeed."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API error response"]}," - The endpoint may return an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["errors"]}," array containing an error identifier and a message describing the problem."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When a modification fails, check the returned status or error message and verify the current reservation details before submitting another request."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Modification and payment outcomes"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In v3.3, modifications requiring payment processing may return separate ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["modification_status"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment_status"]}," fields. A successful modification does not necessarily mean that payment succeeded."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/orders-api/order-modify#understand-modification-responses"},"children":["Modify your accommodation orders"]}," guide for details about response formats and payment status handling."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"payment-card-errors","__idx":3},"children":["Payment card errors"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"card-type-not-accepted","__idx":4},"children":["Card type not accepted"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Error:"]}," The accommodation does not accept the payment card type provided in the modification request."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example response:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"errors\": [\n    {\n      \"id\": \"incorrect_parameters\",\n      \"message\": \"Hotel does not accept card type {card_type}\"\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["How to resolve:"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Retrieve the accepted payment card types from the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["methods.cards"]}," array returned by /orders/preview."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check that the new payment card type is accepted by the accommodation."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Submit a new modification request using an accepted card type."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/payments/models/booking-collects#2-create-your-order"},"children":["Credit card payments"]}," guide for additional payment card guidance."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"reservation-errors","__idx":5},"children":["Reservation errors"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"reservation-not-found","__idx":6},"children":["Reservation not found"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Error:"]}," The specified reservation cannot be found."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This may occur when the reservation ID is incorrect or does not correspond to the intended order."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example response:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"errors\": [\n    {\n      \"id\": \"incorrect_parameters\",\n      \"message\": \"Reservation not found\"\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["How to resolve:"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Retrieve the reservation details using /orders/details/accommodations."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Verify that the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reservation"]}," ID in the modification request matches the intended accommodation reservation."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check the reservation status before submitting another request."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"reservation-cancelled","__idx":7},"children":["Reservation cancelled"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Error:"]}," The request attempts to modify the dates of a cancelled reservation."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example response:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"errors\": [\n    {\n      \"id\": \"incorrect_parameters\",\n      \"message\": \"Reservation is cancelled\"\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["How to resolve:"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Retrieve the reservation status using /orders/details/accommodations."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirm whether the reservation has been cancelled."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If the reservation is cancelled, its dates cannot be modified. If the guest still requires accommodation, create a new order."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/orders-api/order-preview-create"},"children":["Create your orders"]}," guide for instructions on creating a new booking."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"room-modification-errors","__idx":8},"children":["Room modification errors"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Room modification errors may occur when the requested change is not supported, the room reservation cannot be identified or the modification conflicts with the room's restrictions."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"no-valid-change-parameter-specified","__idx":9},"children":["No valid change parameter specified"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Error:"]}," The request does not contain a supported room-level modification."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example response:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"errors\": [\n    {\n      \"id\": \"incorrect_parameters\",\n      \"message\": \"No valid change parameter specified\"\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["How to resolve:"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ensure that the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["modification.accommodation.change"]}," object identifies the room reservation and includes at least one supported modification:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["allocation.number_of_adults"]},": Update the number of adults allocated to the room."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["guests"]},": Update guest names."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["smoking_preference"]},": Update the room's smoking preference."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Include ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["room_reservation"]}," to identify the room reservation to modify."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"room-reservation-not-found","__idx":10},"children":["Room reservation not found"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Error:"]}," The specified room reservation ID is invalid or does not belong to the order."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example response:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"errors\": [\n    {\n      \"id\": \"incorrect_parameters\",\n      \"message\": \"Room reservation not found\"\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["How to resolve:"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Retrieve the accommodation reservation details using /orders/details/accommodations."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Verify that ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["room_reservation"]}," matches the intended room reservation ID returned under the reservation's products."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirm that the reservation is active and has a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["booked"]}," status."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Submit the modification request with the correct room reservation ID."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"guest-count-cannot-be-changed-for-the-rate","__idx":11},"children":["Guest count cannot be changed for the rate"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Error:"]}," The booked rate has a fixed guest occupancy and does not support changes to the number of guests."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example response:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"errors\": [\n    {\n      \"id\": \"incorrect_parameters\",\n      \"message\": \"Cannot change number of guests when rate-level occupancy is in effect\"\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["How to resolve:"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The booked rate does not allow the guest count to be changed."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If a different guest allocation is required, review the applicable cancellation conditions and consider creating a new order with the required number of guests."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before cancelling an existing reservation, check the applicable cancellation policy and any associated charges. Creating a new order may result in different availability, pricing or booking conditions."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"guest-count-exceeds-the-room-limit","__idx":12},"children":["Guest count exceeds the room limit"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Error:"]}," The requested number of guests exceeds the room's maximum occupancy."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example response:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"errors\": [\n    {\n      \"id\": \"incorrect_parameters\",\n      \"message\": \"Number of guests exceeds the allowed limit for this room\"\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["How to resolve:"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check the room's ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["maximum_occupancy"]}," using /accommodations/availability."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Adjust the requested number of guests to comply with the room's occupancy limits."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If additional guests need accommodation, consider a room type that supports the required occupancy, subject to availability and booking conditions."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/accommodations/occupancy-use-cases"},"children":["Occupancy use cases"]}," guide for more information about room occupancy limits and guest allocation."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"invalid-guest-count","__idx":13},"children":["Invalid guest count"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Error:"]}," The requested number of guests is zero or a negative value."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example response:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"errors\": [\n    {\n      \"id\": \"incorrect_parameters\",\n      \"message\": \"Invalid number of guests specified\"\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["How to resolve:"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ensure that ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["allocation.number_of_adults"]}," contains a positive integer within the room's supported occupancy limits."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"guest-count-unchanged","__idx":14},"children":["Guest count unchanged"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Error:"]}," The requested number of guests matches the existing guest count."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example response:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"errors\": [\n    {\n      \"id\": \"incorrect_parameters\",\n      \"message\": \"Number of guests is already set to the requested value\"\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["How to resolve:"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Retrieve the current room allocation using /orders/details/accommodations."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Compare the existing guest count with the requested value."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Submit a modification request only when the requested guest count differs from the current allocation."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"smoking-preference-restriction","__idx":15},"children":["Smoking preference restriction"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Error:"]}," The requested smoking preference conflicts with the room's fixed smoking policy."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example response:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"errors\": [\n    {\n      \"id\": \"incorrect_parameters\",\n      \"message\": \"Cannot change smoking preference; room is designated as '{smoking_type}' only\"\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["How to resolve:"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Retrieve the room attributes using /orders/details with the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rooms"]}," value in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["extras"]}," array, where supported."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check whether the room is designated as smoking or non-smoking."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If the room has a fixed smoking policy, the smoking preference cannot be changed to a conflicting value."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If a different smoking preference is required, consider alternative accommodation arrangements that meet the guest's needs."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For example, a room with the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["non_smoking"]}," attribute does not support changing its smoking preference to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["smoking"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"invalid-smoking-preference","__idx":16},"children":["Invalid smoking preference"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Error:"]}," The request contains an unsupported smoking preference value."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example response:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"errors\": [\n    {\n      \"id\": \"incorrect_parameters\",\n      \"message\": \"Invalid smoking preference value: '{smoking}'\"\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["How to resolve:"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ensure that ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["smoking_preference"]}," contains one of the supported values:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["no_preference"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No smoking preference specified."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["non_smoking"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Non-smoking room preferred."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["smoking"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Smoking room preferred."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Check that the requested preference is compatible with the room's smoking policy before submitting another modification request."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related-guides","__idx":17},"children":["Related guides"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/orders-api/order-modify"},"children":["Modify your accommodation orders"]}," — Learn how to submit modification requests and interpret the response formats."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/orders-api/order-details"},"children":["Orders details"]}," — Retrieve order and reservation details to verify the current booking state."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/support/error-handling/about-errors"},"children":["Error handling"]}," — Understand general Demand API errors and troubleshooting practices."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/support/error-handling/payment-errors"},"children":["Payment errors"]}," — Find guidance on payment-related errors."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/orders-api/cancel-order"},"children":["Cancel your orders"]}," — Learn how to cancel an existing order when a modification is not possible."]}]}]}]},"headings":[{"value":"Troubleshoot order modifications","id":"troubleshoot-order-modifications","depth":1},{"value":"Overview","id":"overview","depth":2},{"value":"Understand modification failures","id":"understand-modification-failures","depth":3},{"value":"Payment card errors","id":"payment-card-errors","depth":2},{"value":"Card type not accepted","id":"card-type-not-accepted","depth":3},{"value":"Reservation errors","id":"reservation-errors","depth":2},{"value":"Reservation not found","id":"reservation-not-found","depth":3},{"value":"Reservation cancelled","id":"reservation-cancelled","depth":3},{"value":"Room modification errors","id":"room-modification-errors","depth":2},{"value":"No valid change parameter specified","id":"no-valid-change-parameter-specified","depth":3},{"value":"Room reservation not found","id":"room-reservation-not-found","depth":3},{"value":"Guest count cannot be changed for the rate","id":"guest-count-cannot-be-changed-for-the-rate","depth":3},{"value":"Guest count exceeds the room limit","id":"guest-count-exceeds-the-room-limit","depth":3},{"value":"Invalid guest count","id":"invalid-guest-count","depth":3},{"value":"Guest count unchanged","id":"guest-count-unchanged","depth":3},{"value":"Smoking preference restriction","id":"smoking-preference-restriction","depth":3},{"value":"Invalid smoking preference","id":"invalid-smoking-preference","depth":3},{"value":"Related guides","id":"related-guides","depth":2}],"frontmatter":{"title":"Troubleshoot order modifications","description":"Learn how to identify and resolve common errors when modifying accommodation orders using the /orders/modify endpoint.","tags":["demand-api","orders","order-modification","error-handling","troubleshooting","accommodation","reservations"],"api":["/orders/modify","/orders/details","/orders/details/accommodations","/orders/preview"],"keywords":["orders modify errors","troubleshoot order modifications","accommodation modification errors","reservation modification failed","room modification errors","payment card modification errors"],"x-redocly":{"seo":{"title":"Troubleshoot accommodation order modifications | Demand API","description":"Identify and resolve common errors when modifying accommodation orders using the Booking.com Demand API."}},"audience":["developer","partners"],"apiVersion":"v3.2, v3.3","product":"accommodation","seo":{"title":"Troubleshoot order modifications"}},"lastModified":"2026-10-27T15:56:52.024Z","pagePropGetterError":{"message":"","name":""}},"slug":"/demand/docs/orders-api/order-modify-troubleshooting","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}