{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-demand/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Payment schedules","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-schedules","__idx":0},"children":["Payment schedules"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Understand how payment schedules represent when and how much is charged for a booking, using data returned in /orders/preview for accommodation and car rental (v3.2)."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"in-this-guide","__idx":1},"children":["In this guide"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["What payment schedules are."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["How schedules are structured in /orders/preview."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Key fields and concepts (dates, pay, display)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Accommodation vs car rental differences."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Worked examples."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["UI and integration guidance."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-are-payment-schedules","__idx":2},"children":["What are payment schedules?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Payment schedules define the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["full breakdown of payments across a booking lifecycle"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A single order may involve multiple payment events, depending on:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Payment timing (see ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/demand/docs/payments/payments-timings"},"children":["Payment timings guide"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Supplier or property policies."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Taxes, deposits, and extra charges."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Payment method rules."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use payment schedules data to:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["✓ Show ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["exact payment breakdowns across time."]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ","✓ Separate ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["upfront vs later charges"]},".",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ","✓ Display ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["all booking-related costs transparently"]},".",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ","✓ Prevent unexpected charges at checkout or fulfilment."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"payment-schedule-structure-orderspreview","__idx":3},"children":["Payment schedule structure (orders/preview)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In /orders/preview, payment timing is expanded into a schedule of payment events, that ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["defines when and how much is charged."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"dates","__idx":4},"children":["Dates"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Each payment timing contains a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dates"]}," array."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Each item in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dates"]}," represents a single ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["payment event"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"payment-event-structure","__idx":5},"children":["Payment event structure"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Each event includes:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["at"]}," → when the payment occurs."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["price"]}," (accommodation) or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["amount"]}," (car) → how much is charged."]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"monetary-values","__idx":6},"children":["Monetary values"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each monetary value may include:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pay"]}," → the actual amount that will be charged."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["display"]}," → the amount shown to the traveller (may differ due to currency or rounding)."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"key-rules","__idx":7},"children":["Key rules"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A schedule may include multiple payment events."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The sum of all ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pay"]}," values represents the total collected via the API."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Some charges may be excluded due to legal or supplier constraints."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The sum of all payment events in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dates"]}," represents the total amount collected through the API."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Extra charges"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Some additional charges (for example, tourist taxes, deposits, etc) may not be included in this total and are paid at the property or pickup."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"payment-method-requirement","__idx":8},"children":["Payment method requirement"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["method_required"]}," field indicates whether a payment method must be provided at booking time."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}," → the traveller must provide a payment method (even if no charge is made at booking)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]}," → no payment method is required at booking."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"typical-use-cases","__idx":9},"children":["Typical use cases"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Guaranteeing bookings without upfront payment."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Deferred charging models."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Supplier-managed payments."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/demand/docs/payments/payments-methods"},"children":["payment methods"]}," section for more details."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"extra-charges","__idx":10},"children":["Extra charges"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Some charges are handled separately due to legal or supplier rules."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Examples include:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Tourist taxes (legal requirement)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Security deposits."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Damage excess."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Fuel or service fees."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["May not be included in upfront payment events."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["May appear as separate schedule entries."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["May be collected at property or pick-up."]}]},{"$$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/accommodations/prices-accommodations"},"children":["Accommodation pricing section"]}," for more details."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"key-difference-accommodation-vs-car","__idx":11},"children":["Key difference: accommodation vs car"]},{"$$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":"Aspect"},"children":["Aspect"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Accommodation"},"children":["Accommodation"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Car rental"},"children":["Car rental"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payment structure"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Grouped by timing object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Attached per price component"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Data location"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment.dates"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["price.*.pay/display.timing"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Evaluation model"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Schedule-level"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Field-level"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Complexity"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Policy-driven"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Component-driven"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"accommodation-schedules-in-orderspreview","__idx":12},"children":["Accommodation schedules in orders/preview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Accommodation schedules are returned in:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data.accommodation.general_policies.payment"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"pay-online-now---example","__idx":13},"children":["Pay online now - example"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the following orders/preview response taken as example, there are 2 events \"2025-01-18\" (booking date) and \"2025-02-10\" (checkin date) together with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["price"]}," to pay each date:"]},{"$$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\": \"2025-01-18\",\n             \"price\": {\n               \"accommodation_currency\": 200.64,\n               \"booker_currency\": 200.64\n             }\n           },\n           {\n             \"at\": \"2025-02-10\",\n             \"price\": {\n               \"accommodation_currency\": 5.14,\n               \"booker_currency\": 5.14\n             }\n           }\n         ]\n       }\n     }\n   }\n }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Interpretation:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Full amount is charged at booking."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Any other additional payments such as extra charges are collected at checkin."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"pay-online-later---example","__idx":14},"children":["Pay online later - example"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In this orders/preview response, there are 3 date events \"2025-01-18\" (booking date), \"2025-02-02\" (payment date) and \"2025-02-10\" (checkin date):"]},{"$$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\": \"2025-01-18\",\n              \"price\": {\n                \"accommodation_currency\": 0.00,\n                \"booker_currency\": 0.00\n              }\n            },\n            {\n              \"at\": \"2025-02-02\",\n              \"price\": {\n                \"accommodation_currency\": 200.64,\n                \"booker_currency\": 200.64\n              }\n            },\n            {\n              \"at\": \"2025-02-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","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Interpretation:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["At booking: no charge."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Before cancellation deadline: full amount is charged."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check-in: extra charges (if applicable)"]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Not supported for certain credit card types (see ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/demand/docs/payments/payments-timings#payment-timing-values"},"children":["payment timings details"]},")."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"pay-at-the-property---example","__idx":15},"children":["Pay at the property - example"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the following orders/preview response taken as example, there are 2 date items \"2026-11-18\" (booking date) and \"2026-12-01\" (checkin date):"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"accommodation\": {\n    \"general_policies\": {\n      \"payment\": {\n        \"pay_at_the_property\": {\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\": 205.78,\n                \"booker_currency\": 205.78\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":["Interpretation:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["At booking: no charge"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["At check-in: full amount is paid at the property."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"pay-at-the-property-with-prepayment","__idx":16},"children":["Pay at the property with prepayment"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["There are cases when the property sets a prepayment policy, scheduling an instalment between the booking and checkin date."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example:"]},{"$$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-18\",\n            \"price\": {\n              \"accommodation_currency\": 0.00,\n              \"booker_currency\": 0.00\n            }\n          },\n          {\n            \"at\": \"2026-11-30\",\n            \"price\": {\n              \"accommodation_currency\": 57.27,\n              \"booker_currency\": 57.27\n            }\n          },\n          {\n            \"at\": \"2026-12-01\",\n            \"price\": {\n              \"accommodation_currency\": 76.29,\n              \"booker_currency\": 76.29\n            }\n          }\n        ]\n      }\n    }\n  }\n}\n\n\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Interpretation:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["At booking: no charge."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Before arrival: partial prepayment."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["At check-in: remaining balance."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This flexible split is controlled by property policy."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"car-rental-payment-schedules-in-orderspreview","__idx":17},"children":["Car rental payment schedules in orders/preview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Car rental does not group payments into timing objects."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Instead, timing is defined at ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["field level"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Timing appears in:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["price.base"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["price.total"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["extra_charges"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["policies.payment.dates"]}," (deposit, excess, etc.)"]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Important"},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Each monetary field must be evaluated independently."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["There is no global schedule object for car rental payments."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"car-rental---pay_online_now-example","__idx":18},"children":["Car rental - pay_online_now example"]},{"$$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        \"booker\": \"EUR\",\n        \"payment\": \"EUR\"\n      },\n      \"price\": {\n        \"base\": {\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        \"extra_charges\": [\n          {\n            \"non_conditional\": [\n              {\n                \"charge_type\": \"one_way_fee\",\n                \"amount\": {\n                  \"display\": {\n                    \"value\": 15.0,\n                    \"currency\": \"EUR\"\n                  },\n                  \"pay\": {\n                    \"value\": 15.0,\n                    \"currency\": \"EUR\",\n                    \"timing\": \"pay_online_now\"\n                  }\n                }\n              }\n            ]\n          }\n        ],\n        \"total\": {\n          \"value\": 144.99,\n          \"currency\": \"EUR\",\n          \"timing\": \"pay_online_now\"\n        }\n      },\n      \"policies\": {\n        \"cancellation\": {\n          \"details\": {\n            \"context\": \"before_pickup\",\n            \"duration\": \"PT48H\"\n          },\n          \"type\": \"free_cancellation\"\n        },\n        \"damage_excess\": {\n          \"amount\": {\n            \"display\": {\n              \"value\": 1000.0,\n              \"currency\": \"EUR\",\n              \"timing\": \"pay_at_pickup\"\n            },\n            \"pay\": {\n              \"value\": 1000.0,\n              \"currency\": \"EUR\",\n              \"timing\": \"pay_at_pickup\"\n            }\n          }\n        },\n        \"deposit\": {\n          \"amount\": {\n            \"display\": {\n              \"value\": 200.0,\n              \"currency\": \"EUR\",\n              \"timing\": \"pay_at_pickup\"\n            },\n            \"pay\": {\n              \"value\": 200.0,\n              \"currency\": \"EUR\",\n              \"timing\": \"pay_at_pickup\"\n            }\n          }\n        },\n        \"fuel_policy\": \"return_same\",\n        \"mileage\": {\n          \"distance_limit\": 300.0,\n          \"distance_unit\": \"kilometers\",\n          \"type\": \"limited\"\n        },\n        \"payment\": {\n          \"dates\": [\n            {\n              \"at\": \"2026-04-20\",\n              \"amount\": {\n                \"display\": {\n                  \"value\": 169.99,\n                  \"currency\": \"EUR\",\n                  \"timing\": \"pay_online_now\"\n                },\n                \"pay\": {\n                  \"value\": 169.99,\n                  \"currency\": \"EUR\",\n                  \"timing\": \"pay_online_now\"\n                }\n              }\n            }\n          ]\n        }\n      },\n...\n\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-scenario---a-mixed-payment-order","__idx":19},"children":["Example scenario - A mixed payment order"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In many rentals, the total cost is split. In the example below, the rental price is paid online, but the damage excess are handled at the desk."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"price\": {\n    \"total\": {\n      \"value\": 129.99,\n      \"currency\": \"EUR\",\n      \"timing\": \"pay_online_now\" \n    }\n  },\n  \"policies\": {\n    \"damage_excess\": {\n      \"amount\": {\n        \"display\": {\n          \"value\": 300.00,\n          \"currency\": \"EUR\",\n          \"timing\": \"pay_at_pickup\"\n        },\n        \"pay\": {\n          \"value\": 300.00,\n          \"currency\": \"EUR\",\n          \"timing\": \"pay_at_pickup\"\n      }\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Interpretation:"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Immediate Payment (pay_online_now)"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["price.total"]}," shows €129.99."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Charged when booking online."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Since the timing is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pay_online_now"]},", the checkout UI should trigger a payment gateway (credit card, digital wallet, etc.) for this amount immediately."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Counter information (pay_at_pickup)"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Not charged online."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Traveller must provide a card at the rental desk."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["damage.excess"]}," shows €300.00."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The UI should inform the traveller that they need to have a credit card available at the rental desk for a pre-authorisation, but this amount is not charged during the online checkout."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Curious to know more?"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For additional information:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/demand/docs/payments/payments-display"},"children":["Displaying payments guide"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/demand/docs/payments/payments-methods"},"children":["Payment methods"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/demand/docs/payments/payments-timings"},"children":["Payment timings"]}]}]}]}]},"headings":[{"value":"Payment schedules","id":"payment-schedules","depth":1},{"value":"In this guide","id":"in-this-guide","depth":2},{"value":"What are payment schedules?","id":"what-are-payment-schedules","depth":2},{"value":"Payment schedule structure (orders/preview)","id":"payment-schedule-structure-orderspreview","depth":2},{"value":"Dates","id":"dates","depth":3},{"value":"Payment event structure","id":"payment-event-structure","depth":3},{"value":"Monetary values","id":"monetary-values","depth":3},{"value":"Key rules","id":"key-rules","depth":3},{"value":"Payment method requirement","id":"payment-method-requirement","depth":3},{"value":"Typical use cases","id":"typical-use-cases","depth":4},{"value":"Extra charges","id":"extra-charges","depth":3},{"value":"Key difference: accommodation vs car","id":"key-difference-accommodation-vs-car","depth":3},{"value":"Accommodation schedules in orders/preview","id":"accommodation-schedules-in-orderspreview","depth":2},{"value":"Pay online now - example","id":"pay-online-now---example","depth":3},{"value":"Pay online later - example","id":"pay-online-later---example","depth":3},{"value":"Pay at the property - example","id":"pay-at-the-property---example","depth":3},{"value":"Pay at the property with prepayment","id":"pay-at-the-property-with-prepayment","depth":4},{"value":"Car rental payment schedules in orders/preview","id":"car-rental-payment-schedules-in-orderspreview","depth":2},{"value":"Car rental - pay_online_now example","id":"car-rental---pay_online_now-example","depth":3},{"value":"Example scenario - A mixed payment order","id":"example-scenario---a-mixed-payment-order","depth":3}],"frontmatter":{"seo":{"title":"Payment schedules"}},"lastModified":"2026-04-24T13:27:30.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/demand/docs/payments/payments-schedules","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}