Su API Documentation
  • Su Overview
    • Su API Introduction
  • Su Channel Manager
    • Getting Started
      • Certification
      • Authentication
    • Content
      • Property
      • Room Type
      • Rate Plan
      • Listing
        • Property Listing
        • Room Type Listing
        • Rate Plan Listing
        • Delete Property Listing
      • Image API
        • Create Images
        • Retrieve Images
        • Associate Images
    • Booking.com Content API
      • Booking.com
        • Contract - Introduction
          • Create Contract
          • Link/Retrieve Contract
          • Update Contract
          • Resend Contract
        • Property Management
          • Property Statuses
          • Property Detail
            • Create Property
            • Retrieve Property
            • Update Property
          • Contact Details
            • Set Contact
            • Retrieve Contact
            • Contact Profile Types
          • Property Settings
            • Retrieve Property Settings
            • Retrieve Property Settings Damage Programme
            • Retrieve City Tax Category For Property Settings
            • Create / Update Property Settings
            • Create / Update Property Settings - Specific Setting
          • Property Profile
            • Set Profile
            • Retrieve Property Profile
            • Set Hotelier Message
            • Retrieve Hotelier Message
            • Remove Hotelier-Message
          • Booking.com Property Status
            • Property Status Check
            • Property Status Open
            • Property Status Closed
          • Property Key Collection
            • Set CheckIn Methods
            • Retrieve CheckIn Method
            • Retrieve All Stream Variation
        • Images
          • Create Image
          • Retrieve All Images
          • Update Image Tags
          • Delete Image
          • Retrieve Associate Images
          • Associate Image
          • Unassociate Image
          • Ordering Image
          • Smart Ordering Image
          • Show Image
          • Retrieve Property Pending Photos based on photo-batch-id
          • Retrieve Image Tags
        • Facilities
          • Create/Update Facility
          • Retrieve Set Facility of Property and Room
          • Retrieve Supported Facilities
        • Property/Room Charges
          • Retrieve Property Charge Meta
          • Retrieve Property Charges
          • Retrieve Room Charges
          • Create Property Charges
        • Rate Plan
          • Set Rateplan
          • Retrieve Rateplan
      • Room API
        • Room Meta API
        • Room Set (Create/Update) API
        • Room Retrieve API
        • Room Deactivate API
      • Policies API
        • Create/Update Policies
        • Retrieve Policies
      • Bathroom API
        • Set Bathroom (Create and Update)
        • Remove/Disable Bathroom
        • Retrieve Bathroom
      • Product API
        • Product Meta
        • Product List
        • Product Create
        • Product Modify
        • Product Remove
        • Product Map Create (Room Based)
        • Product Map Modify (Room Based)
        • Product Map Create (Occupancy Based)
        • Product Map Modify (Occupancy Based)
        • Product Unmap
      • Property and Room License
        • Property License Retrieve All Rule (Without property id)
        • Property License Retrieve Rule (With property id)
        • Sending License Information of Property
        • Retrieve License Information of Property
        • Sending License Information of Room
        • Retrieve License Information of Room
      • BCIO (Booking.com Check-In / Check-Out Times)
      • PCT (Property Class Type Codes)
      • BCJT (Booking.com Job Titles)
      • PTT (Phone Technology Type Codes)
      • BCL (Booking.com Language Codes)
      • Currency Codes/Names
      • Country Codes/Names
      • BCPT (Booking.com Payment Type Codes)
    • Rates and Availability
    • Inventory Control
    • Reservations
      • New/Modified/Requested/Cancelled Retrievals
        • Request for Reservation Information
        • Response of Reservation Information
      • Reservation Using Push API
        • Reservations Notification Push
        • PUSH API Method
      • Reservation Notification
      • Request Booking
        • Accept/Confirm Request Booking
        • Deny/Cancel Request Booking
      • Booking Repull
        • List of Bookings
        • Refetch Booking
    • Logs
      • Update Logs
      • Failed Channel Logs
      • Rates & Inventory Logs (Future Date)
      • Bulk Rates & Inventory Logs (Future Date)
      • Resync OTA Updates (Failed)
      • OTA Rateplan Pull API
    • Users
      • Global Users
      • Chain Users
    • Channel Mapping Widget API
      • Generate a Token
      • Mapping Script
    • Reviews
    • Messaging
    • Reporting
      • Reporting - No Show (Booking.com & Goibibo)
      • Reporting - Invalid CC (Booking.com)
      • Reporting - Cancellation Due to Invalid CC (Booking.com)
      • Bulk ARI Update
      • Marketing Insight API - Booking.com
    • AirBnB
      • Cancel Reservation
        • Retrieve AirBnB Cancel Reservation Details API
        • Final AirBnB Cancel Reservation API
      • Notification
      • Trip Issue
    • My Booking Site
      • Confirm Reservation
      • Cancel Reservation
  • Su Token
    • Su Token - Introduction
    • Su Token - Authentication
    • Partner
    • Card
      • Card API
      • Card View API
      • Charge API
      • Card Collection
        • Get CC Collection (Generate Link)
        • Check Status of CC Collection
      • WIDGET
        • CC Collection Using Widget
  • Codes
    • Room Type Codes
    • Language Codes
    • Country Codes
    • Phone Technology Type Codes
    • Meal Plan Codes
    • Currency Codes
    • Channel or OTA Codes
    • Credit Card Type Codes
    • Time Zones
    • Error Codes
  • Versioning
  • Glossary of Terms
