consent_to_share Rapid 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_expenses
- specified_incidental_expenses
- total_charges_allowed
- is_cvc_required
- authorizing_company
- card_contact
- payment_allowable_period_start
- payment_allowable_period_end

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. • `room_only` • `room_and_tax` • `total_plus_incidentals`
`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`	카드가 결제 수단으로 유효한 기간(대개 숙박 기간에 약간의 여유 기간을 더한 기간과 일치함).