예약 보류 및 재개

2단계 예약 모델의 일부로 파트너 또는 고객이 즉시 청구 요금 없이 싱글룸 하나를 할당할 수 있으며, 예약을 완료하지 않고 객실을 취소하거나 포기하는 경우 취소 위약금이 발생되지 않습니다. 고객/파트너가 지정된 기간 내에 객실을 확인하고자 하는 경우 두 번째 단계로 예약을 완료할 수 있습니다. 예약을 포기하면 자동으로 롤백되고 선택한 인벤토리가 해제됩니다.

개요

필요한 변경 작업

보류 및 재개는 새로운 요청 플래그와 응답에 토큰화된 새로운 링크가 있는 기존 Rapid API를 사용합니다. 통합하는 데 별개의 새로운 API 방법이 필요하지 않습니다. 보류 및 재개를 통합하려면 요청을 업데이트하거나 다음의 처리에 응답해야 합니다.

1.     예약 생성 처리

2.     예약 검색 처리

3.     재개 - 검색 응답에서 새로운 토큰 링크 처리

4.     취소 - 생성 응답에서 새로운 토큰 링크 처리

전체 보류 및 재개 프로세스를 가장 잘 이해할 수 있으므로, 당사의 개별 통합 API 문서를 참조하기 전에 이 페이지를 전부 검토해 보시기 바랍니다. 이 페이지에 문서화된 특정 옵션은 해당하는 당사의 기존 예약 및 예약 관리 API 전용 문서 페이지에서도 확인할 수 있습니다.

일반적인 요청 흐름 예

보류 중인 예약 생성

현재 예약 요청에는 hold라는 새로운 부울 필드가 있습니다. true 값을 보내면 숙박 시설이 보류 상태로 전환됩니다. 

보류 중인 예약은 특정 앱에 필요한 최소한의 시간 동안 보류 상태로 남게 됩니다. 확인되지 않은 채 보류 상태로 남아 있는 경우에는 예약이 자동으로 롤백됩니다.  

성공한 보류 중인 예약 응답은 보류 중인 예약을 재개(확인 및 결제)하는 데 사용되는 토큰화된 추가 링크를 반환합니다. I또한 취소 링크를 제공하는 데 일반적으로 사용되는 rooms 배열을 생략하므로, 아직 어떤 객실도 취소할 수 없습니다.

보류 중인 예약에 대한 예약 응답 예

{
  "itinerary_id": "2667552437552",
  "links": [
    {
      "rel": "retrieve",
      "method": "GET",
      "href": "/1/itinerary/{itinerary_id}?token=MY5S3j36cOcLfLBZjPYQ1abhfc8CqmjmFVzkk7euvWaunE57LLeDgaxm516m"
    },
    {
      "rel": "resume",
      "method": "PUT",
      "href": "/1/itinerary/{itinerary_id}?token=MY5S3j36cOcLfLBZjPYQ1abhfc8CqmjmFVzkk7euvWaunE57LLeDgaxm516m"
    },
    {
      "rel": "cancel",
      "method": "DELETE",
      "href": "/1/itinerary/{itinerary_id}?token=MY5S3j36cOcLfLBZjPYQ1abhfc8CqmjmFVzkk7euvWaunE57LLeDgaxm516m"
    }
  ]
}

hold 플래그가 예약에 사용된 경우 예약 결제 금액이 청구되지 않습니다. 보류 중인 예약 응답에서 PUT 방법 링크가 보류 창 내에 사용된 경우에 한해 예약이 완료되고 결제 금액이 청구됩니다.

보류 중인 예약 검색

보류 중인 예약 응답에 제공되는 retrieve 링크를 사용하여 보류 중인 예약을 검색합니다. 보류 및 재개 예약을 검색하는 방법은 1단계 예약의 일반 검색과 다른 점이 없으며 요청 본문이 필요하지 않습니다.

응답 시나리오:

• 계속 보류 중인 보류 중 예약을 검색하면 예약을 즉시 재개하고 완료하거나 취소할 수 있는 링크 등 데이터가 제한된 응답이 반환됩니다.
• 취소(요청에 따라 롤백)되었거나 시간이 초과(자동으로 롤백)된 보류 중인 예약을 검색하면 '일정을 찾을 수 없음' 오류가 반환됩니다.
• 이전에 재개되고 확인된 보류 중 예약을 검색하면 표준 일정 검색과 동일한 작업이 수행되고 전체 예약 세부 정보가 반환됩니다.

보류 중인 예약에 대한 검색 응답 예

{
    "itinerary_id": "8701934321257",
    "creation_date_time": "2018-03-09T14:42:58.159Z",
    "links": {
        "resume": {
            "method": "PUT",
            "href": "/2/itineraries/8701934321257?token=QldfCGlcUA…{example trimmed for length}="
        },
        "cancel": {
            "method": "DELETE",
            "href": "/2/itineraries/9700934721257?token=QldfCGlcUA…{example trimmed for length}="
        }
    }
}

취소/시간 초과된 보류 중인 예약에 대한 검색 응답 예

{
  "type": "resource_not_found",
  "message": "Itinerary was not found with provided request."
}

보류 중인 예약 재개

보류 중으로 배치된 예약을 확인하고 결제를 완료하려면 예약을 재개해야 합니다.

보류 중인 예약의 재개 작업은 원래 보류 중인 예약 응답에서 제공되는 resume 링크를 사용하여 수행되며 요청 본문이 필요하지 않습니다.

응답 시나리오:

•  계속 보류 중인 보류 중 예약을 재개하면 예약이 완료되고 성공적으로 완료되었음을 나타내는 HTTP 204 - No Content 응답이 반환됩니다. 전체 일정을 검색하려면 초기 보류 중인 예약 응답에서 GET 링크를 사용합니다.
• 취소(요청에 따라 롤백)되었거나 시간이 초과(자동으로 롤백)된 보류 중인 예약을 재개하면 이전 검색 섹션에서 설명한 것과 동일한 '일정을 찾을 수 없음' 오류가 반환됩니다.
• 이미 성공적으로 재개된 보류 중인 예약을 재개하면 예약이 이미 실행되었음을 알려 주는 오류가 반환됩니다.

이미 재개된 예약에 대한 재개 응답 예

{
  "type": "resume.already_committed",
  "message": "Booking has already been committed."
}

보류 중인 예약 취소(롤백)

예약 생성 및 검색 응답에서 제공되는 토큰화된 cancel 링크는 일정 수준에서 동작합니다. 사용하면 보류에서 요청된 숙박 시설이 해제되고 보류된 일정이 롤백됩니다. 객실 수준 취소 링크는 예약이 성공적으로 재개된 이후에 검색 응답에서만 제공됩니다.

또한 cancel 작업을 수행하면 성공적인 재개 응답과 동일한 HTTP 204 상태 코드가 반환됩니다. HTTP 204는 서버가 요청을 성공적으로 수행했고 응답 페이로드 본문에 전송할 추가 콘텐츠가 없음을 나타내는 상황에서 모두 사용됩니다.

보류 중인 예약을 취소하도록 요청하면 예약을 자동으로 롤백할 수 있게 한 것처럼 동일한 최종 시나리오가 나타납니다.

응답 시나리오:

•  계속 보류 중인 보류된 예약을 취소하면 인벤토리가 보류에서 해제되고 HTTP 204 상태가 반환됩니다.
• 이미 취소(요청에 따라 롤백)되었거나 시간이 초과(자동으로 롤백)된 보류된 예약을 취소하면 이 페이지에서 앞서 설명한 '일정을 찾을 수 없음' 오류가 반환됩니다.
• 이미 성공적으로 재개된 보류된 예약을 취소하면 '일정 수준 취소가 지원되지 않음'이라는 오류 메시지가 반환됩니다. 각 객실을 취소하려면 검색 호출을 만들고 응답에 제공된 객실 수준 링크를 사용합니다.

이미 재개된 예약에 대한 취소 응답 예

{
  "type": "resume.itinerary_level_cancel_not_supported",
  "message": "Itinerary level cancel on confirmed booking is not supported."
}