숙박 시설와 예약 정보를 공유하기
기업 파트너와 고객에게 원활한 경험을 제공
개요
Rapid API 숙박 예약 시 추가 예약 정보를 공유함으로써 숙박 시설가 여행객에게 더 나은 서비스를 제공할 수 있도록 지원하는 옵션을 제공합니다. 이 서비스는 특히 출장객들에게 유용하지만, 이에 국한되지는 않습니다.
다음 옵션들이 숙박 시설에 도움이 됩니다:
- 파트너를 알아보기
- 가상 신용카드가 언제 사용되는지, 그리고 이를 어떻게 처리해야 하는지 이해하기
주요 기능은 다음과 같습니다:
- 파트너 및 고객 식별: 예약 경로(e.g., TMC 및 기업 고객)에 대한 정보를 숙박 시설와 공유해 주세요.
- 가상 신용카드 사용 안내: 숙박 시설 콜렉트 예약 시 가상 신용카드를 어떻게 사용해야 하는지에 대한 명확한 지침을 제공해 주세요.
다음과 함께 사용하면 특히 유용합니다:
>> Booking API에 대한 자세한 내용은 여기에서 확인하세요.
파트너 및 고객 식별
목적
파트너 및 고객 식별 정보를 통해 예약 요청에 정보를 포함하면 숙박 시설가 다음 내용을 확인할 수 있습니다:
- 예약은 어느 파트너사(예: 특정 여행 관리 회사)가 담당했습니까? 및/또는
- 어떤 기업 고객이 해당 출장자를 고용하고 있는가
이러한 맥락을 통해 숙박 시설는 예약 출처에 대한 가시성을 높여 다음과 같은 이점을 얻을 수 있습니다:
- 여행자가 어떤 Rapid 파트너를 통해 예약했는지 확인하세요
- 단골 기업 고객이나 고가치 기업 고객을 파악하십시오
- 고객 한 분 한 분에게 더욱 맞춤화된 여행 경험을 제공해 드립니다
- 출장이 잦은 직장인을 위한 치료의 연속성 유지
API 매개변수
예약 요청서의 다음 입력란을 통해 이 정보를 전송할 수 있습니다:
supplier_transparency(객체)consent_to_share(부울형, 공급 업체와 데이터를 공유하려면 필수)
파트너 이름이나 고객 이름 중 하나, 또는 둘 다 전달할 수 있습니다.
주요 규칙:
consent_to_shareRapid API 가 공급업체에 데이터를 전달하기 위해서는 이 과정이 필수적입니다.consent_to_share가true와 다를 경우,supplier_transparency에 값이 입력되어 있더라도 Rapid API 는 파트너/클라이언트 정보를 공유하지 않습니다.
파트너 및 고객 식별 예시
{
...
"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_share | 숙박 시설가 확인해야 할 ‘ partner-facing ’ 또는 ‘ traveler-facing ’ 라벨(예: TMC 또는 리셀러 브랜드). |
company_name_to_share | 여행자와 관련된 기업 고객명(예: 고용주). |
consent_to_share | true가 Rapid API 에 최종 고객이 해당 정보를 공급업체(숙박 시설)와 공유하는 데 동의했다고 알릴 때. 이 항목을 생략하거나 false``로 설정하면 해당 정보는 전달되지 않습니다. |
가상 신용카드 사용 안내
Context
기업 프로그램은 대개 다음과 같은 방법을 조합하여 출장 비용을 지급합니다:
- 여행자용 개인 신용카드
- 기업용 결제 카드
- 가상 신용카드(VCC)
그러나 일부 숙박 시설는 다음 사항에 대해 명확한 지침이 부족합니다:
- 가상 신용카드를 식별하고 처리하는 방법
- 가상 신용카드에서는 어떤 결제 항목이 승인되나요?
- 카드를 충전할 수 있는 시기 (유효 기간)
이로 인해 체크인 및/또는 체크아웃 시 혼란이 발생할 수 있으며, 출장객들에게 부정적인 경험을 안겨줄 수 있습니다.
목적
가상 신용카드 사용 안내서는 숙박 시설에게 다음 사항에 대해 체계적인 지침을 제공합니다:
- 숙박 시설 콜렉트 예약에 가상 신용카드가 사용되었는지 여부
- 어떤 비용이 포함되나요(객실 요금, 세금, 지정 된 부대비용 등)?
- 이용 한도 및 유효 기간
- 문제가 발생했을 때 카드 담당자에게 연락하는 방법
API 매개변수
이 지침은 결제 배열을 통해 예약 요청 내에 추가되며, type 가 사용될 때 virtual_card 는 가상 신용카드를 식별합니다.
(결제 항목 내의) additional_handling 객체는 다음과 같은 상세한 결제 처리 지침을 제공합니다:
authorized_expensesspecified_incidental_expensestotal_charges_allowedis_cvc_requiredauthorizing_companycard_contactpayment_allowable_period_startpayment_allowable_period_endmax_payment_attempt_count
additional_handling객체는 선택 사항이지만, 사용을 권장합니다.
추가 수수료가 적용된 가상 신용카드 예시
{
...
"payments": [
{
"type": "virtual_card",
"number": "4111111111111111",
"security_code": "123",
"expiration_month": "08",
"expiration_year": "2028",
"billing_contact": {
"given_name": "John",
"family_name": "Smith",
"address": {
"line_1": "555 1st St",
"line_2": "10th Floor",
"line_3": "Unit 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",
"currency": "USD"
},
"is_cvc_required": true,
"authorizing_company": "Conferma",
"card_contact": {
"email": "chucktesta@mydomain.com",
"phone": {
"country_code": "1",
"area_code": "555",
"number": "5555555"
}
},
"payment_allowable_period_start": "2027-01-01",
"payment_allowable_period_end": "2028-08-01"
}
}
]
}주요 추가 처리 필드
| 필드 | 세부 정보 |
|---|---|
authorized_expenses | 가상 신용카드를 어떤 용도로 사용할 수 있는지를 명시하는 상위 수준의 규칙, e.g. • prestay_expenses_only• total_booking_amount• total_plus_incidentals• see_authorization_form참고: “ see_authorization_form ”는 카드 발급사나 승인 업체에서 보낸 승인 양식을 참조해야 함을 의미합니다. |
specified_incidental_expenses | 허용되는 구체적인 부대비용 목록 (예: 조식 또는 인터넷) |
total_charges_allowed | 요금에 대한 명확한 상한선 • 값: 최대 금액 • 통화: 통화 코드 (e.g. USD) |
is_cvc_required | 숙박 시설가 카드 결제를 진행하기 위해 CVC가 반드시 있어야 하는지 여부를 나타냅니다. |
authorizing_company | 가상 신용카드를 발행하거나 관리하는 회사의 명칭 (예: 가상 신용카드 제공업체 또는 법인) |
card_contact | 숙박 시설에서 카드 충전 시 문제가 발생할 경우 연락처 정보: • email• phone.country_code, phone.area_code, phone.number |
payment_allowable_period_start / payment_allowable_period_end | 카드가 결제 수단으로 유효한 기간(대개 숙박 기간에 약간의 여유 기간을 더한 기간과 일치함). |