빠른 자동차 API: 출시 요구 사항

빠른 자동차 API 통합을 위한 요구 사항.

business-to-business (B2B) 또는 business-to-consumer (B2C) 구현의 무결성을 위해 Rapid Car API는 일부 페이지에 특정 정보를 포함하도록 요구합니다. 특정 요구 사항이 있는 페이지만 여기에 나열되어 있습니다.

검색 페이지

정확한 검색 매개변수 설정

SP1: 정확한 검색 매개변수 설정

pick-up 및 drop-off 위치와 대여 날짜와 시간을 캡처하는 필드를 추가한 다음 예약 가능 요청을 보냅니다. 매개변수를 통해 지역(반경 및 좌표), 공항(공항 지역 ID 포함) 또는 이 두 가지를 조합하여 검색할 수 있습니다.

샘플 검색

반경 및 좌표 기준

/v2/cars/availability?pickup_time=2026-02-12T10:00:00&dropoff_time=2026-02-14T18:00:00&pickup_area=10,33.9422,-118.4036&dropoff_area=10,33.9422,-118.4036&driver_age=30&country_code=US&currency=USD&language=en-US&limit=200&sort=total_price&sales_channel=website&sales_environment=car_only&filter=refundable&filter=vendor_collect

공항 지역 ID 기준

/v2/cars/availability?pickup_time=2026-02-12T10:00:00&dropoff_time=2026-02-14T18:00:00&pickup_airport=5783884&dropoff_airport=5783884&driver_age=30&country_code=US&currency=USD&language=en-US&limit=200&sort=recommended&sales_channel=website&sales_environment=car_only&filter=refundable&filter=expedia_collect

두 매개 변수 모두 사용

/v2/cars/availability?pickup_time=2026-02-12T10:00:00&dropoff_time=2026-02-14T18:00:00&pickup_area=10,33.9422,-118.4036&dropoff_airport=5456204&driver_age=30&country_code=US&currency=USD&language=en-US&limit=200&sort=total_price&sales_channel=website&sales_environment=car_only&filter=refundable&filter=vendor_collect

SP2: 운전자의 나이 파악하기

30세 미만 또는 70세 이상 운전자에게는 추가 의무 수수료가 부과될 수 있습니다. API가 예약 비용을 정확하게 계산하려면 검색 시 운전자의 나이를 입력해야 합니다. 이 범위 내의 드라이버에 대해 기본값을 40으로 설정합니다. 이 값은 driver_age매개변수에 반영됩니다.

"30세 미만 또는 70세 이상 운전자는 추가 요금을 지불해야 할 수 있습니다"

목록 페이지

강력한 검색 결과

목록 페이지는 검색 결과 페이지라고도 하는 옵션 모음입니다. 다음 요소가 표시되어야 합니다.

비교 차량 이미지와 함께 차량의 종류, 판매업체, 가격이 표시된 검색 결과

LP1: 정확한 렌탈 정보 제공

검색 결과 페이지라고도 하는 목록 페이지에는 API에서 반환되는 모든 자료 대여 정보(예: 다음과 같은 정보)가 표시되어야 합니다:

각 차량의 등급, 제조사 및 모델
최대 용량
전송 유형
연료 공급원: 가스, 하이브리드, 전기 등(캘리포니아 시장)
허용 마일리지
Pick-up 포인트 및 drop-off 포인트
렌탈 회사 이름 또는 로고

렌터카의 많은 속성은 acriss_code파라미터의 일부로 제공되며, ACRISS 테이블 의 값을 사용하여 디코딩할 수 있습니다. 예를 들어, JFBC의 값은 중간 엘리트(카테고리 J), 오토 4-wheel-drive (변속기 B) 및 전기 파워(연료/에어 컨디셔닝)를 갖춘 SUV(유형 F)를 나타냅니다. C).

"description": "Skoda Enyaq Electric car or similar",
        "number_of_passengers": 5,
        "number_of_doors": {
            "min": 5,
            "max": 5
        },
        "luggage_count": {
            "small": 3,
            "large": 3
        },
        "acriss_code": "JFBC",

LP2: 총 가격 및 결제 기한

선택한 대여 기간의 총 가격과 대여료를 선결제(지금 결제 또는 익스피디아 수금) 또는 카운터에서 결제(나중에 결제 또는 벤더 수금)해야 하는지 여부를 포함하세요.

참고: pick-up 및 drop-off 위치가 다른 예약( one-way 대여라고도 함)은 추가 양도 수수료가 부과되는 경우가 많습니다.

지금 결제/익스피디아 수집 예시

[
 {
   ...
   "rate": {
     "merchant_of_record": "expedia",
     "sale_scenario": {
       "package": false,
       "member": false,
       "mobile_promotion": false
     },
     "pricing": {
       "daily_rate_strikethrough": {...},
       "daily_rate": {...},
       "totals": {
         "inclusive_strikethrough": {...},
         "inclusive": {...},
         "exclusive": {...},
         "fees": {...}
       }
     }
   },
   ...
 }
]

