자동 생성된 번역입니다.

Vrbo on Rapid 통합 가이드

Vrbo 연동 절차 안내

개요

이 문서에서는 통합 프로세스의 작동 방식, API 요청 및 응답 예시, 제한 사항, 오류 처리와 FAQ를 포함한 Rapid Vrbo 통합 프로세스 지침을 제공합니다.

이 지침은 권장되는 Vrbo 공급 제품을 대상으로 합니다. 고급 사용 사례는 아래의 고급 통합 가이드를 참조해 주세요.

|

지리

알아두어야 할 사항

Rapid Geography API를 사용하고 있으며 Vrbo 기능이 활성화된 경우, 기존의 숙박 시설 숙박 시설와 함께 모든 Geography API에서 Vrbo 숙박 시설 ID에도 접근할 수 있습니다.


주요 주제: 매핑

  • 예약이 완료되기 전에는 숙박 시설 상세 주소를 노출할 수 없습니다. 자세한 내용은 기본 숙박 콘텐츠 통합 가이드를 참조해 주세요.
  • 숙박 시설를 지도에 표시하려면 Content API에서 제공하는 위도/경도 정보를 자체 지리 정보 솔루션과 함께 사용해야 합니다.
  • 숙박 시설의 경우, 숙박 시설가 개인정보 보호를 요청한 경우 지도 표시 시 난독화된 위도/경도를 사용해야 하며, 단, 게스트에게 숙박 시설의 정확한 위치가 표시되지 않는 한, 숙박 시설 검색 시에는 정확한 위도/경도를 사용할 수 있습니다.

다른 숙박 시설과의 주요 차이점

Vrbo와 숙소를 함께 포함한 ‘지리적 응답’을 요청하거나, Vrbo만 포함된 응답(활성화된 프로필에서 supply_source=vrbo사용) 또는 숙소만 포함된 응답( supply_source=expedia사용)을 요청할 수 있습니다. supply_source가 제공되지 않으면, Rapid Geography API는 기본적으로 숙박 시설만 반환합니다.


지리 FAQ

Q. Vrbo 숙박 시설만 반환하거나 Vrbo 외 다른 사이트의 숙박 시설만 반환하도록 지리 API를 필터링할 수 있나요?
A. 네, .을 사용하여 필터링할 수 있습니다 supply_source=vrbo. 프로필이 Vrbo 공급에 액세스할 수 없다면 결과가 반환되지 않습니다.

콘텐츠

알아두어야 할 사항

  • Vrbo 콘텐츠는 supply_source=vrbo을 전달하여 다른 숙박 옵션과 동일한 Rapid Content API를 통해 제공되지만, 아래 스키마의 차이점을 유의하시기 바랍니다.
  • Vrbo 콘텐츠는 다른 Rapid 숙박 옵션에 비해 숙박 시설 관리자들에 의해 더 자주 업데이트됩니다. 잘못된 숙박 시설 목록 정보로 인해 고객 경험이 좋지 않거나, 지원 통화 및 환불 요청을 초래할 수 있습니다. 투숙객들이 숙박 시설, 편의 시설 및 이용 약관에 대한 정확한 정보를 확인할 수 있도록, Vrbo 콘텐츠를 최소한 매주 한 번씩 업데이트하실 것을 강력히 권장합니다.
  • Vrbo 프리미어 호스트 프로그램은 낮은 호스트 취소율, 긍정적인 이용 후기, Vrbo 플랫폼을 통한 고객 서비스 경험 등을 통해 긍정적인 고객 경험을 제공한 것으로 입증된 호스트에게만 제공되는 초대 전용 혜택입니다. .을 사용하여 Premier Host 숙박 시설를 확인할 수 있습니다 attribute_id=1073745445. 또한, 요청에 attribute_id=1073745445를 포함하면 결과를 필터링하여 Premier Host 숙박 시설만 반환할 수 있습니다.

다른 숙박 시설과의 주요 차이점

콘텐츠 파일 API에서는 Vrbo 숙박 시설가 다른 Rapid Lodging 옵션들과 별도로 제공됩니다.

Vrbo-specific 필드

