Developer Hub
此為系統自動產生的翻譯

保險

整合捆綁式保險方案

此功能讓您能夠為旅客提供與租車費率捆綁的保險。此捆綁方案隨後可作為一種費率類型顯示在搜尋結果頁面上。

Information

重要事項

目前，「捆綁式保險」僅支援德國 (DE) 的銷售據點。

保險保障範圍

「可用性」回應中的每輛車的結果都可能包含一個 ``insurance_coverage 物件。有關該車輛的所有保險資訊，無論是租車時已包含且無需額外付費，還是可另行加購的，均歸類於此項目之下。請參閱下方以了解其中包含的欄位。

欄位說明
included該供應商所提供之保險產品一覽表。每個產品都包含與補充產品相同的欄位。
supplemental本車款提供一系列可選購的保險產品。

包含

碰撞損害豁免 (CDW)

included.collision_damage_waiver物件包含以下欄位：

欄位說明範例
description該保障範圍的簡稱。碰撞損害豁免
deductible在發生承保事故時，保險適用前，旅行者須自行承擔的金額。
trip_rate這是一項已計入報價總額中的費用，僅供參考。

補充說明

supplemental系列中的選用保險產品包含以下欄位：

欄位說明範例
provider保險公司的名稱。汽車保險供應商
description該保障範圍的簡稱。全面保障
benefits.refundable_deductible若適用，請說明在提出理賠時，可退還的自付額部分 (貨幣、金額、百分比)。
benefits.additional_protection保險保障範圍內包含一系列額外的保障措施。擋風玻璃
trip_rate整筆預訂的保險總金額 (非每日金額)。
cancel_penalties該保險產品所適用的解約罰金。除了車輛本身的項目外，請一併檢查以下項目cancel_penalties。
links.details捆綁式汽車與保險產品詳情頁面的網址。

保險套裝方案

供應情況

若要檢視 insurance-bundled 的優惠資訊，請使用以下查詢參數：

欄位說明
include=insurance_bundle在結果中回傳insurance_coverage。若未提供此資訊，捆綁式保險方案將不會出現在「可用性」回應中。
filter=insurance_bundle將搜尋結果限定為僅顯示提供保險組合方案的車輛。搭配include=insurance_bundle 使用，僅顯示捆綁式的搜尋結果。

請注意：

  • 捆綁式保險的費用並未納入「rate.pricing」物件中 (該物件出現在「Availability」回應中)，因為在預訂時，API 尚無法確定是否會將保險 (或具體的哪種保障方案) 捆綁於車輛報價中。
  • 由於 API 此時已知該意圖是建立組合方案，因此「詳細資訊」回應中的「rate.pricing.totals.insurance」欄位將顯示產品詳細資訊頁面上該組合保險的總費用。
  • 目前提供兩種保險產品：全面保障與額外保障。我們將根據租車費率及所包含的保障範圍，為您提供合適的保險產品。

可用性回應範例

[
  {
    ...
    "insurance_coverage": {
      "included": {
        "collision_damage_waiver": {
          "description": "Collision Damage Waiver",
          "deductible": {
            "billable_currency": {
              "value": "1500.00",
              "currency": "USD"
            },
            "request_currency": {
              "value": "1500.00",
              "currency": "USD"
            }
          }
        }
      },
      "supplemental": [
        {
          "provider": "[vendor name]",
          "description": "Full Protection",
          "benefits": {
            "refundable_deductible": {
              "currency": "USD",
              "amount": "1500.00",
              "percent": "100%"
            }
          },
          "trip_rate": {
            "billable_currency": {
              "value": "100.00",
              "currency": "USD"
            },
            "request_currency": {
              "value": "100.00",
              "currency": "USD"
            }
          },
          "cancel_penalties": [
            {
              "end": "2018-02-12T11:59:00",
              "currency": "USD",
              "amount": "100.00"
            }
          ],
          "links": {
            "details": {
              "method": "GET",
              "href": "https://test.ean.com/v2/cars/1234/details?token=MY5S3j36cOcLfLBZjPYQ1abhfc8CqmjmFVzkk7euvWaunE57LLeDgaxm516m"
            }
          }
        }
      ]
    },
    ...
    "cancel_penalties": [
      {
        "currency": "USD",
        "start": "2018-02-12T11:59:00",
        "end": "2018-02-12T11:59:00",
        "amount": "50.00"
      }
    ],
    "links": {
      "details": {
        "method": "GET",
        "href": "https://test.ean.com/v2/cars/1234/details?token=MY5S3j36cOcLfLBZjPYQ1abhfc8CqmjmFVzkk7euvWaunE57LLeDgaxm516m"
      }
    }
  }
]

詳情

終點： GET /v2/cars/{car_rental_id}/details

捆綁式保險的「詳細資訊」連結，可在補充資料links.details 中，InsuranceProduct 下的「可用性」結果中找到。請致電查詢完整價格、相關政策及預訂連結。

此處介紹的 ``insurance_coverage 物件，其結構與《可用性》一書中的描述相同。在進行結帳前，請以此作為權威版本。

