宿泊施設との予約情報の共有

法人パートナーやクライアントの皆様に、シームレスな体験をご提供いたします

概要

Rapid API宿泊施設の予約において、予約に関する追加情報を共有することで、施設が旅行者により良いサービスを提供できるよう支援するオプションを提供しています。これらは、特にビジネス出張者の方々に役立ちますが、それだけにとどまりません。

これらのオプションは、物件にとって次のようなメリットがあります：

• パートナーを認識する
• バーチャルクレジットカードがどのような場面で使用されるのか、またどのように扱うべきかを理解しましょう

主な特徴は以下の通りです：

• パートナーおよび顧客の特定：予約元（e.g.、TMC、法人顧客）に関する情報を宿泊施設と共有します。
• バーチャルクレジットカードのご利用方法：施設 のコレクト予約において、バーチャルクレジットカードをどのように利用すべきかについて、わかりやすいご案内を共有してください。

これらは、以下のものと組み合わせて使用すると特に役立ちます：

• 旅行の目的
• ホテル ロイヤルティ ポイント
• 請求

>> Booking APIの詳細については、こちらをご覧ください。

パートナーおよびクライアントの身元確認

目的

パートナーおよびクライアントの識別情報により、予約リクエストに情報を記載することができ、施設 の方が以下の内容を確認できるようになります：

• どのパートナーが予約を手配しましたか（例：特定の旅行管理会社など）および／または
• その出張者を雇用しているのはどの法人顧客でしょうか

この仕組みにより、施設側は予約の出所をより明確に把握できるようになり、以下のことが可能になります：

• 旅行者がRapidパートナーを通じて予約したことを確認してください
• リピーターや高価値の法人顧客を特定する
• よりお客様一人ひとりに合わせた旅行体験をご提供いたします
• 頻繁に出張する社員の治療の継続性を確保する

APIパラメータ

この情報は、予約リクエストの以下の項目から送信することができます：

• supplier_transparency (オブジェクト)
• consent_to_share (ブール値。サプライヤーとデータを共有したい場合は必須です)

パートナー名、クライアント名、あるいはその両方を指定することができます。

主なルール：

• 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
  }
}

フィールドの詳細

バーチャルクレジットカードのご利用方法

Context

企業のプログラムでは、出張費の支払いに、以下の方法を組み合わせて利用することがよくあります：

• 旅行者向け個人用クレジットカード
• 法人向け決済カード
• バーチャルクレジットカード（VCC）

しかし、一部の物件では、以下の点について明確な指針が示されていない場合があります：

• バーチャルクレジットカードの見分け方と処理方法
• バーチャルクレジットカードでは、どのような利用が許可されていますか
• カードへのチャージが可能となる時期（有効期間）

これにより、チェックインやチェックアウトの際に混乱が生じたり、ビジネス出張者にとって不快な体験につながったりする可能性があります。

目的

バーチャルクレジットカードの利用手順では、施設に対し、以下の点について体系的なガイダンスを提供しています：

• 施設 のコレクト予約において、バーチャルクレジットカードが使用されているかどうか
• どのような費用が対象となりますか（宿泊費、税金、指定された諸経費など）
• 利用限度額および有効期限について
• 万が一問題が発生した場合、カード発行会社の担当者に連絡する方法

API パラメータ

これらの指示は、Bookingリクエスト内に、payments配列を使用して追加されます。この配列において、``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
• max_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"
      }
    }
  ]
}

主な追加処理フィールド