필드설명
vacation_rental_details:registry_number휴가용 주택 숙박 시설을 표시하기 위한 필수 필드입니다. 자세한 내용은 출시 요구 사항을 참조해 주세요.
개인 소유 숙박 시설속성 1073745102 'Private host 숙박 시설'는 숙박 시설가 비공개 호스트에 의해 관리됨을 나타냅니다. 추가 필수 설명과 함께 표시하는 데 필요합니다. 자세한 내용은 출시 요구 사항을 참조해 주세요.
전문 진행자 숙박 시설속성 1073745142 인 '전문 숙박 시설 호스트/관리자'는 숙박 시설가 전문 호스트/관리자에 의해 관리되고 있음을 나타냅니다. 추가 필수 설명과 함께 표시하는 데 필요합니다. 자세한 내용은 출시 요구 사항을 참조해 주세요.
프리미어 호스트속성 1073745445. ‘프리미어 파트너’는 숙박 시설가 프리미어 호스트에 의해 관리됨을 나타냅니다. 이 기능을 사용하여 숙소 목록에 ‘프리미어 호스트’ 표시를 추가하거나, 검색 결과를 필터링하여 ‘프리미어 호스트’ 숙소만 표시할 수 있습니다. 숙박 시설.
statistics최대 숙박 인원, 침실 수, 욕실 수, 객실 수(단일 유닛 휴가용 주택 임대의 경우 1개) 및 숙박 시설 내 구역 정보(제곱미터 및 피트)를 포함한 휴가용 주택 관련 정보가 포함됩니다. 검색 결과 및 숙박 시설 세부 정보 페이지 상단에 주요 속성 정보 요약을 표시하는 데 사용해야 합니다.
욕실 및 침실 수속성 1073743378 '침실 수'는 유닛 내 침실 수를 나타냅니다. 속성 1073743379 '욕실 수'는 유닛 내 욕실 수를 나타냅니다.
vacation_rental_details:property_manager숙박 시설 관리자 이름, 사진 및 구사 언어(가능한 경우)가 포함됩니다. 숙박 시설을 관리하는 호스트에게 고객을 소개하는 용도로 사용해야 합니다. 예약 완료 후, ‘에센셜 스테이’ 콘텐츠의 일부로 연락처 정보가 제공됩니다.
>> ‘에센셜 스테이’ 콘텐츠 살펴보기
vacation_rental_details:unit_configurations객실 내 침대 유형과 해당 객실의 침대 유형별 현황을 설명합니다. 이 정보는 숙박 시설이 고객의 여행 동료를 수용할 수 있다는 확신을 주기 위해 고객에게 숙소 배치를 표시하는 용도로 사용해야 합니다.
vacation_rental_details:house_rules이 필드는 사용하지 않습니다. 대신 vacation_rental_details:enhanced_house_rules 필드를 사용하세요.
vacation_rental_details:enhanced_house_rules보강된 숙소 규칙에는 반려동물, 파티, 어린이, 흡연 정책 등에 관한 주요 정책 정보가 포함되어 있습니다. additional_information에는 정책 설명, 출입 코드, 비밀번호, 이미지, stay-collected 요금(시 관광세 또는 usage-based 요금) 등 투숙객의 숙박에 필수적인 각 정책의 세부 사항이 포함될 수 있습니다.
>> Vrbo 필수 숙박 콘텐츠 가이드에서 자세히 알아보기
vacation_rental_details:rental_agreement숙박 시설 관리자가 제공하며 모든 결제 페이지에 표시되어야 하는 PDF 또는 웹사이트 링크를 제공합니다. 임대 계약서에 서명하고 임대 계약서를 반환하거나 제출하는 고객 행동이 필요할 수도 있습니다.
vacation_rental_details: free_text호스트가 제공하는 자유 텍스트 필드로, 숙박 시설의 고유한 특성이나 고객에게 제공하는 경험을 강조합니다. 이 설명에는 고객이 예약하기 전에 이해해야 하는 인근 명소, 호스트가 제공하는 선택적 서비스 또는 기타 중요한 정보(예: 공사, 소음, 수질 상태, 스키 슬로프 접근성, 주차 등)가 포함될 수 있습니다. 이 섹션은 다소 장황할 수 있기 때문에 특히 모바일 환경에서 이 필드의 UI를 표시할 때는 세심한 주의를 기울여야 합니다.

이 필드가 없는 경우, Descriptions.General로 대체해야 합니다.
descriptions.general숙박 시설 속성, 편의 시설 및 위치를 바탕으로 휴가용 주택 숙박 시설에 대해 자동으로 생성된 설명을 제공합니다. 이 텍스트에는 호스트가 제공하는 안내 또는 정보가 포함되지 않습니다. 이 필드는 전통 숙박 시설과 가장 관련이 있습니다. 이 필드는 vacation_rental_details.free_text 항목이 없을 때 사용해야 합니다.
traveler_service_fee이 필드는 사용하지 않습니다. 이를 사용해서는 안 됩니다. 권장되는 ‘ check-out ’ 표시 문구에 대해서는 출시 요건을 참조해 주십시오.
>> 출시 요건 확인하기

Vrbo와 관련이 없는 필드 숙박 시설

필드설명
숙박 시설 평점현재 Vrbo 숙박 시설에는 평점이 지원되지 않습니다. 고객 이용 후기 평점을 대신 사용할 수 있습니다.
객실 설명단일 유닛 휴가용 주택 숙박 시설에는 적용되지 않습니다. 대신 객실 수준 정보를 사용해야 합니다.
요금제Vrbo 숙박 시설에는 적용되지 않습니다.
객실 수준 정보모든 객실 설명 정보는 숙박 시설 수준에서 제공됩니다. Vrbo 숙박 시설에는 객실 수준 콘텐츠가 없기 때문에 일반적으로 객실 수준의 편의 시설이 'vacation_rental_details'라는 새 섹션에 포함됩니다.
vrbo_srp_id, listing_id, listing_number, listing_source, listing_unit이러한 필드는 Vrbo Link-Off 모델에만 관련이 있지만, 숙박 시설 매핑/매칭에도 사용될 수 있습니다.
IPM_NameVrbo IPM 평가판에 참여하는 파트너만 사용할 수 있습니다. Value에는 IPM의 이름이 제공되며, 머천트가 고객의 카드에 요금을 청구하고 숙박에 대한 이메일을 고객에게 보낸다는 사실을 고객에게 안내해야 합니다.

콘텐츠 관련 자주 묻는 질문

Q. Rapid 콘텐츠가 상세 주소가 입력되지 않았다면 Vrbo 콘텐츠를 어떻게 매핑하나요?
A. Rapid 지리 API 및/또는 숙박 시설 위도/경도 값을 사용하여 속성의 지리적 위치를 찾을 수 있습니다.

Q. Rapid 콘텐츠 파일에 Vrbo 숙박 시설이 포함되어 있나요?
A. 예. Vrbo 관련 콘텐츠 파일은 API 요청에서 supply_source=vrbo를 전달하여 검색할 수 있습니다.

Q. Vrbo 숙박 시설은 모든 언어로 제공되나요?
A. 예. 그러나 호스트가 제공하는 일부 자유 텍스트 필드는 현지화되지 않고 대신 호스트의 언어로 제공됩니다. 영향을 받는 필드에는 숙박 시설 설명(descriptions.general), 강화된 숙소 규정(vacation_rental_details:enhanced_house_rules), 기본 숙박 콘텐츠 및 호스트와 고객 간의 이메일 대화(Vrbo에서 지원)가 포함됩니다.

Q. 제 고객은 Vrbo에 대해 잘 알지 못합니다. 모든 지역에서 Vrbo 브랜드를 표시해야 하나요?
A. 표시해야 하지만 독일, 프랑스, 호주와 뉴질랜드에서는 현지 Vrbo 브랜드로 대체할 수 있습니다. 아래 부록 2를 참조해 주세요. 페이지 및 지역별 요구 사항은 출시 요구 사항 가이드를 참조해 주세요. 동일한 숙박 시설가 여러 공급업체로부터 조달되는 경우에는 예외가 허용될 수 있으나, Vrbo가 예약 대상 공급업체로 확인되는 즉시 Vrbo 이름이 표시되어야 합니다. Vrbo 브랜드를 소개하는 것은 고객을 교육하고 예약 후 기대치를 설정하기 위한 중요한 단계입니다.