나중에 결제 / 벤더 수금 예시

[
 {
   ...
   "rate": {
     "merchant_of_record": "vendor",
     "sale_scenario": {
       "package": false,
       "member": false,
       "mobile_promotion": false
     },
     "pricing": {
       "daily_rate": {...},
       "totals": {
         "inclusive": {...},
         "exclusive": {...},
         "fees": {...}
       }
     }
   },
   ...
 }
]

LP3: Non-refundable 플래그

요금이 non-refundable, 인 경우 제품 설명에 이를 명확하게 표시합니다.

참고: 응답에 cancel_penalties값이 없으면 무료 취소를 나타냅니다.

[ 
  ...
  {
    "cancel_penalties": [
      {
        "start": "2026-02-11T10:00:00",
        "end": "2026-02-12T10:00:00",
        "currency": "USD",
        "amount": "50.00"
      },
      {
        "start": "2026-02-12T10:00:00",
        "currency": "USD",
        "amount": "50.00"
      }
    ],
  }
  ...
]

LP4: 표준 보험 정보

추가 보험 옵션과 함께 기본 충돌 피해 보호에 대한 정보를 포함하세요.

{
  ...
  "policies": [
    ...
    {
      "name": "Basic Collision Damage Protection",
      "descriptions": [],
      "policy_statements": [
        {
          "statement": "Basic Collision Damage Protection",
          "statement_condition": "included"
        }
      ],
      "policy_type": "PRODUCT_USE_POLICY"
    },
    ...
  ],
  ...
}

제품 설명 페이지

차량 및 공급업체에 대한 정보

PDP1: 정확한 렌탈 정보 제공

제품 설명이 포함된 제품 상세 페이지에는 API에서 반환되는 모든 자료 대여 정보가 표시되어야 합니다(예: 다음과 같은 정보):

각 차량의 등급, 제조사 및 모델
최대 용량
문 개수
수하물 용량
전송 유형
연료 공급원: 가스, 하이브리드, 전기 등(캘리포니아 시장)
허용 마일리지
Pick-up 포인트 및 drop-off 포인트
렌터카 회사 이름 또는 로고

"description": "Skoda Enyaq Electric car or similar",
        "number_of_passengers": 5,
        "number_of_doors": {
            "min": 5,
            "max": 5
        },
        "luggage_count": {
            "small": 3,
            "large": 3
        },
        "acriss_code": "JFBC",

PDP2: 전체 대여 정책 표시

모든 규정 및 제한 사항을 포함한 렌터카 정책은 여행자가 렌터카 예약을 완료하기 전에 전체 내용을 공개해야 합니다. 여기에는 다음과 같은 시점에 환불 가능한 보증금이 포함됩니다. pick-up.

확장 가능한 정책 섹션 2개와 모든 규칙 및 제한 사항을 볼 수 있는 링크가 나열된 모달

렌탈 정책 예시

"policies": [
        {
            "name": "Fuel: full to full",
            "descriptions": [],
            "policy_statements": [
                {
                    "statement": "Fuel: full to full",
                    "statement_condition": "Vehicle to be returned with the same amount of fuel as start of the trip to avoid refuelling charges."
                }
            ],
            "policy_type": "PRODUCT_USE_POLICY"
        },
        {
            "name": "Unlimited mileage",
            "descriptions": [],
            "policy_statements": [
                {
                    "statement": "Unlimited mileage",
                    "statement_condition": "Drive unlimited distance with this car at no extra cost."
                }
            ],
            "policy_type": "PRODUCT_USE_POLICY"
        },
        {
            "name": "Cancellation available",
            "descriptions": [],
            "policy_statements": [
                {
                    "statement": "Cancellation available",
                    "statement_condition": "Before Fri, Sep 19, 10:30am"
                }
            ],
            "policy_type": "CANCELLATION_POLICY"
        },
        {
            "name": "",
            "descriptions": [],
            "policy_statements": [],
            "policy_type": "PRODUCT_USE_POLICY"
        },
        {
            "name": "Online check-in",
            "descriptions": [],
            "policy_statements": [
                {
                    "statement": "",
                    "statement_condition": "Check in online on the Sixt website by uploading required documents, like driver’s license, up to the time of pick-up."
                }
            ],
            "policy_type": "CHECKIN_POLICY"
        },
        {
            "name": "Pay now and save",
            "descriptions": [],
            "policy_statements": [],
            "policy_type": "PAYMENT_POLICY"
        }
    ],

규칙 및 제한 사항 예시