Powered by GitBook

STAAH Limited. 2024 © All Rights Reserved.

On this page
  • Endpoint
  • Sample Request
  • Response

Was this helpful?

Export as PDF
  1. Su Channel Manager
  2. Booking.com Content API
  3. Booking.com
  4. Property Management
  5. Property Settings

Retrieve Property Settings Damage Programme

PreviousRetrieve Property SettingsNextRetrieve City Tax Category For Property Settings

Last updated 2 months ago

Was this helpful?

This endpoint allows partners to retrieve the terms and conditions of the Damage Payment Request Process (DPRP) associated with their property on the Booking.com platform.


Endpoint

POST

https://connect-sandbox.su-api.com/SUAPI/jservice/bdc/property/settings/retrieveDamageProgramme

Header

-app-id: YOUR_APP_ID
Authorization: YOUR_API_KEY
Content-Type:application/json
Header
Type
Required
Description

app-id

string

Yes

Your application ID. Required for authentication.

Authorization

string

Yes

Your API key for authorization.

Content-Type

string

Yes

Must be set to application/json.


Attributes

language_code string (Required)

Specify the language code in which you want the terms to be returned in.

Accepts the values listed under BCL.


Sample Request

{
   "language_code": "en-us"
}

Response

Sample Success Response

{
  "Status": "Success",
  "Message": "Successfully fetch details",
  "Warnings": "",
  "Ruid": "e527c45a-f23a-4ee4-beb2-7d21f7699b1b",
  "data": "The following terms apply to the Damage Payment Request Process (as defined below) between the Accommodation (hereinafter the “Partner” or “You”) & Booking.com (hereinafter “Booking.com” or “Us”).\nBooking.com offers partners a Damage Payment Request Process (hereinafter the “DPRP”), through which Booking.com facilitates the collection of damage fee(s) incurred from damages caused to your property (hereinafter “Damage Fee(s)”), in line with the DPRP communicated to your guest(s) (hereinafter the “Guest(s)”). By implementing the DPRP on your behalf, Booking.com will not require the upfront collection of a deposit. Instead, in the event of alleged damage being caused to your property by a guest, you will be able to submit a damage payment request (the “Damage Payment Request”) to the guest via Booking.com (according to the conditions below), which might result in the Guest(s) reimbursing you if they accept that the damage was caused during their stay.\nPlease note: You can opt out of the DPRP at any moment. However, you agree and acknowledge that in such a situation, if your Property has been booked through our platform during the time you were part of the DPRP, then the booking will be subject to these Terms.\nBy opting in to the Damage Payment Request Process, you accept the following Terms:\nBooking.com will inform the Guest(s) that:\nthey must keep your property and its content(s), including all furniture, electronic equipment, fixtures, fittings, and effects (hereinafter the “Property”), in, on or at the Property in the same state of repair as at the start of the stay.\nthey are responsible for the safekeeping of the rental property and its contents, therefore they must remember, among others, to lock all doors and windows, and ensure that the Property is safe upon their departure.\nin the situation where any breakages, damage(s) or loss(es) occur in the Property, the Guests should report it to the Partner, and request them to make a Damage Payment Request under their reservation, as soon as reasonably practicable, but always up to 14 days after the Guests’ check-out.\nthey are responsible to reimburse Booking.com/the Partner for the damage(s), breakages or loss(es) caused to the Property and its contents (as defined above) by the Guest(s), according to the DPRP, limited to the amount You agreed when signing up to the DPRP, and in any case to a maximum limit of € 1,000. For the avoidance of doubt, the DPRP does not seek to undermine or replace the Partners’ property, liability or contents insurance it may have or prevent such insurance company's ability to pursue a claim for compensation for damage claims.\nExclusions to Damage Fees may include general cleaning, ordinary wear and tear, theft of cash and securities, and non-physical damages like smoking fines and breaking House Rules. Exclusions also include any type of bodily injury or proprietary damage to Guests' personal belongings or others, any kind of criminal activities, secondary/consequential loss, third-party liability as well as any damages that might be caused by an event of force majeure.\nIf you wish to make a Damage Payment Request for these types of incidents, you will need to handle such a request directly with your Guest(s), as these types of incidents are not included in the DPRP.\nYou agree that in order to submit a Damage Payment Request, you will need to connect to the reservation page on the extranet, and initiate the request via the right side menu “Make a Damage Payment Request” button, where you will be required to provide key details (such as which item has been damaged, what is the exact damage, what was the initial cost of the item, etc.)\nYou will also be required to provide evidence(s) of the damage/loss, as specified on the extranet platform. Please note that without providing any evidence of the damage caused to the Property and/or its contents, Booking.com will not be in a position to be able to communicate your Damage Payment Request to the Guest(s) for potential agreement.\nPlease note that you should not share any personal data or private information when formulating a Damage Payment Request through the platform, unless it is strictly necessary in order to support the Payment Request in question.\nIn the situation where the Guest(s) does not agree with and/or rejects your payment request, and/or does not confirm the alleged damage(s) to the Property and/or its content(s), you give Booking.com consent to review all communications between you and the Guest(s) via the Booking.com Platform. Booking.com has the full discretion not to facilitate the guest payment request. Booking.com's decision in relation to the DPRP is final and not subject to appeal, however, this will not preclude the Partner from pursuing legal remedies against the Guest outside of the DPRP.\nYou agree that Booking.com will only involve itself to support with the facilitation of the Damage Payment Request between You and the Guest(s), and will not in any way be responsible for the cost of the damages itself and/or for pursuing any claim against the guest outside of the DPRP.\nYou agree that You will be able to submit a payment request to Guest(s) for damage caused to the Property and/or its contents (as defined above) via Booking.com, up to 14 days after the end of their stay.\nIn any case, You agree that by opting into the DPRP, you will not be able to charge the Guest, even though you might already hold the Guest(s) payment details, and that Booking.com will be the only party allowed to charge the Guest(s) under the DPRP.\nYou understand that for the time being, Partners will not be required to pay the additional costs of Booking.com collecting the money from the Guest(s). However, Booking.com might reserve its right, in the future, to charge Partners for the costs of recuperating the Damage Fee(s) – in such case, Booking.com will provide beforehand, by way of notification, the details of such costs.\nIf You submit a fraudulent Damage Payment Request either by yourself or in collusion with the Guest(s), Booking.com reserves the right to:\nsuspend Partner participation in the DPRP;\nsuspend Partner payouts related with any ongoing and/or suspected fraudulent process;\nsuspend or terminate the Partner Agreement contract on the basis of a violation of our General Delivery Terms.\nThese Terms shall be exclusively governed by and construed in accordance with the laws of the Netherlands. Save as set out otherwise in these Terms, any disputes arising out of or in connection with these Terms shall exclusively be submitted to and dealt with by the competent court in Amsterdam, the Netherlands.\nWe may from time to time update and adjust these Terms, subject to prior communication (e.g. email or system notice) to You. Any updated or adjusted version shall replace and supersede the existing (current) version with such effect as set out in the notice of update/replacement."
}