Q. bed_groups 없이 각 객실의 침대 유형을 어떻게 설명할 수 있나요?
A. 침대 유형에 대한 자세한 설명은 ‘객실 구성’ 페이지를 참조해 주세요.
>> 객실 구성 알아보기

조회

알아두어야 할 사항

  • Vrbo 숙박 시설은 공유 숙박 시설이 아닌 온전한 숙박 시설입니다.
  • Vrbo 숙박 시설은 단일 유닛만 존재합니다.
  • Vrbo 속성은 단일 요금제만 반환합니다.
  • 파손 보증금이 있는 숙박 시설은 조회 요청에 exclusion=refundable_damage_deposit 항목을 전달하여 제외해야 합니다. 이러한 숙박 시설을 활성화하기 전에 알아야 하는 사항에 대한 자세한 내용은 고급 통합 가이드를 참조해 주세요.
  • 보증금 정책이 있는 숙박 시설은 제외됩니다. 자세한 내용은 아래의 고급 통합 가이드를 참조해 주세요.
  • 당일 예약은 지원되지 않습니다(예약 가능 여부가 표시되지 않습니다).

주요 주제: Vrbo 예약에 대한 merchant_of_record

Rapid 조회 API의 ‘ merchant_of_record ’ 필드는 Rapid 숙박 시설의 Vrbo에서는 다른 의미를 가집니다.

  • 예약할 때 제공한 카드를 누가 지불하는지를 나타내지는 않습니다. 모든 예약은 선불입니다.
  • merchant=expedia('판매자')는 EG 결제 시스템을 통해 예약이 이루어짐을 나타냅니다. 가장 높은 예약 성공률과 일관된 오류 설명을 제공합니다.
  • merchant=property('여행사')는 기존 Vrbo 결제 시스템을 통해 예약이 이루어짐을 나타냅니다. 기본적으로 이 공급의 판매는 비활성화되어 있습니다. 자세한 내용은 고급 통합 섹션을 참조해 주세요.
  • 숙박 시설은 단일 모델에 연결되지 않습니다. 대신 '판매자'의 자격은 세 가지 주요 요소에 따라 결정됩니다.
    • 환불 가능한 파손 보증금이 없습니다(권장되지 않는 고급 통합 옵션, 아래의 고급 통합 섹션 참조).
    • 보증금 정책/결제 일정이 없습니다(권장되지 않는 고급 통합 옵션, 아래의 고급 통합 섹션 참조).
    • 예약 가능 여부를 확인하려면 목적지 통화로 검색해야 합니다.

주요 주제: Vrbo 예약을 위한 통화 코드

쇼핑 요청에 명시된 통화는 예약의 청구 통화에 영향을 미치지 않습니다.

  • Vrbo 예약용 통화를 지정할 수는 없습니다. 청구 통화는 항상 숙박 시설 통화와 일치합니다.
  • 중요: ‘판매자’로서 Vrbo의 공급 목록을 최대한 활용하려면 모든 예약 요청에 목적지 통화를 반드시 포함해야 합니다. 목적지 통화가 지정되지 않은 경우, 상점 응답에는 해당 통화로 대금을 수령하기로 선택한 호스트가 있는 숙박 시설만 반환됩니다. 지역별 결제 통화 권장 사항은 부록을 참조하시거나, 보다 자세한 매핑 정보는 Partner Connect 담당자에게 문의해 주시기 바랍니다.

주요 주제: Vrbo 예약을 위한 국가 코드

조회 API 요청에 지정된 국가 코드는 예약 시 제공된 신용카드의 청구 국가와 일치해야 합니다. 이는 청구 주소 국가 코드에 따라 결정된 대로 고객의 위치에 따라 여행객 서비스 요금에 VAT를 부과해야 하는 Vrbo 요구 사항 때문입니다.

  • 일치하지 않으면 VAT 청구 요건이 다르기 때문에 예약 오류가 발생할 수 있습니다.
  • 고객이 결제 청구지 주소를 입력한 후, 해당 국가 코드가 쇼핑 과정에서 Rapid에 전달된 국가 코드와 일치하는지 확인해야 합니다. 이러한 값이 다르면 예약을 제출할 때 오류가 발생합니다. 대신, 예약에 적용될 정확한 가격을 확인하려면 guest-provided 의 청구지 주소를 사용하여 쇼핑 요청을 다시 제출하셔야 합니다. 예약 요청을 제출하기 전에 게스트에게 가격 변동(인상 또는 인하) 사실을 알려야 합니다.

다른 숙박 시설과의 주요 차이점

Vrbo-specific 필드

수수료설명
property_fee청소비, 관리비, 추가 인원 수수료 등을 포함한 예약에 대한 숙박 시설 수수료 총액을 설명합니다.
traveler_service_fee예약을 용이하게 하고 지원을 제공하기 위해 Vrbo에서 부과하는 서비스 수수료입니다. 예약의 일부가 환불 불가인 경우 이 수수료는 환불되지 않습니다. 표시 정보에 대한 자세한 내용은 출시 요구 사항을 참조해 주세요.

여행자 서비스 수수료 및 Rapid 조회 API 국가 선택: Vrbo가 가격 응답에 여행자 서비스 수수료를 포함하는 경우, 해당 금액에는 Rapid 조회 API 요청에 사용된 국가에 해당하는 부가가치세(VAT)가 포함됩니다. 예약을 성공적으로 완료하려면, 쇼핑몰에서 요청한 국가가 결제에 사용될 국가와 일치하는지 반드시 확인해야 합니다. check-out.

Vrbo와 관련이 없는 필드 숙박 시설

필드설명
객실 ID객실 이름 및 요금 ID는 Vrbo 재고에 적용할 수 없으며, 표시되지 않아야 합니다.
예약 가능 객실Vrbo 숙박 시설의 경우 항상 0입니다. 긴박함을 표시하기 위해 이 필드를 사용하지 마십시오.
침대 세트선택할 수 없고 기본 설정이 제공되지 않으므로 Vrbo에는 적용되지 않습니다.
프로모션 ID 및 설명Vrbo 재고에는 적용되지 않습니다.