{ 
  "rules_and_restrictions": [ 
    { 
      "title": "Rental policies overview", 
      "statements": "<p>The following rules and restrictions are provided by the car rental company.</p>" 
    },

추가 country-specific 요구 사항

EU 및 영국 지역에서는 청약철회권이 적용되지 않는다는 고지 사항을 표시해야 합니다.

영국 소비자법 차이점을 설명하는 정보가 동그라미로 표시된 렌탈 정책 모달

PDP3: 취소 정책 표시

렌탈을 취소해야 하는 경우, 여행자는 공급업체의 취소 정책의 매개변수를 이해해야 합니다.

무료 취소

일부 판매업체는 시기와 관계없이 예약을 무료로 취소할 수 있습니다.

"오늘 이 가격으로 고정하고 언제든지 무료로 취소하세요."라는 알림 상자가 표시됩니다.

{...
        {
            "name": "Free cancellation",
            "descriptions": [],
            "policy_statements": [],
            "policy_type": "CANCELLATION_POLICY"
        },
        {
            "name": "Free cancellation",
            "descriptions": [],
            "policy_statements": [
                {
                    "statement": "Lock in this price today, cancel free of charge anytime. Reserve now and pay at pick-up.",
                    "statement_condition": ""
                }
            ],
            "policy_type": "PRODUCT_USE_POLICY"
        },
}

다음까지 무료 취소

상황에 따라 일부 판매업체는 예약 날짜 24시간 전 등 특정 시점까지 예약을 무료로 취소할 수 있도록 허용할 수 있습니다. pick-up.

{        
        {
            "name": "Free cancellation",
            "descriptions": [],
            "policy_statements": [
                {
                    "statement": "Free cancellation",
                    "statement_condition": "Before Wed, Oct 1, 10:30am"
                }
            ],
            "policy_type": "CANCELLATION_POLICY"
        },
        {
            "name": "Free cancellation",
            "descriptions": [
                "Free cancellation up to 24 hours before pick-up",
                "Cancellations made after that or no-shows are subject to a fee of $50 or total reservation amount, whichever is lesser which will be charged on the card details shared by you.",
                "Get 100% refund of Collision Damage Plan cost if canceled before the scheduled pick-up time. This insurance will be canceled automatically with your rental car cancellation.",
                "Cancellations made after that or no-shows are subject to a fee of $50 or total reservation amount, whichever is lesser which will be charged on the card details shared by you.",
                "Get 100% refund of Collision Damage Plan cost if canceled before the scheduled pick-up time. This insurance will be canceled automatically with your rental car cancellation."
            ],
            "policy_statements": [
                {
                    "statement": "Lock in this price today, cancel free of charge up to 24 hours before pick-up. Cancellations within 24 hours of pick-up or no shows will not be eligible for a refund.",
                    "statement_condition": ""
                }
            ],
            "policy_type": "PRODUCT_USE_POLICY"
        },
    }
}

PDP4: 옵션 추가 기능의 세부 사항 및 비용

여행자는 카시트 또는 유료 통행권 등의 추가 옵션을 추가할 수 있습니다. 이러한 추가 요금은 예약 시 청구되지 않고 항상 판매업체에서 지불해야 합니다. 추가 옵션은 이용 가능 여부에 따라 달라질 수 있으며 보장되지 않습니다.

"optional_extras": [
        {
            "id": "TollPaymentTagPass",
            "name": "TOL - Toll pass/Express lane",
            "rate_price": {
                "rate_period": "daily",
                "rate": {
                    "billable_currency": {
                        "value": "15.71",
                        "currency": "USD"
                    },
                    "request_currency": {
                        "value": "15.71",
                        "currency": "USD"
                    }
                }
            }
        },
        {
            "id": "InfantChildSeat",
            "name": "CSI - Infant seat",
            "rate_price": {
                "rate_period": "daily",
                "rate": {
                    "billable_currency": {
                        "value": "17.16",
                        "currency": "USD"
                    },
                    "request_currency": {
                        "value": "17.16",
                        "currency": "USD"
                    }
                }
            }
        }
    ]

예약 페이지

결제 세부 정보

예약 세부 정보 요약(BP1)

요약에는 항상 다음이 포함되어야 합니다:

* 렌터카 날짜 *Pick-up 위치, 시간 및 주소 *Drop-off 위치, 시간 및 주소 * 차량 등급 * 렌터카 회사 이름 * 연료 정책

BP2: 렌탈 가격 표시

가격을 표시하는 방법은 예약 중인 요금 유형과 사용 중인 예약 채널에 따라 다릅니다. 출시 팀에서 어떤 요구 사항이 적용되는지 알려줄 것입니다.

단독 요금

독립형 요금은 단독으로 판매하거나 패키지의 일부로 판매할 수 있습니다.

예약 페이지에는 선택한 대여 기간의 총 요금과 해당 세금 및 수수료( one-way 수수료 포함)의 내역이 표시되어야 합니다. 또한 대여료를 선결제(지금 결제 또는 익스피디아 수금) 또는 카운터에서 결제(나중에 결제 또는 벤더 수금)해야 하는지 여부도 포함하세요. add-ons 옵션은 항상 카운터에서 결제합니다.