{"templateId":"markdown","sharedDataIds":{},"props":{"metadata":{"markdoc":{"tagList":["admonition","cards"]},"type":"markdown"},"seo":{"title":"Accommodation payments quick guide","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":"accommodation-payments-quick-guide","__idx":0},"children":["Accommodation payments quick guide"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["If you're implementing a ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/development-guide/application-flows/#search-look-book"},"children":["Search, look and book integration"]}," use this guide to learn how to check available payment options and define how the traveller will pay when creating an order."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"payment-overview","__idx":1},"children":["Payment overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Payment handling is integrated into the required travel service API collection (/accommodations or /cars) and /orders endpoints."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use these endpoints within your application flow to:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["✅ Display payment timings, schedules and methods to travellers."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["✅ Process their payment during booking."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/overview_how-to-use-payments.9ed2c436d1bf5d700e2736fb42facfd10ad1cb9fc002df04827a802171af5532.fe580a34.jpg","alt":"How to use payments"},"children":[]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"success"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before diving into implementation details, ensure you're familiar with:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/payments/payments-timings/"},"children":["Payment timings"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/payments/payments-schedules"},"children":["Payment schedules"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/payments/payments-methods/"},"children":["Payment methods"]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"do-i-need-payments","__idx":2},"children":["Do I need Payments?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use Payments if you are implementing a ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/development-guide/application-flows#search-look-and-book"},"children":["Search, look and book"]}," integration for:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Accommodation (v3.1, v3.2)"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Skip this section if you are implementing a ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/development-guide/application-flows#content-only"},"children":["Content only"]}," integration."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-1---check-available-payment-options","__idx":3},"children":["Step 1 - Check available payment options"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"search-and-look","__idx":4},"children":["Search and look"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When travellers search for a travel service, use the following endpoints to check when and how payment can be made."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Display the appropriate payment options based on your particular payment scenario."]},{"$$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":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Endpoint"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use it to ..."]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["/search ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," /availability"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Retrieve supported ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/payments/payments-timings/"},"children":["payment timings"]}," available for a product."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["/details"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Retrieve accepted ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/payments/payments-methods/"},"children":["payment methods"]}," (payment cards and/or cash) for the selected product."]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/getting-started/try-out-the-api/#steps"},"children":["Try out section"]}," to learn how to test these endpoints."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/genius-bulb.3e13976eeeabd0526f1d76bfb7de5967932211a5ef4afe526a3b0a71a7b02fb0.5e2a7131.png","alt":"genius-bulb"},"children":[]}," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Filter by payment timing"]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment.timing"]}," filter to return only products that support a specific payment timing."]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For accommodation:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pay_at_the_property"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pay_online"]}," ","This filter is inclusive—properties supporting both ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pay_online_later"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pay_online_now"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/accommodations/filter-sorting"},"children":["Filtering and sorting guide"]}," for details."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"filter-by-payment-timing","__idx":5},"children":["Filter by payment timing"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment.timing"]}," filter to return only products that support a specific payment timing."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["For accommodation:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pay_at_the_property"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pay_online"]},"- This filter includes products that support both ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pay_online_later"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pay_online_now"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example accommodation/search request:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"booker\": {\n    \"country\": \"nl\",\n    \"platform\": \"desktop\"\n  },\n  \"checkin\": \"2026-09-08\",\n  \"checkout\": \"2026-09-15\",\n  \"city\": -2140479,\n  \"filters\": {\"payment\": {\"timing\": \"pay_online\"}},\n  \"extras\": [\n    \"extra_charges\",\n    \"products\"\n  ],\n  \"guests\": {\n    \"number_of_adults\": 2,\n    \"number_of_rooms\": 1\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/accommodations/filter-sorting"},"children":["Accommodation - Filtering and sorting guide"]}," for details."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["For car rentals:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pay_at_pickup"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pay_online_now"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pay_partial_online_now"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example cars/search request:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n    \"booker\": {\n      \"country\": \"nl\"\n    },\n    \"currency\": \"EUR\",\n    \"driver\": {\n      \"age\": 36\n    },\n    \"payment\": {\n      \"timings\": [\n        \"pay_online_now\"\n      ]\n    },\n    \"route\": {\n      \"dropoff\": {\n        \"datetime\": \"2026-11-10T11:05:00\",\n        \"location\": {\n          \"city\": -2140479\n        }\n      },\n      \"pickup\": {\n        \"datetime\": \"2026-11-05T11:05:00\",\n        \"location\": {\n          \"city\": -2140479\n        }\n      }\n    }\n  }\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/cars/cars-filter-sorting"},"children":["Car rental - Filtering and sorting guide"]}," for details."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example accommodation/search request:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"booker\": {\n    \"country\": \"nl\",\n    \"platform\": \"desktop\"\n  },\n  \"checkin\": \"2026-09-08\",\n  \"checkout\": \"2026-09-15\",\n  \"city\": -2140479,\n  \"filters\": {\"payment\": {\"timing\": \"pay_online\"}},\n  \"extras\": [\n    \"extra_charges\",\n    \"products\"\n  ],\n  \"guests\": {\n    \"number_of_adults\": 2,\n    \"number_of_rooms\": 1\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"book-and-pay","__idx":6},"children":["Book and pay"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once the traveller selects a product to book, use the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/open-api/demand-api/orders/orders/preview"},"children":["/orders/preview endpoint"]}," to get payment-specific details."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Always use /orders/preview to dynamically determine current payment options. These may change based on property policy or availability."]}]},{"$$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":"Endpoint"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Endpoint"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Use it to ..."},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use it to ..."]}]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/open-api/demand-api/orders/orders/preview"},"children":["/orders/preview"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Check the final details of the selected accommodation and products, including:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["When (",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/payments/payments-timings/"},"children":["payment timings"]},") the traveller is expected to pay."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Which ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/payments/payments-methods/"},"children":["payment methods"]}," are accepted 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 completing the payment."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For pay at the property, the payment methods provided in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/open-api/demand-api/orders/orders/preview"},"children":["/orders/preview"]}," might only be used for cancellation and no show fees."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]}]}]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Multiple products"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If a traveller is booking multiple products, ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/open-api/demand-api/orders/orders/preview"},"children":["/orders/preview"]}," returns only information that is valid for every item in the order."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/genius-bulb.3e13976eeeabd0526f1d76bfb7de5967932211a5ef4afe526a3b0a71a7b02fb0.5e2a7131.png","alt":"genius-bulb"},"children":[]}," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Handling multiple payment timings"]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If the response includes more than one available payment timing (e.g. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pay_online_later"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pay_at_the_property"]},"), display both options to the traveller and allow them to choose."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Only one timing should be included in the /orders/create request."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-2---review-sample-preview-responses","__idx":7},"children":["Step 2 - Review sample preview responses"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can find all payment-related details in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["general_policies.payment"]}," field of the order/preview responses."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["method_required"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}," in preview response, you must include a supported payment method in the /orders/create request (e.g. VCC or credit card, depending on the flow)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If false, the booking does not require a method upfront—common for fully flexible rates and pay at the property timings."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example---pay-online-now","__idx":8},"children":["Example - Pay online now"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A property that supports ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pay_online_now"]}," with a Virtual Credit Card (VCC) may return:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"accommodation\": {\n    \"general_policies\": {\n      \"payment\": {\n        \"pay_online_now\": {\n          \"method_required\": true,\n          \"dates\": [\n            {\n              \"at\": \"2026-11-18\",\n              \"price\": {\n                \"accommodation_currency\": 200.64,\n                \"booker_currency\": 200.64\n              }\n            },\n            {\n              \"at\": \"2026-12-10\",\n              \"price\": {\n                \"accommodation_currency\": 5.14,\n                \"booker_currency\": 5.14\n              }\n            }\n          ],\n          \"methods\": {\n            \"cards\": [1, 2, 3, 4, ...]\n          }\n        }\n      }\n    }\n  }\n}\n\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["What this means:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["method_required:true"]}," - Payment method must be provided."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Dates"]}," - Include a schedule of instalments."]}]},{"$$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":"Schedule"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"style":{"width":"250x"}},"children":["Schedule"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Date ( at )"},"children":["Date (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["at"]},")"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Amount ( price )"},"children":["Amount (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["price"]},")"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Booking date"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2026-11-18"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["200.64 – main booking charge without extra charges (if any)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Check-in date"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2025-01-10"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["5.14 – additional charges collected on-site."]}]}]}]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["methods.cards"]}," - Contains the IDs of accepted payment cards that can be used to pay for or secure a booking (in this case, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1"]},",",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["2"]},",",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["3"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["4"]},").",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You must be able to generate/obtain a VCC for one of these cards."]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/payments/models/partner-collects#2-create-your-order-using-virtual-credit-card-vcc"},"children":["Pay online using VCC use case"]}," for implementation examples."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example---pay-online-later","__idx":9},"children":["Example - Pay online later"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In this example, for the selected property and product, when using ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pay_online_later"]}," and VCC as payment method, the /orders/preview response may include:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"accommodation\": {\n    \"general_policies\": {\n      \"payment\": {\n        \"pay_online_later\": {\n          \"method_required\": true,\n          \"dates\": [\n            {\n              \"at\": \"2026-11-18\",\n              \"price\": {\n                \"accommodation_currency\": 0.00,\n                \"booker_currency\": 0.00\n              }\n            },\n            {\n              \"at\": \"2026-12-01\",\n              \"price\": {\n                \"accommodation_currency\": 200.64,\n                \"booker_currency\": 200.64\n              }\n            },\n            {\n              \"at\": \"2026-12-03\",\n              \"price\": {\n                \"accommodation_currency\": 5.14,\n                \"booker_currency\": 5.14\n              }\n            }\n          ],\n          \"methods\": {\n            \"cards\": [1, 2, 3, 4, ...]\n          }\n        }\n      }\n    }\n  }\n}\n\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["What this means:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["method_required:true"]}," - Payment method must be provided."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Dates"]}," - Contain three payment schedule instalments, showing when the total price of the booking must be paid."]}]},{"$$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":"Schedule"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"style":{"width":"250x"}},"children":["Schedule"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Date ( at )"},"children":["Date (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["at"]},")"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Amount ( price )"},"children":["Amount (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["price"]},")"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Booking date"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2026-11-18."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0.00 – no prepayment required"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payment date"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2026-12-01 - This date will be either when free cancellation period has expired, or 48 hours before the checkin date."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The amount to be charged to the provided payment method. In this case ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["200.64"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Check-in date"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2026-12-03"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["5.14 – extra charges due at check-in."]}]}]}]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["methods.cards"]}," - Contains the IDs of accepted payment cards that can be used to pay for or secure a booking (in this case, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1"]},",",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["2"]},",",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["3"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["4"]},")."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example---pay-at-the-property","__idx":10},"children":["Example - Pay at the property"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"without-prepayment","__idx":11},"children":["Without prepayment"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In this example, for the selected property and product, for a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pay_at_the_property"]}," payment timing without a prepayment policy, the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/open-api/demand-api/orders/orders/preview"},"children":["/orders/preview"]}," response would return something similar to:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"pay_at_the_property\": {\n    \"dates\": [\n      {\n        \"at\": \"2026-11-01\",\n        \"price\": {\n          \"accommodation_currency\": 0,\n          \"booker_currency\": null\n        }\n      },\n      {\n        \"at\": \"2026-11-18\",\n        \"price\": {\n          \"accommodation_currency\": 177.65,\n          \"booker_currency\": null\n        }\n      }\n    ],\n    \"method_required\": true,\n    \"methods\": {\n      \"cash\": true,\n      \"cards\": [\n        1,\n        2\n      ]\n    }\n  }\n}\n\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Dates"]}," - Contain two payment schedule items, showing wwhen the instalment is scheduled and the amount:"]}]},{"$$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":"Schedule"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"style":{"width":"250x"}},"children":["Schedule"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Date ( at )"},"children":["Date (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["at"]},")"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Amount ( price )"},"children":["Amount (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["price"]},")"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Booking date"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2026-11-18"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0.00 – no prepayment is required before the checkin date."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Check-in date"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2026-11-18"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["177.65 – full payment at check-in."]}]}]}]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cash"]}," - Cash is accepted but it also offers a list of accepted ID cards (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1"]},"and",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["2"]},") that the traveller must use to secure their booking (as the payment will be made at checkin date)."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"with-prepayment","__idx":12},"children":["With prepayment"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Some pay-at-property bookings include prepayment:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"general_policies\": {\n    \"payment\": {\n      \"pay_at_the_property\": {\n        \"method_required\": true,\n        \"dates\": [\n          {\n            \"at\": \"2026-11-01\",\n            \"price\": {\n              \"accommodation_currency\": 0.00,\n              \"booker_currency\": 0.00\n            }\n          },\n          {\n            \"at\": \"2026-11-18\",\n            \"price\": {\n              \"accommodation_currency\": 439.85,\n              \"booker_currency\": 57.27\n            }\n          },\n          {\n            \"at\": \"2026-11-18\",\n            \"price\": {\n              \"accommodation_currency\": 585.88,\n              \"booker_currency\": 76.29\n            }\n          }\n        ]\n      }\n    }\n  }\n}\n\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/open-api/demand-api/commonpayments/common/payments/cards"},"children":["common/payments/cards"]}," endpoint to match card IDs to card types."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/payments/payments-timings/#payment-schedules"},"children":["schedules"]}," for more information."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"car-rental","__idx":13},"children":["Car rental"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can find all payment-related details in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["policies.payment"]}," field of the order/preview responses."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"example---pay-online-now-1","__idx":14},"children":["Example - Pay online now"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"request_id\": \"01fr9ez700exycb98w90w5r9sh\",\n  \"data\": {\n    \"car\": {\n      \"offer\": 123456789,\n      \"currency\": { … },\n      \"price\": { … },\n      \"policies\": {\n        \"cancellation\": { … },\n        \"damage_excess\": { … },\n        \"deposit\": { … },\n        \"fuel_policy\": \"return_same\",\n        \"mileage\": { … },\n        \"payment\": {\n          \"dates\": [\n            {\n              \"at\": \"2025-11-01\",\n              \"amount\": {\n                \"display\": {\n                  \"value\": 129.99,\n                  \"currency\": \"EUR\",\n                  \"timing\": \"pay_online_now\"\n                },\n                \"pay\": {\n                  \"value\": 129.99,\n                  \"currency\": \"EUR\",\n                  \"timing\": \"pay_online_now\"\n                }\n              }\n            }\n          ]\n        },\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-3---create-the-order","__idx":15},"children":["Step 3 - Create the order"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After previewing payment details and confirming the traveller's choice, create the booking using the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/open-api/demand-api/orders/orders/create"},"children":["/orders/create endpoint"]},"."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Make sure your request matches the timing and method selected in the preview."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Follow the relevant use case for your payment flow."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Go to the payment use case that matches your scenario."]},{"$$mdtype":"Tag","name":"Cards","attributes":{"cards":[{"title":"You can charge travellers","icon":null,"link":"/demand/docs/payments/models/partner-collects","withArrow":true},{"title":"You cannot charge travellers directly","icon":null,"link":"/demand/docs/payments/payments-booking-collects","withArrow":true},{"title":"You are a Corporate partner","icon":null,"link":"/demand/docs/payments/models/corporate","withArrow":true},{"title":"Your traveller pays at property","icon":null,"link":"/demand/docs/payments/payments-pay-at-property","withArrow":true}]},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"testing-your-integration","__idx":16},"children":["Testing your integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["We recommend testing all payment flows before going live."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/getting-started/sandbox"},"children":["sandbox environment"]}," and any of the provided test properties."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When testing online payments with cards:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["real credit card with enough funds"]}," to avoid errors."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Include real credit card details in your request."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Payment will be charged to the provided card."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Booking.com automatically refunds the payment the following Monday after testing."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"troubleshooting-common-issues","__idx":17},"children":["Troubleshooting common issues"]},{"$$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":"Issue"},"children":["Issue"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Cause"},"children":["Cause"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Recommendation"},"children":["Recommendation"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400 – missing payment method"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["method_required"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]},", but no method provided."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Use a supported VCC or card in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/orders/create"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Unexpected timing"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Preview returns multiple payment options."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Choose one and match it in your order."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Card ID mismatch"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Provided card ID not supported."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Use IDs returned in the preview response."]}]}]}]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Refer to the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/support/error-handling/payment-errors"},"children":["Payment errors section"]}," for more examples"]}]},{"$$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":["For more tips and examples on how to preview and create an order, check the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/orders-api/order-preview-create"},"children":["Orders section"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Learn about all the available ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/payments/payments-methods"},"children":["payment methods"]}," and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/payments/payments-timings"},"children":["timings"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You can also explore the different ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/payments/models/accommodation-payment-models"},"children":["payment models"]}," for instructions, examples and best practices for payments."]}]}]}]},"headings":[{"value":"Accommodation payments quick guide","id":"accommodation-payments-quick-guide","depth":1},{"value":"Payment overview","id":"payment-overview","depth":2},{"value":"Do I need Payments?","id":"do-i-need-payments","depth":2},{"value":"Step 1 - Check available payment options","id":"step-1---check-available-payment-options","depth":2},{"value":"Search and look","id":"search-and-look","depth":3},{"value":"Filter by payment timing","id":"filter-by-payment-timing","depth":4},{"value":"Book and pay","id":"book-and-pay","depth":3},{"value":"Step 2 - Review sample preview responses","id":"step-2---review-sample-preview-responses","depth":2},{"value":"Example - Pay online now","id":"example---pay-online-now","depth":3},{"value":"Example - Pay online later","id":"example---pay-online-later","depth":3},{"value":"Example - Pay at the property","id":"example---pay-at-the-property","depth":3},{"value":"Without prepayment","id":"without-prepayment","depth":4},{"value":"With prepayment","id":"with-prepayment","depth":4},{"value":"Car rental","id":"car-rental","depth":3},{"value":"Example - Pay online now","id":"example---pay-online-now-1","depth":4},{"value":"Step 3 - Create the order","id":"step-3---create-the-order","depth":2},{"value":"Testing your integration","id":"testing-your-integration","depth":2},{"value":"Troubleshooting common issues","id":"troubleshooting-common-issues","depth":2}],"frontmatter":{"cards":{"productsAndFeatures":[{"title":"You can charge travellers","icon":null,"link":"/demand/docs/payments/models/partner-collects","withArrow":true},{"title":"You cannot charge travellers directly","icon":null,"link":"/demand/docs/payments/payments-booking-collects","withArrow":true},{"title":"You are a Corporate partner","icon":null,"link":"/demand/docs/payments/models/corporate","withArrow":true},{"title":"Your traveller pays 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":"Accommodation payments quick guide"}},"lastModified":"2026-05-21T13:51:29.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/demand/docs/payments/how-to-accommodation-payments","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}