쇼핑 관련 자주 묻는 질문

Q. Vrbo 숙박 시설의 순위는 어떻게 매길 수 있나요?
A. 고객이 제공한 고객 평점/평가 수치가 있다면 이를 사용할 수 있습니다. 또한, 속성 1073745445 인 ‘프리미어 파트너’를 통해 프리미어 호스트 프로그램 자격을 갖춘 호스트가 관리하는 숙박 시설를 식별할 수 있으며, 이를 활용하여 숙박 시설의 정렬 순서에 영향을 줄 수 있습니다.

Q. 1박 숙박이 허용되지 않는 이유는 무엇인가요?
A. VrboCare 는 2박 이상 숙박에만 적용되므로, 투숙객에게 불만족스러운 경험을 초래하지 않도록 단기 예약은 허용하지 않는 것을 권장합니다.

Q. 단기 예약 리드타임(72시간 미만)은 왜 허용되지 않나요?
A. 호스트는 예약 요청을 처리하고, 도착에 대비해 숙박 시설을 준비하고, 고객과 소통하는 데 시간이 필요합니다. 투숙객의 불만이나 공급업체의 예약 취소를 방지하기 위해, ‘ close-in ’ 예약을 제한해야 합니다.

Q. 고객이 반려동물을 동반할 수 있는 숙박 시설을 어떻게 검색하도록 도울 수 있나요?
A. Rapid는 현재 반려동물 동반 정책으로 필터링하거나 반려동물 요금이 포함된 가격을 표시하는 기능을 제공하지 않습니다. pet-friendly 숙박 시설 는 콘텐츠의 숙박 시설 속성을 통해 식별할 수 있으며, 투숙객은 개별 반려동물 이용 규정을 확인할 수 있습니다. 호스트는 특정 반려동물 동반 정책에 대해 보다 상세하고 정확한 정보를 제공할 수 있는 vacation_rental_details.free_text 또는 enhanced_house_rules에서 반려동물 동반 정책 관련 추가 정보를 제공할 수 있습니다. 고객은 반려동물 동반 여부 및 해당 요금 지불에 관해 숙박 시설 호스트와 논의할 것을 권장합니다.

Q. 장기 체류(예: 28박이 넘는 기간)를 검색할 수 있나요?
A. 네, Rapid를 통해 Vrbo 숙박 시설의 숙소를 최대 365박까지 예약할 수 있지만, 90박으로 제한할 것을 강력히 권장합니다. 상점의 트래픽 제한에 근접해 있다면, 검색 시간을 늘릴 경우 상점으로 걸려오는 전화 건수에 더 큰 영향을 미친다는 점을 유의해야 합니다.

Q. Rapid에서 Vrbo.com과 동일한 수수료 내역이 표시되지 않는 이유는 무엇인가요?
A. Rapid는 현재 숙박 시설 수수료를 개별 구성 요소로 분류할 수 없습니다. 이러한 항목에는 청소비, 관리비, 추가 인원 요금 및 기타 요금이 포함될 수 있으며, 이 모든 것이 총 관리비( property_fees)로 합산됩니다.

Q. Vrbo 재고를 패키지로 예약할 수 있나요?
A. 아니요, Vrbo 숙박 시설는 패키지 상품의 일부로 판매하거나 예약할 수 없습니다.

Q. Vrbo 숙박 시설이 회원 한정 특가 상품에 적합한가요?
A. 예.

Q. Rapid에 등록된 Vrbo 숙박 시설는 #에서 제공되는 조기 예약, 막바지 예약, 신규 등록, 주 단위 및 월 단위 할인과 같은 프로모션 혜택을 받을 수 있나요?Vrbo.com?
A. 네, Rapid는 일반 숙박 상품과 마찬가지로 프로모션 설명, 프로모션 가격, 그리고 원래 가격(취소선 표시)을 제공하므로, 여행객들에게 해당 혜택과 할인 정보를 효과적으로 홍보할 수 있습니다.

Q. 체크아웃 전 조회 단계에서 호스트와 고객의 커뮤니케이션을 활성화할 수 있나요?
A. 지금은 변경 사항이 없습니다.

Q. 예약 가능 객실 응답에 올바른 마케팅 수수료가 표시되나요?
A. gross_profit 견적을 참조하고 체결된 계약에 따라 계산해 주세요.

Q. Vrbo on Rapid 요금은 Vrbo 및 Expedia Group 사이트의 요금과 일치하나요?
A. Rapid의 Vrbo 공급 가격은 Expedia Group 브랜드 사이트에 표시되는 가격을 반영해야 하지만 Vrbo에 표시되는 가격과 다를 수 있습니다. 이는 종종 서비스 요금 계산을 기준으로 하며 좀 더 높거나 낮을 수 있습니다. 또한 숙박 시설 이용료 롤업은 브랜드마다 약간 다를 수 있습니다.

Q. ‘재고 현황’에서와 마찬가지로, ‘가격 확인’ 시에도 취소선으로 표시된 가격이 표시되나요?
A. 아닙니다. 프로모션 관련 데이터는 ‘가용성 확인’ 통화 중에 확인할 수 있지만, ‘가격 조회’ 응답에서는 확인할 수 없습니다.

예약 및 결제

알아두어야 할 사항

  • 호스트와 게스트 간의 원활한 소통을 위해, 예약 시마다 게스트의 연락처 정보(이름, 전화번호, 이메일)를 반드시 제공해 주셔야 합니다.
  • Vrbo는 예약 시 주 및 우편번호가 필요한 국가에 더 엄격한 요건을 적용합니다. 자세한 내용은 아래의 고급 통합 가이드를 참조해 주세요.
  • 콘텐츠에 제공되는 임대 계약은 결제 페이지에 표시되어야 합니다. 자세한 내용은 출시 요구 사항을 참조해 주세요.
  • Vrbo 숙박 시설의 청구 통화는 미리 정의되어 있으므로 가상 카드 신용 한도에 주의해야 합니다. 자금 부족으로 인한 결제 오류가 발생하지 않도록, 가상 카드 사용 시 잠재적인 환율 차이와 해외 은행 수수료를 반드시 고려해야 합니다.
  • Expedia Affiliate Collect(EAC)는 현재는 Rapid에서의 Vrbo 예약에 지원되지 않습니다.
  • 현재는 특별 요청이 숙박 시설로 전달되지 않습니다. 투숙객은 예약 후 숙박과 관련된 특별한 요청 사항이 있을 경우 호스트와 직접 상의해야 합니다.

