プロパティとの予約コンテキストの共有
企業パートナーや顧客にシームレスな体験を提供
概要
Rapid APIは、宿泊予約における追加的な予約コンテキストを共有することで、ホテルが旅行者により良いサービスを提供できるよう支援するオプションを提供しています。出張の多い方には特に便利です。
これらのオプションはプロパティに役立ちます:
- 企業とTMCの関係を認識
- ヴァーチャル・クレジットカードが使用される場合と、その取り扱い方法についての理解
主な特徴は
- パートナーおよびクライアントの識別:予約元(e.g. TMCおよび法人顧客)に関する情報をプロパティと共有します。
- ヴァーチャルクレジットカードの使い方:施設のコレクト予約にヴァーチャルクレジットカードをどのように使うべきか、明確なガイダンスを共有しましょう。
これらを併用すると特に便利です:
パートナーおよび顧客の特定
目的
パートナーやクライアントの識別情報をブッキングリクエストに含めることで、施設が確認できます:
- どのパートナーが予約を処理したか(例えば、特定の旅行管理会社) および/または
- 旅行者を雇用している企業は?
このコンテキストにより、プロパティは予約元を可視化し、以下のことが可能になります:
- 旅行者が予約したラピッドパートナーを認識
- リピーターや価値の高い企業ゲストの表彰
- オーダーメイドの旅行体験の提供
- 頻繁な企業出張者への継続的な対応
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_end
additional_handlingオブジェクトはオプションですが、推奨されます。
バーチャルクレジットカードの例
{
...
"payments":[
{
"type":"virtual_card",
"number":"4111111111111111",
"security_code": "123"、
"expiration_month": "08"、
"expiration_year": "2025"、
"billing_contact": {
"given_name": "John"、
"family_name": "スミス"、
"住所":{
"line_1":「555 1st St"、
"line_2":「10階
"line_3":「ユニット12
"city":「シアトル
"state_province_code": "WA"、
"postal_code": "98121"、
"country_code": "US"
}
},
"additional_handling": {
"authorized_expenses": "total_plus_incidentals",
"specified_incidental_expenses": [
"朝食"、
「インターネット
],
"total_charges_allowed": {
"value":"875.00",
「通貨":"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": "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>• currency: 通貨コード (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` | カードがチャージに有効な日付範囲(多くの場合、ご滞在日+若干のバッファー)。 |