{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Car modification charges","meta":[{"name":"robots","content":"noindex"}],"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":"car-modification-charges","__idx":0},"children":["Car modification charges"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When a traveler modifies an existing car booking (e.g., the pickup or drop-off location, or rental dates),"," ","the price of the booking may change."," ","The ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/openapi/carapi"},"children":["Car APIs"]}," display these price differences as structured rate components on the"," ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/openapi/carapi/car/carpricecheck"},"children":["price check"]}," API response,"," ","while vendor-imposed change fees may appear as free-text descriptions in the same API."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When modifying a car booking, if the new price is cheaper than the existing booking, a refund may also be applicable based on the vendor's policies."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This guide explains how to identify modification charges in the API response and how to interpret them."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"rate-difference-components","__idx":1},"children":["Rate difference components"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/openapi/carapi/car/carpricecheck"},"children":["check car price"]}," endpoint returns the rate breakdown for the selected car"," ","in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rateInfo"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["finalRateInfo"]}," fields."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The two fields capture the rate at different points in the flow:"]},{"$$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":{"width":"25%","data-label":"Field"},"children":["Field "]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rateInfo"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The rate information you get after the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/openapi/carapi/car/carsearch"},"children":["car search"]}," API call (i.e., when the traveler searches for a car)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["finalRateInfo"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The supplier-confirmed rate when using the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/openapi/carapi/car/carpricecheck"},"children":["check car price"]}," endpoint. This is the final price the traveler will be charged.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"This is useful to identify if any price change has occurred since the original search was performed but before checkout occurs."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hasPriceChanged"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]},", compare the two rate breakdowns to identify what changed and display the difference to the traveler before they confirm."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When the request is part of a modification flow (i.e., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["isModify"]}," is set to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}," in the request body),"," ","two additional rate component types may appear in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["finalRateInfo.carRateComponents"]},":"]},{"$$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":{"width":"40%","data-label":"Field"},"children":["Field "]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CAR_MODIFY_RATE_DIFFERENCE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The total price difference between the original booking and the modified one. A positive amount indicates that the traveler will pay more for the new booking, while a negative amount indicates a credit or reduced charge."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CAR_MODIFY_AVERAGE_RATE_DIFFERENCE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The average daily rate difference between the original booking and the modified one. Useful when the rental duration spans multiple days and the daily cost has changed."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each component in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carRateComponents"]}," contains a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["componentType"]}," and an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["amount"]}," object (with the numeric ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["amount"]}," value and a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["currencyCode"]},")."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Here's a sample response excerpt from the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/openapi/carapi/car/carpricecheck"},"children":["check car price"]}," endpoint"," ","when ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["isModify"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}," and the modified booking is more expensive than the original:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","data-title":"POST /v2/car/price-check","header":{"title":"POST /v2/car/price-check","controls":{"copy":{}}},"source":"// ... payload truncated for focus\n{\n  \"hasPriceChanged\": true,\n  \"finalRateInfo\": {\n    \"carRateComponents\": [\n      {\n        \"componentType\": \"BASE_RATE_TOTAL\",\n        \"amount\": {\n          \"amount\": 320.00,\n          \"currencyCode\": \"USD\"\n        }\n      },\n      {\n        \"componentType\": \"TOTAL_TAX\",\n        \"amount\": {\n          \"amount\": 48.00,\n          \"currencyCode\": \"USD\"\n        }\n      },\n      {\n        \"componentType\": \"CAR_MODIFY_RATE_DIFFERENCE\",\n        \"amount\": {\n          \"amount\": 75.00,\n          \"currencyCode\": \"USD\"\n        }\n      },\n      {\n        \"componentType\": \"CAR_MODIFY_AVERAGE_RATE_DIFFERENCE\",\n        \"amount\": {\n          \"amount\": 15.00,\n          \"currencyCode\": \"USD\"\n        }\n      }\n    ]\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the example above, the modified booking costs ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["USD 75 more"]}," in total than the original, with an average daily increase of ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["USD 15"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"calculating-the-total-modification-cost","__idx":2},"children":["Calculating the total modification cost"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the following parameters in the APIs to identify the total booking modification cost:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/openapi/carapi/car/carpricecheck"},"children":["check car price"]}," API response, locate the entry in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carRateComponents"]}," with the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["componentType"]}," set to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CAR_MODIFY_RATE_DIFFERENCE"]},". The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["amount"]}," displayed here is the change in the rental price."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Review the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["finalRateInfo"]}," > ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["additionalDetails"]}," array for entries with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carAdditionalDetailType"]}," set as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FEES_INFORMATION"]},". Display the text field value to the traveler as a supplementary fee notice."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The total amount the traveler will be charged is displayed in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["finalRateInfo"]}," > ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carRateComponents"]}," > ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["amount"]}," with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["componentType"]}," set to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BASE_RATE_TOTAL"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TOTAL_TAX"]},"."]}]}]},"headings":[{"value":"Car modification charges","id":"car-modification-charges","depth":1},{"value":"Rate difference components","id":"rate-difference-components","depth":2},{"value":"Calculating the total modification cost","id":"calculating-the-total-modification-cost","depth":2}],"frontmatter":{"seo":{"title":"Car modification charges"}},"lastModified":"2026-06-01T12:56:22.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/car_guides/car_modification_guide","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}