주요 주제: 결제

승인

  • 모든 Vrbo on Rapid 예약에는 청구 주소가 일치하는 유효한 신용카드가 필요합니다.
  • 일부 지역에서는 Vrbo가 $0 또는 소액으로 카드를 인증할 수 있습니다. 가상 신용카드를 발송하는 경우, 해당 카드가 여러 번의 결제를 처리할 수 있도록 설정되어 있는지 반드시 확인해야 합니다.
  • 신용카드 승인 규정은 다른 Rapid 예약과 다릅니다. 자세한 내용은 부록 4를 참조해 주세요.
  • Vrbo 가격에는 종종 Vrbo에서 부과하는 서비스 요금이 포함됩니다. 서비스 요금의 금액은 이 요금의 VAT를 징수해야 하는 법적 요구 사항으로 인해 고객의 위치에 따라 다릅니다. 따라서 예약 시 입력한 카드의 청구지 주소가 쇼핑 시 입력한 국가와 다를 경우, ‘국가 코드 오류’ 예약 오류가 발생합니다. 이러한 불일치가 발생하지 않도록, point-of-sale 에서 구매한 상품에 한해 카드 결제를 제한할 수 있습니다.

참고: 이러한 예약 오류를 방지하려면 예약을 제출하기 전에 이 불일치를 반드시 확인해야 합니다. 이 경우, 숙박 시설에 쇼핑 요청을 다시 제출하여 게스트의 청구 국가를 기준으로 한 새로운 가격을 요청해야 합니다.

고객 신용카드

  • 다른 통화로 예약한 경우 국제 거래 수수료가 부과될 수 있으며, 환불은 환율에 따라 영향을 받을 수 있다는 점을 고객에 알려야 합니다.

파트너 신용카드(가상 카드)

  • 다른 통화로 예약할 경우 발생하는 국제 거래 수수료를 반드시 고려해야 합니다.
  • 지불 일정을 제공하는 숙박 시설(신속 조회 API 입금)를 배포해서는 안 됩니다.
  • 필요한 경우(0달러 또는 명목 금액)를 허용하려면 파트너 카드를 여러 번의 결제를 처리할 수 있도록 설정해야 합니다. pre-authorization.s
  • 카드 청구지 주소는 결제 시점의 청구 통화와 일치해야 합니다.
  • 파트너 카드 설정에서는 여러 통화로 결제가 가능하도록 해야 하며, 그렇지 않은 경우 은행 수수료를 줄이면서 결제가 가능하도록 별도의 카드 세트를 관리해야 합니다.
  • 카드 결제가 가능하도록 하기 위해, 도서 요청을 보내기 몇 초 전에 VCC를 활성화해야 합니다.
  • 결제 일정이 포함된 숙박 시설에 대한 자세한 내용은 아래의 ‘고급 통합’ 섹션을 참조해 주십시오.

주요 주제: 숙박 시설 파손

환불 가능한 손해 보증금(RDD)

  • 숙박 시설에서 요구하는 RDD는 Rapid 조회 API에 표시되며, 장부 기록 시점에 수집된 예금을 나타냅니다. 고객이 숙박 시설을 손상시키지 않은 경우 보증금은 고객이 떠난 후 2주 이내에 반환됩니다.
  • RDD가 포함된 숙박 시설는 Rapid 조회 API의 제외 매개변수를 사용하여 샵 요청의 일환으로 반드시 제외되어야 합니다.
  • 자세한 내용은 아래의 ‘고급 통합’ 섹션을 참조하십시오.

Card-on-file

  • Card-on-file 이는 게스트가 숙박 시설에서 퇴실한 후, 숙박 시설 손해를 입힌 경우 Vrbo가 Rapid 조회 API를 통해 환불된 금액 한도 내에서 제공된 카드에 요금을 청구할 권리가 있음을 나타냅니다. Vrbo는 파손 청구가 제기되면 고객에게 파손 요약 및 청구서를 보냅니다. 예약 시 제공된 카드로 요금이 청구되지 않으면, Vrbo가 Vrbo 사이트를 통해 고객에게 결제를 요청하는 안내문을 보냅니다.
  • 머무는 동안 숙박 시설이 파손된 경우 숙박 시설이 청구할 수 있는 금액을 고객에게 알려주셔야 합니다. 이 금액은 card_on_file_limit 개체의 조회 응답에서 반환됩니다.
  • Card-on-file 숙박 시설 Rapid 조회 API의 제외 매개변수를 사용하면 샵 요청의 일부로 이를 숨길 수 있습니다.

주요 주제: Vrbo 예약을 위한 통화 코드

쇼핑 요청에 명시된 통화는 예약의 청구 통화에 영향을 미치지 않습니다.

  • Vrbo 예약용 통화를 지정할 수는 없습니다. 청구 통화는 항상 해당 숙박 시설의 지정 통화와 일치합니다. 그렇지 않은 경우, 가격 조회 응답에 반환된 통화는 Rapid 조회 API에서 반환된 통화와 다를 수 있으며, 이는 결제 수단에 청구될 청구 통화입니다.
  • 가상 카드로 결제하는 경우, 은행에서 부과하는 해외 거래 수수료를 충당할 수 있을 만큼 충분한 여유 금액을 확보해야 합니다.
  • 고객님께는 국제 거래 시 발생할 수 있는 은행 수수료에 대해 안내해 드려야 하며, 환율 변동으로 인해 예약 취소 시 환불 금액이 초기 결제 금액과 다를 수 있습니다.

숙박과의 주요 차이점

Vrbo-specific 필드

필드설명
우편 번호요구 사항은 다른 Rapid 호텔 재고와 다릅니다. 자세한 내용은 부록 4를 참조하십시오.

Vrbo와 관련이 없는 필드 숙박 시설

항목설명
보류/재개현재는 Vrbo on Rapid 예약에 사용할 수 없습니다.
특별 요청현재는 특별 요청을 숙박 시설에 전달할 수 없습니다. 고객이 예약 후 숙박 시설에 연락하여 특별 요청을 해야 합니다.
여행객 취급 지침현재는 Vrbo 예약에 지원되지 않습니다.

