Modify your orders

Learn how to use the /orders/modify endpoint to update certain details in accommodation orders

Overview

The orders/modify endpoint enables accommodations to update specific details within an existing reservation.

This functionality is available exclusively for accommodations offering "Pay at the property" options and is not applicable to bookings that use online payment.

With this endpoint, you can modify two key elements of a reservation:

✅ Credit card details.

✅ Checkin and checkout dates.

This guide outlines the supported use cases, the steps required to use this endpoint, and best practices to ensure successful modifications.

Endpoint usage

When making a request to the orders/modify endpoint, you must include the following parameters:

Required parameters

Modifying card details

Within the modification object:

1. Use the payment object.

2. Set type to "card".

3. Include the following fields in the "change" object, with the modified data:

• number: The new credit card number.
• cvc: The CVC number.
• cardholder: The cardholder's name.
• expiry_date: The card's expiry date in YYYY-MM format.

Example:

{
  "order": "4334069995",
  "modification": {
    "payment": {
      "type": "card",
      "change": {
        "number": "4111111111111111",
        "cvc": "737",
        "cardholder": "Jon Snow",
        "expiry_date": "2030-03"
      }
    }
  }
}

Modifying checkin/out dates

Within the modification object:

1. Use the accommodation object to modify the dates.

2. Include the reservation id for identification.

3. Set type to "dates".

4. In the change object, include the following fields with the modified data:

• checkin: The new check-in date in YYYY-MM-DD format.
• checkout: The new check-out date in YYYY-MM-DD format.

{
  "order": 4297204980,
  "modification": {
    "accommodation": {
      "reservation": 4297204980,
      "type": "dates",
      "change": {
        "checkin": "2025-10-20",
        "checkout": "2025-10-21"
      }
    }
  }
}

Important considerations

• Separate requests for card cetails and dates: Changes to card details or dates must be made in separate requests.
• Wait time between requests: It is recommended to wait at least 5 minutes between requests for card details and dates.
• Final action: Once a modification request is successful, no further action is required.

Successful modification (200 OK)

Upon successful modification, Demand API returns a 200 OK response.

The structure of the response depends on the type of modification made.

Example of successul card modification:

{
  "data": {
    "modifications": {
      "accommodation": {
        "payment": {
          "status": "successful",
          "type": "card"
        }
      }
    }
  },
  "request_id": "UmFuZG9tSVYkc2RlIyh9YbQc4ZyG3sK2XEgLts3EFBWpaHhlHm7cFsYT19mqggfkmKU6HHuwVMRyCl71JW2jeIIh8dGdptlhYLi7HudiT3wRlN+br65rDw=="
}

Example of successul dates modification:

In the case of dates modification, the response includes the new price for the modified reservation.

{
  "data": {
    "modification": {
      "accommodation": {
        "new_price": 78.25,
        "status": "successful"
      }
    }
  },
  "request_id": "UmFuZG9tSVYkc2RlIyh9YV3CugMXEW9cxCXzj8lTlg8gbGIrozNJUJEQ1pFr+WkAk9uAy/KRmk5J3xi9Yw1h0Xy4jTiofhCe/XCmws8MfGEjI253Pagi+Q=="
}

Price adjustments

When modifying the dates of a reservation, the price may change.

• To avoid unexpected price differences, we recommend verifying the accommodation availability for the new dates before making the modification request.

• Use the accommodations/availability endpoint to check the updated price for the same property on the new dates.

Timing

After a successful modification request:

• Changes to the card details or dates will be reflected in the orders/details response within 30 minutes.
• Modifications can be made as many times as needed. However, the last modification will prevail in case of multiple changes to the same field (either card details or dates).

Unsuccessful modification (4xx Error)

If a modification request fails, the system will return a 4xx error response.

Modifying online payment orders

When attempting to modify an online payment order, the system will return "status": "failed", and the modification will not be applied.

If you need to modify a prepaid online payment booking, we recommend the following steps:

1. Review any applicable cancellation policy.
2. Cancel the existing booking.
3. Create a new order with the necessary changes.

This process ensures that the updated information is applied to your booking.

Conclusion

This endpoint enables accommodations to modify reservations in specific ways, providing greater flexibility for both customers and hosts.

Ensure that you use the correct parameters for modifications and always check for potential price changes when modifying dates.