Developer Hub
这是自动生成的译文

Insurance

整合捆绑式保险产品

此功能允许您将旅行者保险与租车价格捆绑销售。然后，可以将捆绑优惠作为价格类型显示在搜索结果页面上。

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 结合使用，仅显示捆绑结果。

注意：

  • 由于 API 在预订时还不知道汽车报价是否会包含保险（或哪种保险计划），因此捆绑保险的费用并未计入可用性响应中的 rate.pricing 对象。
  • 详细信息响应中的汽车 rate.pricing.totals.insurance 将反映产品详情页面上捆绑保险的总费用，因为 API 知道此时的意图是创建捆绑包。
  • 目前提供两种保险产品：全面保障和额外保障。我们将根据租车价格和包含的保险范围，提供相应的保险产品。

可用性响应示例

[
  {
    ...
    "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 对象与 Availability 中的结构相同。请在结账前以此版本为准。

**注意：**此处的价格和政策详情优先于可用性响应中的信息。

补充保险

请参阅下方 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）的 URL。

其他与保险相关的领域

字段说明
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

使用 Booking 响应中的检索链接，或按以下方式查找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预订时提交的联盟营销参考 ID。
affiliate_metadata预订时提交的元数据。
creation_time预订创建时间戳（ISO 8601 格式）。
links.cancelDELETE 取消预订的链接。
policy_id保险预订参考号12345C4R1NS

这car_details.insurance_coverage检索结果反映了已预订的保险。请参阅insurance_coverage.supplemental[].cancel_penalties以及 car-levelcancel_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。