When Your.Rentals is merchant of record, Quote response returns following information if booking is available.
- rentalRate is rental price of the booking
- discount (if there is) is included in rentalRate already
- cleaning is not included in rentalRate. Cleaning should be added into total amount of the booking only when cleaningFeeBasis is mandatory
- securityDeposit will not be paid at the time of booking
- taxes (if there is) are mandatory and paid upon check in. They should not be added into total amount of the booking.
- guestPaymentInstallments provides due date and amount of guest installments. Normally guest will have to pay 50% of total amount at the time of booking, and the rest is 7 / 14/ 30/ 60 days before check-in, depending on cancellation policy.
Example 1:
In the example below, booking is available.
- total amount of the booking is 5,681.94 EUR (5581.48 rentalRate + 100.46 cleaning)
- rental prices before discount is 6,201.64 EUR (5581.48 + 620.16)
{ "rentalRate": 5581.48, "discount": 620.16, "bookingType": "instant", "cancellation": "Cancellation policy: You will receive a 50% refund when cancelling up to 7 days prior to check-in", "cleaningFeeBasis": "mandatory", "cleaning": 100.46, "securityDeposit": 133.95, "guestPaymentInstallments": [ { "name": "Installment 1", "amount": 2840.97, "dueDate": "2020-04-13" }, { "name": "Installment 2", "amount": 2840.97, "dueDate": "2021-05-30" } ] }
Example 2:
In this example, booking is available.
- booking has no discount
- cleaning fee is included in rental price already
- there is city tax but it will not be added into total amount. Guest will has to pay upon check-in to property manager
- total amount of booking is 840 EUR
{ "rentalRate": 840, "discount": 0, "bookingType": "instant", "cancellation": "Cancellation policy: You will receive a 50% refund when cancelling up to 7 days prior to check-in", "taxes": [ { "name": "City tax", "fee": 1.5 } ], "cleaningFeeBasis": "included", "guestPaymentInstallments": [ { "name": "Installment 1", "amount": 420, "dueDate": "2020-04-13" }, { "name": "Installment 2", "amount": 420, "dueDate": "2020-11-25" } ] }
Example 3:
Booking is not possible.
Some common reasons are Dates not available, Check-in day not available for check-in, Minimum stay not met, Exceeds maximum occupancy, etc.
{ "available": false, "reasons": [ "Dates not available" ] }