Success Response Body Elements

Status string

Indicates the overall status of the request. In this case, "Success" means the operation was completed successfully.

Message string

Provides a brief message about the outcome. Here, it states "Successfully fetch details," confirming that the requested information was retrieved.

data string

Contains detailed terms regarding the Damage Payment Request Process (DPRP) between the accommodation (the Partner) and Booking.com. This text outlines the responsibilities, conditions, and processes involved in handling damage fees incurred during a guest's stay.

Errors

Sample Error Response 1

{
   "Errors": [
       {
           "Code": "400",
           "ShortText": "HotelCode: Invalid HotelCode ('AWSTEST')"
       }
   ],
   "Status": "Fail"
}

Sample Error Response 2

{
   "Errors": [
       {
           "Code": "573",
           "ShortText": "channel-mapping not found for this property!"
       }
   ],
   "Status": "Fail"
}

Sample Error Response 3

{
   "Errors": [
       {
           "Code": "718",
           "ShortText": "language_code - is not valid or not found!"
       }
   ],
   "Status": "Fail"
}

Sample Error Response 4

{
   "Status": "Fail",
   "Errors": [],
   "Message": "Invalid value: query param language_code - Language code is invalid.",
   "Ruid": "dbe6c93d-836c-437e-a604-c361ba8e654f",
   "Data": {}
}

Error Response Body Elements

Status string

Indicates the result of the API call, which will be always "Fail" in case of an error response.


Error array

Array that contains details about any errors that occurred during the API call. Each object in the Errors array contains the following properties:

Code string

Specific error code that helps identify the type of error.

For example: "400" indicates a bad request.

ShortText string

A short description of the error.


Message string

A message providing more information about the error.