Insurance

묶음 보험 상품 통합

이 기능을 통해 여행객에게 렌터카 요금에 포함된 보험 상품을 제공할 수 있습니다. 이렇게 하면 번들 상품이 검색 결과 페이지에 요금 유형으로 표시될 수 있습니다.

중요

현재 번들 보험은 독일(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`	자동차 및 보험 상품 패키지 상세 정보 페이지의 URL.

보험 패키지

예약 가능 객실

insurance-bundled 의 제안을 확인하려면 다음 쿼리 매개변수를 사용하십시오:

필드	설명
`include=insurance_bundle`	결과로 insurance_coverage 를 반환합니다. 이 정보가 없으면, 번들 보험 상품은 ‘가용성’ 응답에서 제외됩니다.
`filter=insurance_bundle`	보험 묶음 상품이 제공되는 차량으로만 검색 결과를 제한합니다. `include=insurance_bundle`와 함께 사용하면 번들된 결과만 표시됩니다.

참고:

예약 가능 여부 응답의 ‘ rate.pricing ’ 객체에는 번들 보험 비용이 반영되지 않습니다. 이는 예약 시점에 해당 차량 제안에 보험(또는 어떤 보장 플랜)이 포함될지 API가 아직 알 수 없기 때문입니다.
'Details' 응답에 포함된 차량의 ' 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

번들 보험에 대한 ‘상세 정보(Details)’ 링크는 보충 자료인 ‘보험 상품 정보( links.details)’의 ‘보장 범위( InsuranceProduct)’ 항목 하단에 있는 ‘이용 가능 여부(Availability)’ 결과에서 확인할 수 있습니다. 자세한 가격 정보, 이용 약관 및 예약 링크를 확인하려면 전화해 주세요.

여기에 소개된 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`	보험 약관의 URL.
`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 ’ 항목 아래에 있는 ‘Details’ 응답에 포함되어 있습니다. 이 번호로 전화하여 결제 수단을 등록하고, 예약용 payment_token 를 받으세요.

예약

종점: POST /v2/itineraries/car

‘상세 정보’ 응답에 포함된 책 링크를 이용하세요. 해당 링크에 있는 토큰에는 번들 보험을 포함한 모든 세션 상태가 담겨 있습니다.

보험과 관련된 추가 요청 본문 필드는 아래를 참조하십시오.

필드	설명
`primary_driver.country_of_residence`	운전자의 주 거주지에 해당하는 2글자 ISO 3166-1 알파-2 국가 코드. 예약에 보험 적용이 포함된 경우, 이 항목은 필수 입력 항목입니다.
`primary_driver.state_province_code`	운전자의 주 거주지에 해당하는 2자 주/도 코드 또는 3자 하위 행정구역 코드를 ISO 3166-1 알파-2 또는 ISO 3166-1 알파-3 형식으로 기재해야 합니다. 보험이 포함된 차량을 예약할 때는 이 항목을 반드시 입력해야 합니다.

예약이 성공하면 다음과 같은 내용이 포함된 HTTP 201 응답이 반환됩니다:

itinerary_id - 영구 예약 번호.
links.retrieve - 이 링크를 통해 예약 내역을 조회하세요.

검색

종점: GET /itineraries/{itinerary_id}/car

예약 응답에 포함된 조회 링크를 사용하거나, affiliate_reference_id 을 통해 조회하십시오. GET /itineraries/car?affiliate_reference_id=.....

예약 후 일정를 조회할 수 있게 되기 전까지 잠시 지연될 수 있습니다. 예약 직후 오류 메시지가 표시되면, 몇 분 정도 기다린 후 다시 시도해 주세요.

해당 응답(RetrieveResponse)에는 다음 내용이 포함되나, 이에 국한되지는 않습니다:

필드	설명	예
`itinerary_id`	예약의 일정 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.cancel`	`DELETE` 예약을 취소하려면 이 링크를 클릭하세요.
`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 사양서를 다운로드하시든, 여러분이 필요로 하는 모든 것을 저희가 제공합니다.