Rapid Lodging API：B2Cスタンドアロン立ち上げ要件
これらのローンチ要件は、business-to-consumer（B2C）統合モデルで、旅行者が統合と直接やり取りする場合に適用されます。
概要
これらの要件は2つのセクションに分類されています：
スタンドアロン要件： これらはこの予約フローに固有のものです。これらの要件は、以前に統合した他の料金タイプ / 予約フローとは異なる場合があるため、注意深くお読みください。
共通要件 : すべての予約フローに共通している要件です。すべてのフローでこれらすべての要件を満たしていることをご確認ください。
注: 以下の各要件には、カスタマーサービスチームがお客様をサポートするための参照コードが含まれています。
チェックリスト
チェックリスト を作成しましたので、開発をサポートしたり、要件に関するフィードバックを提供したりする際にお役立てください。サイトレビューのスクリーンショットを提供する場合は、チェックリストにスクリーンショットと対応するログを追加してください。これにより、レビューの完了が円滑に進みます。
B2Cインプリメンテーション
共通要件
以下のローンチ要件は、すべての予約フローに適用されます。表示価格の詳細な説明を含む、各料金タイプに固有の追加要件は、個別の料金要件リストで提供されます。
GR1：Expedia Groupの名称およびロゴの使用禁止
当社の名称およびロゴの使用は、traveler-facingまたはagent-facingのサイトにおいてのみ、例外として当社の書面による明確な事前承認がある場合に限り可能です。
例 :
GR2：利用規約URLへのリンクを表示
あなたのサイトの利用規約のテキスト内に当社の利用規約へのリンクを提供するか、あなたの予約ページから直接利用規約にリンクしてください。これらの規約には、予約管理のポリシーが詳述されています。easy-to-find、「Supplier Terms and Conditions（サプライヤー規約）」というリンク文言を使用して、以下のリンクを設置してください。
弊社がサポートする各言語の規約のバージョンは、このRapid API規約ページ から入手できます。
例 :
GR4：Expedia Groupが加盟店（MoR）である場合のクレジットカード規定の適切な使用と表示
旅行者のカード会員情報を取得、使用、送信、保存、または処理する場合、PCIセキュリティ基準審議会が発行したPayment Card Industry Data Security Standard（PCI DSS）を遵守するものとします。これらの規制に関する完全なリファレンスは、公式サイトPCIセキュリティ基準 でご覧いただけます。
GR5: 施設のコレクトまたはExpedia GroupがMoRである場合（該当する場合）、PCI準拠の証拠を提出してください。
Expedia Groupまたは 施設 がMoRの場合、PCI準拠の証拠として準拠証明書（AOC）を提出する必要があります。PCIコンプライアンスに関するアドバイスは、公式サイト（PCI Security Standards）。
SP1: 予約に子供が含まれている場合、適切なメッセージと子供の年齢の入力を実装します。
お子様のご旅行が可能な場合、ご旅行の際にお子様の年齢を指定することができます。check-in. この情報は、occupancy 要素により提供されます (下記のコードサンプルを参照)。
旅行者が小児旅行者を指定した場合、APIレスポンスには年齢制限および/または追加客室料金やベビーベッド料金が含まれる場合があり、予約のコストや適格性に影響を与える可能性があります。
子供とみなされる年齢の範囲は、ホテルごとに設定されます。多くの場合、17 歳以下が子供とみなされます。一部の施設では、18 歳未満の宿泊を許可していません。
API リクエストの例 :
https://api.ean.com/v3/properties/availability?checkin=2020-09-11
&checkout=2020-09-14
¤cy=USD&language=en-US& occupancy=2-9,4 &property_id=XXXX
&country_code=XX&sales_channel=XXXX
&sales_environment=XXXX&filter=XXXX&rate_plan_count=XXXX
&rate_option=XXXX&billing_terms=XXXX&payment_terms=XXXX
&partner_point_of_sale=XXXX&platform_name=XXXX**API レスポンスの例 : **
"occupancies": {
"2-9,4" : {
"nightly": [
[ユーザーインターフェースの例 1大人2人、9歳と4歳の子供2人の部屋
AP1: 各部屋のベッドタイプの説明を表示します。
ショッピングAPIのレスポンス は、単一の値または複数のオプションを持つbed_groups 配列を返します。設定配列に含まれる値を表示し、旅行者のベッドの選択を説明します。
bed_groups配列が複数のオプションで返された場合、旅行者が選択できるように、各ベッドタイプのショッピングレスポンスで提供されるprice_check リンクを表示します。
同じ客室に複数ベッドタイプのオプションを選んだお客様に対しては、リクエストはできるものの、空室状況によってはホテルで受け付けられない場合があるというメッセージを表示しなければなりません。
部屋名はShoppingレスポンスのrooms配列内でroom_name として返されます。
**API レスポンスの例 : **
"property_id": "11775754",
"rooms": [
{
"id": "230434524",
"room_name": "Superior double room" ,
"rates": [
{
...
"bed_groups": {
"133243": {
"id": "133243",
"description": "Double bed" ,
"links": {...},
"configuration": [...]
},
"133242": {
"id": "133242",
"description": "2 single beds" ,
"links": {...},
"configuration": [...]
}
},**ユーザー インターフェースの例 : **
AP2:non-refundableの旗をはっきりと見えるようにします。
Non-refundable refundable=falseShopping API availability responseの。 空室状況のレスポンスでrefundable=false が返された場合は、該当する客室を明確に表示してください。この値は、どのポリシーデータよりも常に優先されます。これらの予約はいかなる場合においても払い戻しいたしません。
**API レスポンスの例 : **
"property_id": "XXXX",
"rooms":
"id": "XXXX",
"room_name": "Fairmont King",
"rates":
"id": "XXXX",
"status": "available",
"available_rooms": 4999,
"refundable": false ,
"deposit_required": false,
"merchant_of_record": "expedia",**ユーザー インターフェースの例 : **
AP3:check-inの表示と特別な指示
checkin,checkout,fees,policies オブジェクトの内容は、コンテンツ 施設 定義で返されるように、部屋ごとに表示されなければなりません。この情報は、check-inで発生する可能性のある料金や、特別なアクセス方法について旅行者が確実に認識できるよう、空室状況ページに表示する必要があります。
special_instructionscheck-in checkin``instructions例えば、到着予定時刻を施設に通知する要件、ゲストビルとは異なる場所でのcheck-in、電子メールによる施設からの特別なcheck-in指示を期待するアラートなど。
旅行者に対して同じエリア内に instructions と special_instructions の両方を必ず表示してください。
**API レスポンスの例 : **
"11775754": {
"property_id": "11775754",
"checkin": {
"begin_time": "16:00 PM",
"end_time": "4:00 AM",
"instructions": "Minimum age to check in is 18 years old.
Extra-person charges may apply and vary depending on property policy.
Government-issued photo identification and a credit card may be required at
check-in for incidental charges.
Special requests are subject to availability upon check-in and
may incur additional charges. Special requests cannot be guaranteed.",
"special_instructions": "Front desk staff will greet guests on arrival. For more details,
please contact the property using the information on the booking confirmation.",
"min_age": 18
"checkout": {
"time": "11:00 AM"
"fees": {
"mandatory": "You'll be asked to pay the following charges at the property:
Deposit: USD 50 per day
Resort fee: USD 28.25 per accommodation, per night The resort fee includes: Pool access, Fitness center access, Fitness/yoga classes, Airport shuttle, Phone calls, In-room safe, Self parking, Valet parking, Parking. We have included all charges provided to us by the property.
However, charges can vary, for example, based on length of stay or the room you book.",
"optional": "The following fees and deposits are charged by the property at time of service,
check-in, or check-out. Breakfast fee: between USD 6 and USD 25 per person
(approximately), Late check-out is available for a fee (subject to availability)Rollaway bed fee: USD 20.0 per night.
The above list may not be comprehensive. Fees and deposits may not include tax and are subject to change."
"policies": {
"know_before_you_go": "Up to 2 children 12 years old and younger stay free when
occupying the parent or guardian's room, using existing bedding.
The property has connecting/adjoining rooms, which are subject to availability
and can be requested by contacting the property using the number on the booking
confirmation."**ユーザー インターフェースの例 : **
BP1: 個人情報のSSL暗号化の使用
個人データを送受信する場合は、SSL 暗号化を使用して、クライアントのブラウザ / アプリケーションとサイト間の接続、および依存システムとのネットワーク通信を保護する必要があります。個人データには、お客様の名前、電話番号またはメールアドレス、決済カードの詳細、予約 / 旅程の受領と確認のページが含まれます。接続が保護されていない場合は、接続を停止またはリダイレクトします。
BP2：ディスプレイcheck-inおよび特別な指示
checkin,checkout,fees,policies オブジェクトの内容は、コンテンツ 施設 定義で返されるように、部屋ごとに表示されなければなりません。この情報は、旅行者が予約を確定する前に、check-inで発生する可能性のある料金や特別なアクセス方法を確実に認識できるように表示する必要があります。
special_instructionscheck-in checkin``instructions例えば、到着予定時刻を施設に通知する要件、ゲストビルとは異なる場所でのcheck-in、電子メールによる施設からの特別なcheck-in指示を期待するアラートなど。
旅行者に対して同じエリア内に instructions と special_instructions の両方を必ず表示してください。
BP3: キャンセルポリシーとnon-refundableタグを分かりやすく表示します。
旅行者が最終予約ページで購入を確定する前に、選択した客室のキャンセルポリシーまたはnon-refundableタグを提供する必要があります。各料金のキャンセルポリシーは、Rapid Shopping Availability APIのcancel_penalties オブジェクト内で提供されます。
返金可の料金の場合、レスポンスには一連のキャンセルポリシーの詳細が含まれます。詳細には、指定されたキャンセル料の適用開始日と終了日、およびキャンセル料のタイプ、値、適用される例外予約期間が含まれます。キャンセル料のタイプには、固定金額、宿泊数、合計料金に対する割合が含まれます。
| レスポンス | 意味 |
|---|---|
refundable=true | この料金は全額返金可能です。 |
refundable=true + cancel_penalties | • この料金は、キャンセル期間内であれば払い戻しが可能です。 • 最も早い cancel_penalties.[].start、将来のタイムラインであれば、無料キャンセル期限となります。• レートは100%non-refundable cancel_penalties.[].end |
refundable=false | • このレートはnon-refundable. • キャンセル料適用期間は返されません。 |
refundable=false + cancel_penalties | • 料金の一部は払い戻し可能です。 • cancel_penaltiesは、nonrefundable_date_ranges と共に表示される必要があります。予約が作成されると、この範囲の滞在日がnon-refundableであることが示されます。 |
詳しくはこちらキャンセルポリシーの作り方.
参考ページ :
refundable=false:non-refundable cancel_penaltiesとnonrefundable_date_ranges に詳細が記載されています。
nonrefundable_date_ranges:この範囲の宿泊日は、予約が作成されるとnon-refundable。
cancel_penalties :
nonrefundable_date_rangesに含まれない滞在期間に適用されます。cancel_penaltiesが空欄か返されない場合、料金は 100% 返金不可です。cancel_penaltiesの期間内にキャンセルするとキャンセル料が発生します。- 最も早い
cancel_penalties.[].startは無料のキャンセル期限です。それが将来の日付である場合、最新のcancel_penalties.[].end以降の料金は 100% 返金不可です。
**API レスポンスの例 : **
全額返金可 :
"property_id": "XXXX",
"rooms": [
{
"id": "XXXX",
"room_name": "Traditional Room",
"rates":
"id": "XXXX",
"status": "available",
"available_rooms": 4999,
"refundable": true,
"cancel_penalties": [
{
"start": "2021-05-27T18:00:00.000-07:00",
"end": "2021-05-28T18:00:00.000-07:00",
"amount": "76.00",
"currency": "USD"返金不可 :
"property_id": "XXXX",
"rooms":
"id": "XXXX",
"room_name": "Traditional Room",
"rates":
"id": "XXXX",
"status": "available",
"available_rooms": 4999,
"refundable": false ,
"deposit_required": false,
"merchant_of_record": "expedia",一部返金可 :
"property_id": "XXXX",
"rooms": [
{
"id": "XXXX",
"room_name": "Traditional Room",
"rates":
"id": "XXXXXXXX",
"status": "available",
"available_rooms": 4999,
"refundable": false,
"cancel_penalties": [
{
"start": "2023-09-03T13:59:00.000+02:00",
"end": "2023-09-04T13:59:00.000+02:00",
"nights": "1",
"currency": "USD"
}
],
"nonrefundable_date_ranges": [
{
"start": "2023-09-08",
"end": "2023-09-13"
}
],**ユーザー インターフェースの例 : **
BP4: 施設で支払うべき料金を、料金の内訳に別途表示します。
料金が fees 配列で返される場合、各値を施設で支払う料金 (チェックインまたはチェックアウト) として個別に表示します。旅行者に現地通貨を提示し、通貨を要求します。これらの料金は、施設によって直接徴収されるものであり（当社や地方自治体によって徴収されるものではありません）、税金・料金の項目に含まれる標準的な税金回収料金、税金、料金の一部ではありません。
**API レスポンスの例 : **
"fees" : {
"resort_fee": {
"request_currency": {
"value": "74.97",
"currency": "USD"
},
"billable_currency": {
"value": "74.97",
"currency": "USD"
},
"scope": "per_accommodation",
"frequency": "per_night"
}
},**ユーザー インターフェースの例 : **
BP7: 子供の年齢をもう一度（該当する場合）
お子様連れのご旅行が可能で、ご旅行者がお部屋の選択にお子様連れのご旅行者を指定された場合、予約ページでお子様連れの人数と年齢を明確に確認する必要があります。この情報は、child_ages 要素により提供されます。
BP8: エンドトラベラーからの支払いがいつ行われるかを明記してください（施設collectの場合、またはExpedia GroupがMoRの場合）。
Expedia GroupがMoRの場合、提供されたクレジットカードに予約金額全額が直ちに請求されることを明記します。
施設で徴収する場合、提示したクレジットカードでチェックインまたはチェックアウト時に施設により課金されることを明示します。もし施設がnon-refundable post-payレートを提供している場合は、代わりに予約完了後すぐに施設から旅行者に請求が来る可能性があることを示してください。
BP9: 欧州経済領域規制の遵守。
欧州経済地域（EEA）では、旅行者と取引を行う場合、強固な顧客認証（SCA）への準拠が義務付けられています。
Expedia GroupはMoRか施設コレクトです。
Expedia GroupがMoRである場合、または施設Collectが欧州経済地域（EEA）または日本の旅行者に使用される場合、予約経路にはRapidのAPIの採用が含まれている必要があります。two-factor認証。
アフィリエイトMoR - 一般
旅行者との取引が規定の範囲内である場合は、SCAの要件（）に従わなければなりません。改正決済サービス指令（PSD2）の全文は、欧州委員会 でご覧いただけます。採用可能な準拠規格の詳細については、EMVCoの3D Secure Protocol and Core Functions Specification をご覧ください。
アフィリエイトMoR - コーポレートカードまたはバーチャルカード
EEAまたは日本国内で発行されたご自身のカードでお支払いの場合は、SCAの要件。two-factor認証（2FA）の必要性を軽減するために、B2B決済に準拠し、2FAが免除されるカードを使用することができます。
準拠オプションに含まれるもの :
- シングルユースのバーチャルカード
- 会社 (人ではない) に登録されているマルチユースの法人カード特別なプロファイル設定が必要です。
API リクエストの例 :
https://api.ean.com<Price Check link from previous availability request>**API レスポンスの例 : **
{
"status": "available",
"occupancy_pricing": {... },
"links": {
"payment_session": {
"method": "POST",
"href": "/v3/payment-sessions?token=XXXX"
}
}
}BP10:Expedia GroupがMoRの場合、決済処理場所をチェックアウトページに表示します。
Expedia GroupがMoRの場合、支払いが処理される国をチェックアウトページの目立つ場所に表示する必要があります。国名のあとに、「で支払いが行われます」のフレーズを挿入しなければなりません。
この情報を取得するには、Shopping API の支払いオプション機能を使用します。
API リクエストの例 :
https://api.ean.com<payment-options link from previous availability request>**API レスポンスの例 : **
"credit_card": {
"name": "Credit Card",
"card_options": [
{
"name": "MasterCard",
"processing_country": "US"
},
{
"name": "Visa",
"processing_country": "US"
}
]
}**ユーザー インターフェースの例 : **
