This is an auto-generated translation

숙박 시설로 예약 컨텍스트 공유하기

기업 파트너와 고객에게 원활한 경험 제공

개요

Rapid API 는 숙소 예약 시 추가 예약 컨텍스트를 공유하여 숙박 시설가 여행자에게 더 나은 서비스를 제공할 수 있는 옵션을 제공합니다. 특히 출장자에게 유용하지만 이에 국한되지 않습니다.

이러한 옵션은 숙박 시설에 도움이 됩니다:

  • 기업 및 TMC 관계 인식
  • 가상 신용 카드의 사용 시기 및 처리 방법 이해

주요 기능은 다음과 같습니다:

  • 파트너 및 고객 식별: 예약 출처에 대한 정보를 숙박 시설와 공유하세요(e.g. TMC 및 기업 고객).
  • 가상 신용카드 지침: 숙박 시설 픽업 예약에 가상 신용카드를 사용하는 방법에 대한 명확한 지침을 공유하세요.

특히 다음과 함께 사용할 때 유용합니다:

파트너 및 고객 식별

목적

파트너 및 고객 식별을 통해 예약 요청에 정보를 포함시켜 숙박 시설가 볼 수 있도록 할 수 있습니다:

  • 예약을 처리한 파트너(예: 특정 여행 관리 회사) 및/또는
  • 여행자를 고용하는 기업 고객

이러한 컨텍스트를 통해 숙박 시설는 예약 소스에 대한 향상된 가시성을 확보할 수 있습니다:

  • 여행자가 예약한 Rapid 파트너를 인식합니다.
  • 단골 고객 또는 고가치 기업 고객 인식하기
  • 더욱 맞춤화된 여행 경험 제공
  • 잦은 기업 출장자를 위한 치료의 연속성 유지

API 매개변수

예약 요청의 다음 필드를 사용하여 이 정보를 전송할 수 있습니다:

  • supplier_transparency (객체)
  • consent_to_share (부울, 공급업체와 데이터를 공유하려는 경우 필수)

파트너 또는 고객 이름 중 하나만 전달하거나 둘 다 전달할 수 있습니다.

주요 규칙:

  • consent_to_share 는 공급업체에 데이터를 전달하기 위해 Rapid API 에 필수입니다.
  • consent_to_sharetrue 이 아닌 경우 Rapid API 는 supplier_transparency 이 입력되어 있어도 파트너/클라이언트 정보를 공유하지 않습니다.

파트너 및 고객 식별 예시

{
  ...
  "supplier_transparency": {
    "point_of_sale_display_to_share": "PLS Partner Name",
    "company_name_to_share": "Corporate Client Name",
    "consent_to_share": true
  }
}

필드 세부 정보

필드세부 정보
point_of_sale_display_to_sharepartner-facing 또는 traveler-facing 레이블(예: TMC 또는 리셀러 브랜드)을 숙박 시설에 표시할 수 있습니다.
company_name_to_share여행자와 연결된 기업 고객 이름(예: 고용주).
consent_to_sharetrue, 최종 고객이 이 정보가 공급업체와 공유되는 데 동의했음을 Rapid API 에 알립니다(숙박 시설). 생략하거나 false, 정보가 전달되지 않습니다.

가상 신용 카드 지침

Context

기업 프로그램에서는 출장 비용을 지불하는 경우가 많습니다:

  • 여행자 개인 신용카드
  • 법인 결제 카드
  • 가상 신용 카드(VCC)

그러나 일부 숙박 시설에 대한 명확한 가이드라인이 없습니다:

  • 가상 신용 카드 인식 및 처리 방법
  • 가상 신용 카드로 승인되는 청구 항목
  • 카드 충전 가능 시기(유효 기간)

이는 체크인 및/또는 체크아웃 시 혼란을 초래하고 비즈니스 출장자에게 부정적인 경험을 제공할 수 있습니다.

목적

가상 신용카드 지침은 숙박 시설에 대한 체계적인 지침을 제공합니다:

  • 가상 신용 카드가 숙박 시설 픽업 예약에 사용되는지 여부
  • 보장되는 비용(숙박비, 세금, 특정 부대 비용 등)
  • 모든 청구 한도 및 유효 기간
  • 문제가 발생했을 때 카드 연락처에 연락하는 방법

API 매개변수

이 지침은 다음을 사용하여 예약 요청 내에 추가됩니다:

  • 결제 배열입니다:
    • type``virtual_card사용 시 가상 신용 카드를 식별합니다.
  • additional_handling 객체(결제 항목 내)는 다음과 같은 자세한 결제 처리 지침을 제공합니다:
    • authorized_expenses
    • specified_incidental_expenses
    • total_charges_allowed
    • is_cvc_required
    • authorizing_company
    • card_contact
    • payment_allowable_period_start
    • payment_allowable_period_end

additional_handling객체는 선택 사항이지만 권장됩니다.

추가 취급이 가능한 가상 신용 카드 예시

{
 ...
 "지불": [
 {
 "type": "virtual_card",
 "number": "4111111111111111",
 "security_code": "123",
 "expiration_month": "08",
 "expiration_year": "2025",
 "billing_contact": {
 "given_name": "John",
 "family_name": "Smith",
 "주소": {
 "line_1": "555 1st St",
 "line_2": "10층",
 "line_3": "12층",
 "city": "Seattle",
 "state_province_code": "WA",
 "postal_code": "98121",
 "country_code": "US"
 }
 },
 "additional_handling": {
 "authorized_expenses": "total_plus_incidentals",
 "specified_incidental_expenses": [
 "breakfast",
 "internet"
 ],
 "total_charges_allowed": {
 "value": "875.00",
 "통화": "USD"
 },
 "is_cvc_required": true,
 "authorizing_company": "컨페르마",
 "card_contact": {
 "이메일": "chucktesta@mydomain.com",
 "전화": {
 "country_code": "1",
 "area_code": "555",
 "번호": "5555555"
 }
 },
 "payment_allowable_period_start": "2024-01-01",
 "payment_allowable_period_end": "2025-08-01"
 }
 }
 ]
}

### 주요 추가 처리 필드

| 필드 | 세부 정보 |
| ----- | ----- |
| `authorized_expenses` | 가상 신용카드를 사용할 수 있는 용도를 나타내는 상위 수준 규칙입니다, e.g.<br><br>• `room_only`<br>• `room_and_tax`<br>• `total_plus_incidentals` |
| `specified_incidental_expenses` | 허용되는 특정 부대 서비스 목록(예: 조식 또는 인터넷) |
| `total_charges_allowed` | 요금에 대한 명시적인 상한선<br><br> • 값: 최대 금액<br>• 통화: 통화 코드(e.g. USD) |
| `is_cvc_required` | 카드 충전을 위해 숙박 시설에 CVC가 있어야 하는지 여부를 나타냅니다. |
| `authorizing_company` | 가상 신용 카드를 발급하거나 관리하는 회사 이름(예: 가상 신용 카드 제공업체 또는 법인) |
| `card_contact` | 숙박 시설 카드 충전에 문제가 발생할 경우 연락처 정보:<br><br>• `email`<br>•`phone.country_code, phone.area_code, phone.number` |
| `payment_allowable_period_start / payment_allowable_period_end` | 카드 청구가 유효한 날짜 범위(보통 숙박 날짜에 약간의 버퍼를 더한 기간)입니다. |
이 페이지가 도움이 되었나요?
이 콘텐츠를 어떻게 개선하면 좋을까요?
더 나은 Developer Hub를 만드는 데 도움을 주셔서 감사합니다!