{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-demand/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition","cards"]},"type":"markdown"},"seo":{"title":"Payment models for accommodation","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":"payment-models-for-accommodation","__idx":0},"children":["Payment models for accommodation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Follow the use cases instructions to construct your order/create request according to your specific business scenario."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following examples show the most common payment scenarios applied to different parnership types, methods, timings and type of payments (online and offline payments)."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each use case shows the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment"]}," structure that you need to define in the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/demand/docs/open-api/demand-api/orders/orders/create"},"children":["/orders/create"]}," request for each case."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Follow the instructions that are relevant to your particular payment use case."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"1-check-the-available-payment-options","__idx":1},"children":["1. Check the available payment options"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before going to specific instructions on how to create your order request for your payment scenario, you must check the available timings, schedules and, payment methods for the desired accommodations."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the right endpoint for each type of payment:"]},{"$$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":[" Response"]}]}]}]},{"$$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":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/demand/docs/open-api/demand-api/accommodations/accommodations/details"},"children":["/accommodations/details"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["It returns the set of methods that a property accepts when paying offline at the property at checkin date."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/monetization-tablet.f9f01f530881c3f3631756e4d81fb8eb796e2ac99a4424ab5cfdcea57d66b5f8.9c1bb791.svg","alt":"onlinepay"},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Online payments"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/demand/docs/open-api/demand-api/orders/orders/preview"},"children":["/orders/preview"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["It returns the set of methods that a property accepts to secure the reservation:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For pay online now / later, securing the reservation also means paying for it."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For pay at the property, the payment methods shown in ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/demand/docs/open-api/demand-api/orders/orders/preview"},"children":["/orders/preview"]}," might be only used for cancellation and no show fees."]}]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Refer to the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/demand/docs/payments/how-to"},"children":["Quick guide"]}," for examples and initial instructions on how to check available payment options."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"2-create-your-order","__idx":2},"children":["2. Create your order"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once a traveller has chosen how and when to book, use ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/demand/docs/open-api/demand-api/orders/orders/create"},"children":["/orders/create"]}," to process the payment."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Construct your request to match the specific requirements of your payment model."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"success","name":"Steps"},"children":[{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Jump into the payment use case that is relevant to your business."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check whether you meet all the requirements."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Look at the order/preview response provided as example."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Go to your ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/demand/docs/open-api/demand-api/orders/orders/create"},"children":["/orders/create"]}," request."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Specify the needed information in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment"]}," object following the examples and recommendations provided for your use case."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"payment-models","__idx":3},"children":["Payment models"]},{"$$mdtype":"Tag","name":"Cards","attributes":{"cards":[{"title":"Partners charging travellers","icon":"agreement","link":"/demand/docs/payments/models/partner-collects","withArrow":true},{"title":"Partners not charging travellers directly","icon":null,"link":"/demand/docs/payments/payments-booking-collects","withArrow":true},{"title":"Corporate partners","icon":null,"link":"/demand/docs/payments/models/corporate","withArrow":true},{"title":"Traveller paying at property","icon":null,"link":"/demand/docs/payments/payments-pay-at-property","withArrow":true}]},"children":[]},{"$$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 about all the available ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/demand/docs/payments/payments-methods"},"children":["payment methods"]}," and ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/demand/docs/payments/payments-timings"},"children":["timings"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Refer to the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/demand/docs/payments/how-to"},"children":["Quick guide"]}," for initial instructions on how to check available payment options."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Explore the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/demand/docs/orders-api/overview"},"children":["Orders section"]}," for examples and best practices on creating and checking orders."]}]}]}]},"headings":[{"value":"Payment models for accommodation","id":"payment-models-for-accommodation","depth":1},{"value":"1. Check the available payment options","id":"1-check-the-available-payment-options","depth":2},{"value":"2. Create your order","id":"2-create-your-order","depth":2},{"value":"Payment models","id":"payment-models","depth":3}],"frontmatter":{"cards":{"productsAndFeatures":[{"title":"Partners charging travellers","icon":"agreement","link":"/demand/docs/payments/models/partner-collects","withArrow":true},{"title":"Partners not charging travellers directly","icon":null,"link":"/demand/docs/payments/payments-booking-collects","withArrow":true},{"title":"Corporate partners","icon":null,"link":"/demand/docs/payments/models/corporate","withArrow":true},{"title":"Traveller paying at property","icon":null,"link":"/demand/docs/payments/payments-pay-at-property","withArrow":true}]},"navigation":{"nextButton":{"hide":false},"previousButton":{"hide":false}},"markdown":{"lastUpdatedBlock":{"hide":false},"toc":{"hide":false},"frontMatterKeysToResolve":["cards"]},"lastModified":{"hide":false},"seo":{"title":"Payment models for accommodation"}},"lastModified":"2026-05-21T14:07:05.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/demand/docs/payments/models/accommodation-payment-models","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}