注意： 此處所列的價格及政策詳情，優先於「可用性」回覆中的內容。

補充保障

請參閱下方，了解 insurance_coverage.supplemental 所包含的欄位。

欄位說明範例
provider保險公司的名稱。汽車保險供應商
description該保障範圍的簡稱。全面保障
benefits.refundable_deductible若適用，請說明在提出理賠時，可獲退還的自付額部分 (貨幣、金額、百分比)。
benefits.content一組{ title, description } 物件，用於向旅客顯示保險給付詳情。
benefits.additional_protection保險保障範圍內包含一系列額外的保障措施。擋風玻璃
disclaimer旅客在結帳時加購保險前必須同意的條款。請在預訂前顯示此內容並取得客戶同意。
trip_rate整筆預訂的保險總金額 (非按天計算)。
cancel_penalties該保險產品所適用的取消罰則。除了車輛本身的cancel_penalties 之外，請一併檢查這些項目。
links.terms_and_conditions保險條款與細則的網址。
links.product_information 保險產品資訊文件 (IPID) 的網址。

與保險相關的其他欄位

欄位說明
rate.pricing.totals.insurance捆綁費率的總保險費用。

詳細回應範例

{
  ...
  "insurance_coverage": {
    "included": {
      "collision_damage_waiver": {
        "description": "Collision Damage Waiver",
        "deductible": {
          "billable_currency": {
            "value": "1500.00",
            "currency": "USD"
          },
          "request_currency": {
            "value": "1500.00",
            "currency": "USD"
          }
        }
      }
    },
    "supplemental": [
      {
        "provider": "[vendor name]",
        "description": "Full Protection",
        "benefits": {
          "refundable_deductible": {
            "currency": "USD",
            "amount": "1500.00",
            "percent": "100%"
          },
          "content": [
            {
              "title": "Zero excess if the vehicle is damaged or stolen",
              "description": "Full Protection covers the full excess amount so you won’t have to pay if something goes wrong."
            },
            {
              "title": "Damages commonly excluded by rental companies",
              "description": "Includes windows, windscreens, tyres, wheels, mirrors/glass, roof, underbody, hitting an animal and more"
            },
            {
              "title": "Roadside assistance and repair costs",
              "description": "Includes towing, key loss & replacement and vehicle lockout"
            },
            {
              "title": "Free cancellation at anytime before pick-up"
            }
          ]
        },
        "disclaimer": "By adding protection you confirm you have read and agree to the Policy Terms and Insurance Product Information Document. By selecting this insurance you confirm you are a resident of Germany, and you are over 18 years old.",
        "trip_rate": {
          "billable_currency": {
            "value": "100.00",
            "currency": "USD"
          },
          "request_currency": {
            "value": "100.00",
            "currency": "USD"
          }
        },
        "cancel_penalties": [
          {
            "end": "2018-02-12T11:59:00",
            "currency": "USD",
            "amount": "100.00"
          }
        ],
        "links": {
          "terms_and_conditions": {
            "method": "GET",
            "href": "https://www.rentalcover.com/policy-wording/collinsoneu-fp-ob"
          },
          "product_information": {
            "method": "GET",
            "href": "https://static.xcover.com/media/pds/7fd53012-812d-4316-bb72-95f46534da7e/Expedia_RC-FP-DE.pdf"
          }
        }
      }
    ]
  },
  ...
  "rate": {
    ...
    "pricing": {
      ...
      "totals": {
        ...
        "insurance": {
          "request_currency": {
            "value": "100.00",
            "currency": "USD"
          }
        },
        ...
      }
    }
  },
  ...
  "cancel_penalties": [
    {
      "currency": "USD",
      "start": "2018-02-12T11:59:00",
      "end": "2018-02-12T11:59:00",
      "amount": "50.00"
    }
  ],
  "links": {
    "payment": {
      "method": "POST",
      "href": "https://pay-test.ean.com/v1/payments?token=K~IjZ45n9y8TKnmQeJ2jQKZxJcYDFCOjkqIl6wLmcyVQlZBVUKLZctxg=="
    },
    "book": {
      "method": "POST",
      "href": "https://test.ean.com/v2/itineraries/car?token=MY5S3j36cOcLfLBZjPYQ1abhfc8CqmjmFVzkk7euvWaunE57LLeDgaxm516m"
    }
  }
}

付款登記

終點： POST /v2/payments?token=<TOKEN>

「付款註冊」連結位於回應正文中「links.payment」下的「詳細資訊」回應中。請致電登記付款方式，並取得預訂專用代碼 (payment_token)。

預訂

終點： POST /v2/itineraries/car

請使用「詳細資訊」回覆中的書籍連結。該連結中的標記承載了所有會話狀態，包括捆綁式保險。

有關保險的其他請求正文欄位，請參閱下方。

欄位說明
primary_driver.country_of_residence駕駛人主要居住地的 2 字元 ISO 3166-1 alpha-2 國家代碼。當預訂包含保險保障時，此欄位為必填欄位。
primary_driver.state_province_code駕駛人主要居住地的 2 字元州／省代碼或 3 字元行政區代碼，須以 ISO 3166-1 alpha-2 或 ISO 3166-1 alpha-3 格式提供。預訂附有保險的車輛時，此欄位為必填項目。

