Travellers paying directly at property

Learn how you can create your order request so your travellers can secure their bookings and paying at their stay.

Pay at property scenarios

A traveller who pays directly at checkin date, but can secure their booking with or without a card, depending on the property preferences.

	Traveller type	The flow
	A traveller who pays directly at the property with the accepted method and at checkin date.	✓ The traveller makes the booking and provides personal details and if required, credit card information to secure the booking or prepayment. ✓ The partner forward booking details to Booking.com ✓ Then the property handles the payment.

Use case

A traveller uses your application, finds a suitable property and product, and decides to book it. The traveller wants to pay directly at the property at checkin date.

Follow the instructions and recommendations to create the payment data needed on your order request, to cover this use case.

1. Check the available payment options

→ Refer to the Quick guide for examples of responses and initial instructions on how to use the payment endpoints. So you can check the available payments options, including timings, schedules and methods.

Type		Endpoint	Response
	Pay at property	Use /accommodations/details Use /orders/preview	To see the set of methods (cards and/or cash) that a property accepts when paying directly at checkin. To check the set of methods that a property accepts to secure the reservation. These might be only used for cancellation and no show fees.

2. Create your order

The following examples show different use cases that your application could support in this scenario.

Each example shows the payment structure that you would need to provide in the /orders/create request.

Secure booking with card

The traveller decides to pay at the property. The property requires the traveller to add their credit card details to secure their booking.

The flow

• The traveller provides their credit card to guarantee the booking.
• You provide the card details to Booking.com, who in turn forward them to the property.
• The property will charge the card when the traveller stays (checkin date).

The payment field in your /orders/create request will look like this:

"payment": {
     "card": {
         "cardholder": "xxxx",
         "cvc": 123,
         "expiry_date": "2030-10",
         "number": "1234123412341234"
     },
     "method": "card",
     "timing": "pay_at_the_property"
 }

• cardholder, cvc, expiry_date, number: Must contain the details of a valid payment card that can be used to secure the booking.

  • Check the list of the methods.cards supported by the property, returned in the /orders/preview response. (Refer to Quick guide to learn how to get this information).

• method: Must be "card".

• timing: Must be "pay_at_property".

Pay at property without card

The traveller decides to pay at the property and does not use a credit card to secure their booking.

This option is available when the property does not require any payment card details at booking, either for prepayment or to secure the booking.

The flow

• The traveller makes a booking without any payment card details.
• You provide the booking details to Booking.com, who in turn forward them to the property.
• The property will charge the traveller at checkin date.

Specify the following information in the payment object in your /orders/create request:

• timing: Must be "pay_at_property".
• method_required: Must be false (since no credit card is needed).

Example:

 "payment": {
     "timing": "pay_at_the_property"
   }