예약 및 결제 관련 자주 묻는 질문(FAQ)

Q. 예약 요청 시 어떤 고객 정보가 필요한가요?
A. 모든 Vrbo on Rapid 예약에는 호스트와의 커뮤니케이션을 위해 고객 이메일과 전화번호가 필요합니다.

Post-booking 경험

알아두어야 할 사항

Rapid API, 를 통해 Vrbo 예약이 완료되면, 투숙객에게 ‘ post-booking ’ 체험에 대한 안내를 제공해야 합니다. 다음과 같은 주제를 제안합니다.

주요 내용

  • 호스트는 Conversation API를 통해 게스트에게 메시지를 보낼 수 있습니다(예시 주제는 아래 참조).
  • 게스트는 ‘여행’ 페이지의 예약 내역에서 Conversation API를 통해 호스트에게 메시지를 보낼 수 있어야 합니다.
  • Check-in 안내 사항은 ‘Essential Stay Content’를 이용하거나 Conversation API를 통한 호스트 메시지를 통해 도착 72시간 전에 제공되어야 합니다. 도착 후 48시간 이내에 물품을 받지 못한 경우, 투숙객은 즉시 호스트나 고객지원팀에 연락해야 합니다.
  • 추가 결제 요청
  • Rapid API 는 Vrbo 예약에 대한 직접 변경을 지원하지 않지만, 다음을 통해 예약 내용을 변경할 수 있습니다. Rapid API. 이 시나리오에서는 신속 검색 결과에 총 가격만 포함되며(1박당 요금이나 총 숙박 요금은 제외됩니다). 또한, Rapid API 생태계의 특성상, Vrbo에서 수정된 예약의 경우 non-modified 에서 조회할 때보다 조회 지연 시간이 더 길어질 수 있음을 유의해 주시기 바랍니다.

예약 관리 방법

  • 숙박객은 Rapid Cancel API를 통해 귀사의 사이트에서 예약을 취소할 수 있습니다.
  • 고객은 호스트에게 변경을 요청하거나 취소 및 다시 예약을 통해 요청할 수 있습니다(권장).
  • Vrbo 숙소에 대한 취소 요청의 경우, 예약 생성 후 4시간 이내에 취소를 시도할 때 특별한 사항이 적용됩니다. 이 요청은 백엔드에서 처리에 추가 시간이 필요함을 나타내는 ‘ HTTP ’ 코드를 반환할 수 있습니다. 이러한 경우에는 몇 분 정도 기다린 후 취소를 다시 시도해 주십시오(처음 6회까지는 10분 간격으로, 그 이후부터는 30분 간격으로 시도해 보시는 것을 권장합니다). 예약 생성 후 5시간이 지나도 취소 시도가 계속 실패할 경우, Rapid 로그를 첨부하여 Expedia Group 지원팀에 문의해 주시기 바랍니다.

문제가 있는 경우

  • 손님들께 고객 지원팀이나 Expedia Group 고객 직접 지원팀(CDS).
  • 문제가 발생하면 고객에게 즉시 지원팀에 연락하라고 조언해 주세요. Vrbo에서는 출발 후 문제를 해결할 수 없으므로, 문제를 제기하려고 투숙 후까지 기다리지 마세요.
  • 고객이 숙박 시설에 접근할 수 없는 경우 먼저 호스트에게 연락을 시도해야 합니다. 만약 문제가 발생하면, 고객은 즉시 귀하에게 연락하여 도움을 요청해야 합니다. 고객이 직접 다른 숙박 시설을 선택하는 경우 요금은 환불되지 않습니다.