預訂成功時，會傳回 HTTP 201 狀態碼，內容如下：

  • itinerary_id - 永久預訂編號。
  • links.retrieve - 請使用此連結查詢預訂詳情。

擷取

終點： GET /itineraries/{itinerary_id}/car

請使用預訂回覆中的檢索連結，或透過affiliate_reference_id 進行查詢 GET /itineraries/car?affiliate_reference_id=.....

預訂完成後，行程表可能需要稍等片刻才會顯示。若您在預訂完成後立即收到錯誤訊息，請稍等幾分鐘後再試一次。

該回應 (RetrieveResponse) 包含但不限於以下內容：

欄位說明範例
itinerary_id該預訂的行程編號。
status目前的預訂狀態。BOOKED
confirmation_id供應商確認編號。
car_details完整的 CarDetails` ` 物件，包含 insurance_coverage、rate、policies以及rules_and_restrictions``。
primary_driver預訂時所提供的駕駛員資料。
affiliate_reference_id預訂時提交的聯盟夥伴推薦編號。
affiliate_metadata於預訂時提交的元資料。
creation_time以 ISO 8601 格式表示的預訂建立時間戳記。
links.cancelDELETE 點擊此連結以取消預訂。
policy_id保險預訂參考編號12345C4R1NS

Retrieve 回應中的「car_details.insurance_coverage」反映了已預訂的保險。有關退款與取消條款，請參閱insurance_coverage.supplemental[].cancel_penalties 以及 car-level cancel_penalties。

注意： policy_id 會在預訂完成後以非同步方式產生，因此在執行檢索呼叫時，該物件可能不會立即顯示。隨後，policy_id 可能會在後續的呼叫中出現。

擷取回應範例

...
      "supplemental": [
        {
          "policy_id": "12345C4R1NS",
          "provider": "Cover Genius",
          "description": "Full Protection",
          "benefits": {
            "additional_protection": [
              "windshield",
              "windows",
              "mirrors",
              "wheels",
              "tires"
            ],
            "refundable_deductible": {
              "currency": "USD",
              "amount": "1500.00",
              "percent": "100%"
            },
            "content": [
              {
                "title": "Zero excess if the vehicle is damaged or stolen",
                "description": "Full Protection covers the full excess amount so you won’t have to pay if something goes wrong."
              },
              {
                "title": "Damages commonly excluded by rental companies",
                "description": "Includes windows, windscreens, tyres, wheels, mirrors/glass, roof, underbody, hitting an animal and more"
              },
              {
                "title": "Roadside assistance and repair costs",
                "description": "Includes towing, key loss & replacement and vehicle lockout"
              },
              {
                "title": "Free cancellation at anytime before pick-up"
              }
            ]
          },
          "disclaimer": "By adding protection you confirm you have read and agree to the Policy Terms and Insurance Product Information Document. By selecting this insurance you confirm you are a resident of Germany, and you are over 18 years old.",
          "trip_rate": {
            "billable_currency": {
              "value": "100.00",
              "currency": "USD"
            },
            "request_currency": {
              "value": "100.00",
              "currency": "USD"
            }
          },
          "cancel_penalties": [
            {
              "end": "2018-02-12T11:59:00",
              "currency": "USD",
              "amount": "100.00"
            }
          ],
          "links": {
            "terms_and_conditions": {
              "method": "GET",
              "href": "https://www.rentalcover.com/policy-wording/collinsoneu-fp-ob"
            },
            "product_information": {
              "method": "GET",
              "href": "https://static.xcover.com/media/pds/7fd53012-812d-4316-bb72-95f46534da7e/Expedia_RC-FP-DE.pdf"
            }
          }
        }
      ]
      ...

取消

終點： DELETE /itineraries/{itinerary_id}/car

請使用「檢索」回應中的取消連結，以取消該套裝車租與保險預訂。

注意： 在捆綁式保險預訂情境中，補充保險產品無法單獨取消。唯一的選擇是取消整個套裝方案，此舉將受制於車輛本身的《cancel_penalties》以及補充保險的規定。將採用「cancel_penalties」這兩個陣列中最嚴格的組合，來判定是否符合註銷資格。

API 詳細資料

請瀏覽本頁面的預訂管理端點定義，接著使用 API Explorer 或其他測試軟體，藉此了解範例與架構定義與實際輸出結果之間的差異。

其他資源

無論您是想試用 Rapid Car API 的所有端點，還是想下載其 OpenAPI 規格文件，我們都能滿足您的需求。





這個頁面對您有幫助嗎？
我們能如何改善內容？
感謝您協助我們進行改善！

隱私權聲明Cookie 聲明使用條款

Expedia, Inc. 對外部網站的內容概不負責。
© 2026 Expedia, Inc.，Expedia Group 旗下公司。著作權所有，並保留一切權利。Expedia 智遊網和飛機標誌為 Expedia, Inc. 的商標或註冊商標。CST# 2029030-50。