예약 개요

예약 API를 통해 여행객들은 렌터카 예약을 할 수 있습니다.

여행자가 조회 API로 표시된 업체와 차량을 선택하면, 해당 여행자가 예약을 진행할 수 있도록 예약 API를 제공해 주십시오. 예약 API의 주요 기능은 선택한 차량 상품에 대한 예약을 생성하는 것입니다.

Expedia Collect

Expedia Collect 예약의 경우, 예약을 완료하기 전에 결제 정보를 당사의 결제 등록 엔드포인트(v2/payments)로 전송해야 하며, 이를 통해 생성된 보안 payment_token 를 ‘Create Booking’ 요청 본문에 사용해야 합니다. 그런 다음, 예약을 생성하기 위해 필수 항목인 affiliate_reference_id, 주 운전자 정보 및 결제 토큰을 전달해야 합니다.

참고: Expedia Collect 예약의 경우, 가용성 및 세부 정보 응답의 ‘ payment_registration_required ’ 필드는 항상 ‘true’로 표시되며, ‘ payment_token ’는 예약 생성 요청에 포함됩니다.

판매자 수금

‘Vendor Collect’ 흐름의 경우, 예약 생성에 결제 토큰이 필요한지 여부를 판단하기 위해 ‘가용성 및 세부 정보’ 응답에 포함된 ‘ payment_registration_required ’ 필드가 사용됩니다.

payment_registration_required=true의 상세 응답에서 결제 등록은 필수이며, 예약 생성 요청(Create Booking request)에 결제 등록 정보( payment_token)가 포함되어야 합니다.
payment_registration_required=false의 상세 응답에서 결제 등록은 선택 사항이며, payment_token 은 Create Booking 요청에 포함될 수도 있고 포함되지 않을 수도 있습니다.

>> Payments API에 대해 알아보기

예약 생성하기

성공적으로 예약된 각 응답에는 일정를 조회할 수 있는 링크가 포함되어 있습니다. 예약 생성 링크는 해당 carOfferToken 에 대한 공급업체의 재고가 소진될 때까지 유효합니다.

요청 예시

POST https://api.ean.com/v2/itineraries/car
	?token=U1dFC0JHTWxUCwUHCWNjQ1sQRxBVVwFAW... ...15YTQTcHhefjYOfiBQfThuP1hcfVULeAM0W0U6VWBZFzQXdltcUFwRQgkLCgBRAAEHAVEADg==
{
  "affiliate_reference_id": "4480ABC",
  "primary_driver": {
    "given_name": "{{first_name}}",
    "middle_name": "Test",
    "family_name": "{{last_name}}",
    "phone": {
      "country_code": "1",
      "area_code": "487",
      "number": "5550077"
    },
    "email": "{{email}}"
  },
  "flight_details": {
      "air_carrier_code": "G4",
      "flight_number": 778
  },
  "traveler_loyalty_member_id": "ABCD1234","
  "requested_extras": [
    "SatelliteRadio",
    "ToddlerChildSeat"
  ],
  "affiliate_metadata": "data_point_1:123|data_point2:This is data.",
  "payment_token": "{{payment_token}}"
}

답변 예시

{
    "itinerary_id": "9030336886597",
    "links": {
        "retrieve": {
            "method": "GET",
            "href": "https://api.ean.com/v2/itineraries/9030336886597/car",
        }
    }
}

>> 예약 관리에 대해 자세히 알아보기 >> 예약 요청 처리 방법 확인하기

카드에 요금이 청구되지 않고 공급업체에도 전송되지 않는 테스트 예약을 하려면, 테스트 요청 문서를 참조하십시오.

API 세부 정보

이 페이지에서 예약 관련 엔드포인트 정의를 살펴본 후 API Explorer 또는 다른 테스트 소프트웨어를 사용하여 예시 및 스키마 정의가 실제 출력과 어떤 차이가 있는지 확인해 보세요.

추가 리소스

Rapid Car API의 모든 엔드포인트를 직접 사용해 보시든, OpenAPI 사양서를 다운로드하시든, 여러분이 필요로 하는 모든 것을 저희가 제공합니다.