참고: Vrbo 확인 번호(HA-########)는 호스트와 Vrbo 고객 지원팀이 확인할 수 있는 유일한 참조 정보이므로, 투숙객에게 이 번호를 알려주셔야 합니다.

주요 주제: ‘ Post-booking ’ 지급

Vrbo 호스트는 예약이 완료된 후 또는 고객이 숙박한 후에 추가 결제를 요청할 수 있습니다. 결제 요청은 결제 페이지로 연결되는 링크(로그인 필요 없음)가 포함된 Vrbo 이메일을 고객에게 보내는 방식으로 간편하게 이루어집니다. 호스트가 요청한 추가 요금을 지불하지 않으면 예약 취소의 위험이 있다는 점을 고객에게 알려야 합니다. 호스트가 요청한 모든 요금은 Rapid 콘텐츠 자유 텍스트 필드(예: free_text 숙박 시설 설명, 숙소 규정 또는 임대 계약)에 포함됩니다.

추가 결제 요청의 예는 다음과 같습니다.

  • 반려동물 보증금 결제
  • 호스트에게 숙박 연장을 요청하는 경우 추가 숙박 결제
  • stay-collected 의 전기 사용료나 수건 대여료 등의 요금 결제.
  • 숙박 시설 파손 결제

stay-collected 수수료 예시는 부록 5를 참조해 주십시오.


다른 숙박 시설과의 주요 차이점

Vrbo-specific 필드

필드설명
필수 숙소 콘텐츠Vrbo 환영 가이드를 나타내며, 예약이 생성된 직후 게스트에게 제공되어야 합니다.
>> 자세한 내용은 Vrbo 필수 숙박 정보를 참조하세요.

Vrbo와 관련이 없는 필드 숙박 시설

필드설명
환불 금액 취소Vrbo on Rapid 예약에는 사용할 수 없습니다.
경미한 변경Vrbo 예약에는 지원되지 않습니다. 고객은 이메일을 이용해 호스트에게 직접 변경을 요청하거나 지원팀에 문의해야 합니다.
중대한 변경Vrbo 예약에는 지원되지 않습니다. 고객은 이메일을 이용해 호스트에게 직접 변경을 요청하거나 지원팀에 문의해야 합니다.

Post-booking 자주 묻는 질문

Q. 고객은 Vrbo로부터 어떤 이메일을 받게 되나요?
A. 고객은 Vrbo로부터 예약 확인이나 취소 확인을 받지 못합니다. Rapid 일정 API를 기반으로 이러한 확인 정보를 제공해야 합니다. 게스트에게는 추가 결제 요청과 관련된 Vrbo 이메일만 발송됩니다.

Q. Rapid 취소 API를 통해 Vrbo on Rapid 예약을 취소할 수 있나요?
A. 예, 모든 Vrbo on Rapid 예약은 Rapid 일정 응답에서 취소 토큰을 사용하여 취소할 수 있습니다. 또는 고객은 숙박 시설 관리자나 지원팀에 취소를 요청할 수 있습니다.

Q. Vrbo는 웹사이트에서 예약 후 어떤 기능을 제공하나요?
A. 파트너 사이트에서 이루어진 Vrbo 예약은 고객의 Vrbo 계정에서 액세스할 수 없습니다.

Q. Vrbo 예약은 어떻게 변경할 수 있나요?
A. 예약 취소 후 재예약하는 것이 권장되지만, 게스트는 호스트와 직접 연락하거나 고객 지원팀을 통해 변경 요청을 제출하여 Vrbo 예약을 변경할 수 있습니다.

Q. 예약 변경 또는 취소에 대한 신속한 알림을 받을 수 있나요?
A. 'Rapid 알림'을 구독하신 경우, 예약이 변경되거나 취소되면 알림을 받게 됩니다. 현재로서는 누가 예약을 변경했는지 확인할 수 없다는 점을 유의해 주시기 바랍니다.

Q. Vrbo 호스트 대화는 숙박 시설 메시지 센터와 연동되나요?
A. Conversation API를 사용하려면 ‘ Host-traveler ’ 통신이 필수입니다.

Q. 고객은 체크인 정보를 어떻게 받나요?
A. 도착 72시간 전에 투숙객에게 환영 안내서를 보내야 할 책임은 귀하에게 있습니다. 이 시작 가이드의 콘텐츠는 Rapid 일정 API의 Rapid 기본 숙박 콘텐츠에서 가져온 것입니다. 모든 호스트가 이 기능을 활용하는 것은 아니라는 점을 알려드립니다. 대신, 많은 호스트들은 Conversation API를 통해 게스트에게 환영 가이드를 메시지로 보내곤 합니다. 투숙객이 도착 48시간 전까지 도착 안내를 받지 못한 경우, 호스트에게 연락하거나 대체 숙소를 찾을 수 있도록 고객 지원팀에 문의하도록 안내해 주셔야 합니다.

>> ‘필수 체류’ 관련 콘텐츠를 더 읽어보세요

Q. Vrbo 예약이 확정된 후 숙박 시설에서 예약을 취소할 수 있나요?
A. 예. 숙박 시설 관리자는 예약 후부터 고객 도착 전 사이의 기간에 언제든지 Vrbo 예약을 취소할 수 있습니다. 이는 주로 숙박 시설 관리자가 해당 날짜에 더 이상 숙박 시설을 예약할 수 없다는 사실을 알게 되는 경우, 예약 생성 후 하루 이내에 발생합니다. 이러한 상황이 투숙객 도착 전에 발생할 경우, VrboCare 을 통해 투숙객이 적절한 대체 숙소를 찾을 수 있도록 지원해 드립니다. 자세한 내용은 Vrbo on Rapid 지원 가이드를 참조해 주세요.

>> #에 대해 알아보기VrboCare

Q. 호스트가 예약을 취소하면 위약금이 있나요?
A. 예. 또한, 숙박 시설 관리자의 취소 빈도는 프리미어 호스트 자격을 결정하는 요소 중 하나이며, 검색 결과에서 숙박 시설의 노출 순위에도 영향을 미치기 때문에, 숙박 시설 관리자들은 꼭 필요한 경우가 아니면 취소를 하지 않도록 주의하고 있습니다. 최고의 호스트 지위를 활용하여 검색 결과 상단에 최고의 숙박 시설를 노출시키면 이러한 위험을 완화하는 데 도움이 될 수 있습니다.

고급 통합 가이드

고급 시나리오: 환불 가능한 손해 보증금(RDD)

일부 Vrbo 숙박 시설은 도착 전에 파손 보증금 내도록 요구하며, 숙박 시설 상태에 따라 출발 후 환불을 제공합니다. RDD 금액이 높을 수 있어 귀하와 고객 모두에게 부담이 될 수 있으므로, 검색 결과에서 이러한 숙박 시설 항목을 제외할 것을 강력히 권장합니다.

RDD 정보

  • RDD를 요청하는 숙박 시설은 연휴 같은 성수기에 더 자주 발생할 수 있습니다.
  • 숙박 시설의 약 2%는 도착 전에 환불 가능한 파손 보증금을 내도록 요구합니다.
  • RDD 금액과 요구 사항은 지역과 계절에 따라 다를 수 있습니다.

고객은 다음 사항을 숙지해야 합니다.

  • 파손 보증금 결제는 마지막으로 예약한 (또는 단일 결제의 경우 예약 시점의) 결제 방법으로 진행됩니다.

RDD 예시

  • 파손 보증금 환불은 호스트가 검사한 결과에 따라 출발 후 14일 안에 처리됩니다.
  • 숙박 시설이 파손된 경우 Vrbo는 고객에게 이메일로 파손 청구서를 보냅니다.
  • 환불 가능한 파손 보증금은 결제 시 표시해야 합니다.
  • Rapid 조회 API에 표시된 RDD 금액은 추정치입니다. Rapid 가격 확인에 나오는 금액은 고객에게 청구되는 금액이며 결제 시 고객에게 표시되어야 합니다.

공식 판매자(Merchant of Record)로서의 파트너

  • 가상 카드를 통해 결제를 진행할 때는, 투숙객과의 보증금 징수 및 환불 절차를 원활하게 처리할 수 있는 경우가 아니라면 RDD를 제외할 것을 권장합니다.
  • 손님에게 금액을 안내하고, 그에 따라 요금을 징수하거나 환불하는 것은 귀하의 책임입니다.

예시:

"rates": [
    {
        "refundable_damage_deposit": {
            "value": "150.00",
            "currency": "USD"
        }  
    }
]

고급 시나리오: 고객 신용카드

고객 신용 카드를 사용하려면 추가 확인을 진행하고 고객과 커뮤니케이션해야 합니다.

주소 확인

일부 국가에서는 우편번호를 요구하지 않는 반면, 일부 국가에서는 추가 정보를 요구하기 때문에, Vrbo 예약의 경우 다른 숙박 옵션과는 다른 주소 확인 절차가 필요합니다.

우편번호가 있는 국가들

countries-with-postal-codes

우편번호가 없는 국가

countries-without-postal-codes

지원 대상 국가 목록은 부록 4를 참조하십시오.

고급 시나리오: 결제 일정

Vrbo 숙박 시설은 때때로 사전 정의된 일정에 따라 대금을 회수합니다. 이 숙박 시설는 파트너 프로필 설정을 통해 활성화하거나 비활성화할 수 있습니다. 지불 일정이 있는 경우, 조회 API의 Rapid에 숙박 시설 Collect와 일치하도록 예치금으로 표시됩니다.

>> Rapid의 예금에 대해 더 알아보기 조회 API

보증금(결제 일정) 정보

  • 약 20~30%의 숙박 시설은 3개월을 초과하는 긴 예약 기간을 결제 일정으로 제공합니다.
  • 약 15% 미만의 숙박 시설은 1개월 미만의 짧은 예약 기간을 결제 일정으로 제공합니다.

고객은 다음 사항을 숙지해야 합니다.

결제 일정 세부 정보는 쇼핑/check-out, 과정에서, 가급적이면 시각적인 타임라인 형태로 표시되어야 합니다.

예시:

"deposits": [
              {
               "value": "412.10",
               "due": "2027-05-17",
               "currency": "USD"
              },
              {
               "value": "236.17",
               "due": "2027-08-24",
               "currency": "USD"
              }
             ]

payment-schedule-example

또한, 게스트에게는 제공된 일정에 따라 Vrbo 사이트에서 직접 결제를 완료해야 하며, 그렇지 않을 경우 호스트가 예약을 취소할 수 있다는 점을 반드시 알려야 합니다.

Vrbo는 고객이 결제 요구 사항을 알 수 있도록 결제 마감일 이전, 당일 및 이후에 이메일 알림을 보냅니다.

환불 가능한 보증금 포함

필요한 경우 RDD는 마지막 예약 결제의 일부로 청구됩니다. 단일 결제인 경우 RDD는 예약 시 징수됩니다.

파트너와 협력하여 공식 판매자로 등록됨

Vrbo.com의 수동 결제 요구 사항 때문에, 결제 일정이 있는 숙박 시설을 파트너가 MOR(Merchant of Record)로 예약하는 것은 권장하지 않습니다.

부록 1: 호스트 커뮤니케이션

숙박 시설 호스트와 여행자 간의 직접적인 소통을 원활하게 하려면 Conversation API를 연동해야 합니다.

숙박 시설 관리자 커뮤니케이션의 예는 다음과 같습니다.

  • 환영 메시지 및 숙박 시설 관리자 소개
  • 연락처 세부 정보
  • 정책 및 출발 전 알아둘 사항
  • 주소 및 찾아오시는 길
  • 열쇠함(키박스) 코드
  • 결제 일정
  • 임대 계약(필수일 수 있으며, 제공되지 않는 경우 숙박 시설 관리자가 예약을 취소할 수 있음)
  • 여권 사진 요청(필수일 수 있으며, 제공되지 않는 경우 숙박 시설 관리자가 예약을 취소할 수 있음)
  • 호스트가 메시지에 응답

부록 2: Vrbo 커뮤니케이션

Rapid API를 통해 이루어진 예약에는 다음 Vrbo 이메일이 표시되지 않습니다.

  • 예약 확인
  • 여행객이 취소한 예약
  • 숙박 시설에서 취소한 예약
  • 예약 환불 확인
  • 시작 가이드
  • 리마케팅
  • 숙박 시설 이용 후기 요청
  • 지원 경험 이용 후기 요청
  • 취소 후 고객 리타겟팅

추가 숙박 요금(예: 반려동물 동반 요금), 변경(추가 숙박), 파손 결제 등 기타 Vrbo 결제 관련 이메일이 고객에게 전송될 수 있습니다.

  • 추가 결제 요청
  • 결제 확인
  • 결제 수신됨
  • 숙박 시설 파손 신고

Vrbo.com과의 고객 상호 작용에 기반한 추가 이메일

  • 계정 생성
  • 비밀번호 재설정
  • 비밀번호 재설정 확인
  • 비밀번호 생성

고급 통합 시나리오와 관련된 Vrbo 이메일 템플릿:

  • 사기 취소
  • 파손 보증금 청구됨 - RDD가 있는 숙박 시설에만 해당
  • 파손 보증금 영수증 - RDD가 있는 숙박 시설에만 해당
  • 파손 보증금 수락됨 - RDD가 있는 숙박 시설에만 해당
  • 예정된 결제 기한 초과 - 결제 일정이 있는 숙박 시설에만 해당

부록 3: 고객 대면 브랜드

POS고객 대면 브랜드
프랑스Abritel
독일Fewo-Direct
호주Stayz
뉴질랜드Bookabach
기타Vrbo

부록 4: 주소 유효성 검사

주소 유효성 검증을 위해 다음 국가에서는 우편번호가 필요합니다.

  • 아르헨티나
  • 호주
  • 오스트리아
  • 브라질
  • 캐나다
  • 덴마크
  • 프랑스
  • 독일
  • 영국
  • 그리스
  • 이탈리아
  • 네덜란드
  • 노르웨이
  • 폴란드
  • 포르투갈
  • 스페인
  • 스웨덴
  • 튀르키예

부록 5: Stay-collected 수수료 예시

숙박 시설에서 징수하는 수수료에는 다음이 포함될 수 있습니다:

  • 행정료
  • 에어컨
  • 클럽
  • 전기
  • 난방
  • 온수 욕조
  • 인터넷
  • 세탁 시설/서비스
  • 리넨
  • 욕실용 리넨
  • 주차장
  • 수영장
  • 숙박 시설 요금
  • 물
이 페이지가 도움이 되었나요?
이 콘텐츠를 어떻게 개선하면 좋을까요?
더 나은 Developer Hub를 만드는 데 도움을 주셔서 감사합니다!