{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-demand/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Regular travellers","siteUrl":"https://developers.booking.com","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"regular-travellers","__idx":0},"children":["Regular travellers"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Learn how to create accommodation orders where travellers pay directly at the property."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"pay-at-the-property-scenarios","__idx":1},"children":["Pay at the property scenarios"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In this scenario, the traveller pays the property directly during their stay. Depending on the property’s payment configuration, the traveller may also need to provide card details to guarantee the booking."]},{"$$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":""},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"style":{"width":"50px"}},"children":[]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":""},"children":[{"$$mdtype":"Tag","name":"div","attributes":{},"children":["Traveller type"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":""},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"style":{"width":"150px"}},"children":[" The flow"]}]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/suitcase.fff8ebc61c754635a60ea26c572afba3f6f288c1d7340478683a62928bd291b3.fe580a34.png","alt":"partner"},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Traveller pays directly at the property using one of the payment methods accepted by the property."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✓ The traveller makes a booking and provides personal details.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ✓ If required, the traveller also provides card details to secure the reservation.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ","✓ You send the booking details to Booking.com.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ✓ The property handles the payment directly with the traveller."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"use-case","__idx":2},"children":["Use case"]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["A traveller uses your application to find a property, creates a booking, and chooses to pay directly at the property."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Follow the instructions below to build the payment object required in your /orders/create request."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"1-check-the-available-payment-options","__idx":3},"children":["1. Check the available payment options"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["→ Follow the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/demand/docs/payments/how-to"},"children":["Payments Quick guide"]}," to learn how to retrieve supported payment methods, timings, and schedules."]},{"$$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":""},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"style":{"width":"25px"}},"children":[" Type"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":""},"children":[{"$$mdtype":"Tag","name":"div","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":""},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"style":{"width":"200px"}},"children":[" Endpoint"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":""},"children":[{"$$mdtype":"Tag","name":"div","attributes":{},"children":[" usage "]}]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/house.dc7d7e8cfaeaa5cfa90114b43a034610e593d2dd72ca75b6ba27e5508fcbb72d.9c1bb791.svg","alt":"houseIcon"},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pay at the property"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["/accommodations/details"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Check which payment methods the property accepts for on-site payment.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["/orders/preview"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Determine whether a payment card is required to secure the booking and which card types are accepted.",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["method_required = true"]}," the traveller must provide a card to secure the booking - Include the card details in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment.card"]}," object of your /orders/create request."]}]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"2-create-the-order","__idx":4},"children":["2. Create the order"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following examples show common pay-at-the-property booking scenarios."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each example demonstrates the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment"]}," object required in the /orders/create request."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"success"},"children":[{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create your /orders/create request"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Build the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment"]}," object based on the applicable scenario below."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"secure-the-booking-with-a-card","__idx":5},"children":["Secure the booking with a card"]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["The traveller pays at the property, but the property requires card details to guarantee the reservation"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"the-flow","__idx":6},"children":["The flow"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The traveller provides card details to secure the booking."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You send the card details to Booking.com."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Booking.com securely forwards the booking guarantee information to the property."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The property charges the traveller directly during their stay."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/example-pay-at-the-property-1.2fe25cb9b5659d70b341cec602c1aa06544c08a17f83347409d8d59f010115d1.fe580a34.png","alt":"drawing"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment"]}," object in your /orders/create request should look like this:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"payment\": {\n    \"card\": {\n      \"cardholder\": \"Test Name\",\n      \"cvc\": \"123\",\n      \"expiry_date\": \"2030-10\",\n      \"number\": \"1234123412341234\"\n    },\n    \"method\": \"card\",\n    \"timing\": \"pay_at_the_property\"\n  }\n}\n\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Field requirements:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment.card.cardholder"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment.card.cvc"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment.card.expiry_date"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment.card.number"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These fields must contain valid card details that can be used to secure the booking."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment.timing"]}," - Must be ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"pay_at_the_property\""]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment.method"]},"- Must be ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"card\""]},"."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the /orders/preview response to determine which card types the property accepts in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment.methods.cards"]},". See the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/demand/docs/payments/how-to"},"children":["Payments quick guide"]}," for more details."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For this scenario, ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["do not include"]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment.airplus"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment.business_information"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment.include_receipt"]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"pay-at-the-property-without-card","__idx":7},"children":["Pay at the property without card"]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["The traveller pays at the property and the property does not require card details to secure the booking"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This scenario is available when the property does not require a payment card either for prepayment or as a booking guarantee."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"the-flow-1","__idx":8},"children":["The flow"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The traveller creates the booking without providing payment card details."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You send the booking details to Booking.com."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The property collects payment directly from the traveller during their stay."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/direct-paytraveller.2bbc2f4ba4737a63cab1b88e8eaeb9599dba98b9a2597ff0e7e4e0d7232225a0.fe580a34.png","alt":"direct pay"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment"]}," object in your /orders/create request should look like this:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"payment\": {\n    \"timing\": \"pay_at_the_property\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Field requirements:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment.timing"]},": Must be ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"pay_at_the_property\""]},"."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For this scenario, ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["do not include"]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment.card"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment.airplus"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment.business_information"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment.include_receipt"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Because no online payment method is used,",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment.method"]}," is not required."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Curious to know more?"},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Learn more about all the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/demand/docs/payments/payments-methods#credit-cards"},"children":["Payment methods"]}," and ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/demand/docs/payments/payments-timings"},"children":["timings"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/demand/docs/orders-api/order-preview-create"},"children":["Orders section"]}," for more tips and examples on how to preview and create your order requests."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/demand/docs/open-api/demand-api/commonpayments/common/payments/cards"},"children":["common/payments/cards"]}," endpoint to understand the card IDs retrieved in your response."]}]}]}]},"headings":[{"value":"Regular travellers","id":"regular-travellers","depth":1},{"value":"Pay at the property scenarios","id":"pay-at-the-property-scenarios","depth":2},{"value":"Use case","id":"use-case","depth":2},{"value":"1. Check the available payment options","id":"1-check-the-available-payment-options","depth":2},{"value":"2. Create the order","id":"2-create-the-order","depth":2},{"value":"Secure the booking with a card","id":"secure-the-booking-with-a-card","depth":3},{"value":"The flow","id":"the-flow","depth":4},{"value":"Pay at the property without card","id":"pay-at-the-property-without-card","depth":3},{"value":"The flow","id":"the-flow-1","depth":4}],"frontmatter":{"seo":{"title":"Regular travellers"}},"lastModified":"2026-05-21T14:07:05.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/demand/docs/payments/models/pay-at-property","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}