宿泊APIのリリース要件
Rapid Lodging APIを今すぐ使い始めましょう
Rapid Lodging APIの導入要件には、対象ユーザーを問わずすべての実装に適用される要件に加え、business-to-business（B2B）またはbusiness-to-consumer（B2C）での利用に関する具体的な要件が含まれています。これらの要件は、以前に統合した他の料金タイプ / 予約フローとは異なる場合があるため、注意深くお読みください。
注： 以下に記載されている各要件には、カスタマーサービスチームがお客様をサポートするための参照コードが含まれています。
要件
以下の要件は、Lodging APIのすべての実装に適用されます。
GR1：当社の名称およびロゴの使用について
当社の名称およびロゴの使用は、traveler-facingまたはagent-facingのサイト上でのみ許可されており、例外として、事前に当社からの明示的な書面による 承認を得た場合に限り使用することができます。
ユーザーインターフェースの例
GR2：表示する利用規約のURLへのリンク
お客様のサイトの利用規約の本文内に、当社の利用規約へのリンクを掲載するか、予約ページから直接利用規約へリンクを設定してください。これらの規約には、予約管理のポリシーが詳述されています。以下のリンクを、easy-to-findのページに、「サプライヤーの利用規約」というリンク文言を付けて配置してください。
当社が対応しているすべての言語版の利用規約は、サポートサイトでご覧いただけます。
ユーザーインターフェースの例 - B2B
ユーザーインターフェースの例 - B2C
GR4：Expedia Groupが登録Merchant（MOR）である場合の、クレジットカードに関する規定の適切な運用および表示
旅行者のカード会員データを取得、利用、送信、保存、または処理する場合は、PCIセキュリティ基準協議会が策定した「ペイメント・カード・インダストリー（PCI）データセキュリティ基準 」を遵守しなければなりません。
>> PCIセキュリティ基準評議会のウェブサイトにアクセスしてください
GR5：施設collectを使用する場合、またはExpedia GroupがMORである場合に、PCIコンプライアンスの証拠を提出してください（該当するパートナーのみ）。
Expedia GroupがMORであるか、施設 がMORであるかにかかわらず、PCIセキュリティ基準評議会の規定に従い、PCI準拠の証拠として「準拠証明書（AOC）」を提出する必要があります。
SP1：提携先が予約に子供を含めることを許可している場合における、適切な案内文および子供の年齢の入力
ご利用のシステムで同伴のお子様の搭乗が許可されている場合、チェックイン時に各お子様の年齢を指定できる機能を提供する必要があります。この情報は、occupancy オブジェクトを通じて提供されます（以下の例を参照してください）。
旅行者がお子様を同行者として指定した場合、APIの応答には、予約の料金や利用資格に影響を与える可能性のある年齢制限や、追加の宿泊料金、ベビーベッド利用料などが含まれる場合があります。
子供とみなされる年齢の範囲は、ホテルごとに設定されます。多くの場合、17 歳以下が子供とみなされます。一部の施設では、18 歳未満の宿泊を許可していません。
APIリクエストの例
https://api.ean.com/v3/properties/availability?checkin=2027-09-11
&checkout=2027-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=XXXXAPIの応答例
"occupancies": {
"2-9,4" : {
"nightly": [
[ユーザーインターフェースの例： 大人2名と、9歳と4歳の子供2名が宿泊する1室。
AP1：各客室ごとにベッドの種類に関する説明が記載されています
ショッピングのレスポンスには、単一の値または複数のオプションを含むbed_groups 配列が返される場合があります。旅行者のベッドの選択内容を記述するために、設定配列に含まれる値を表示してください。
bed_groups配列が複数のオプションを返す場合、旅行者が選択できるよう、各ベッドタイプについて、Shoppingレスポンスで提供される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": [...]
}
},ユーザーインターフェースの例 - B2B
ユーザーインターフェースの例 - B2C
AP2：Non-refundableの旗がはっきりと見えます
Non-refundable在庫状況は、Shopping APIの在庫状況レスポンスにおいて「refundable=false」として示されます。利用可能状況の応答で「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",ユーザーインターフェースの例 - B2B
ユーザーインターフェースの例 - B2C
AP3：Check-inおよび表示された特別な指示
checkin、checkout、fees、およびpolicies オブジェクトの内容は、Content APIの 施設 定義で返される通り、各部屋ごとに表示する必要があります。この情報は、旅行者がチェックイン時の追加料金や特別なアクセス方法について把握できるよう、空室状況ページに表示する必要があります。
特別な「check-in」フィールドには、「checkin」オブジェクトの「instructions」フィールドには含まれていない、「check-in」にとって重要な情報が含まれる場合があります。例えば、施設 への到着予定時刻の通知要件、ゲスト用建物とは異なる場所での「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.
<br />Extra-person charges may apply and vary depending on property policy.
<br />Government-issued photo identification and a credit card may be required at
check- in for incidental charges.
<br />Special requests are subject to availability upon check-in and
may incur additional charges. Special requests cannot be guaranteed. <ul>. ",
"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": "<p>You'll be asked to pay the following charges at the property:</p>
<ul><li>Deposit: USD 50 per day</li>
<li>Resort fee: USD 28.25 per accommodation,
per night</li></ul> The resort fee includes:<ul
><li>Pool access</li><li>Fitness center access</li><li>Fitness/yoga classes</li>
<li>Airport shuttle</li><li>Phone calls</li><li>In-room safe</li><li>Self parking</li>
<li>Valet parking</li><li>Parking</li></ul> <p>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. </p>",
"optional": "<p>The following fees and deposits are charged by the property at time of service,
check-in, or check-out. </p> <ul> <li>Breakfast fee: between USD 6 and USD 25 per person
(approximately)</li> <li>Late check-out is available for a fee (subject to availability)</li>
<li>Rollaway bed fee: USD 20.0 per night</li>
</ul> <p>The above list may not be comprehensive. Fees and deposits may not include tax
and are subject to change. </p>"
"policies": {
"know_before_you_go": "<ul> <li>Up to 2 children 12 years old and younger stay free when
occupying the parent or guardian's room, using existing bedding. </li>
<li>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. </li> </ul>"ユーザーインターフェースの例
BP1：個人データにはSSL暗号化が適用されています
個人データを送受信する場合は、SSL 暗号化を使用して、クライアントのブラウザ / アプリケーションとサイト間の接続、および依存システムとのネットワーク通信を保護する必要があります。個人データには、お客様の名前、電話番号またはメールアドレス、決済カードの詳細、予約 / 旅程の受領と確認のページが含まれます。接続が保護されていない場合は、接続を停止またはリダイレクトします。
BP2：Check-inおよび表示された特別な指示
checkin、checkout、fees、およびpolicies オブジェクトの内容は、Content APIの 施設 定義で返される通り、各部屋ごとに表示する必要があります。旅行者が予約を確定する前に、check-inに掲載されている可能性のある手数料 や、特別なアクセスに関する注意事項を確実に把握できるよう、この情報を表示する必要があります。
特別な「check-in」フィールドには、「checkin」オブジェクトの「instructions」フィールドには含まれていない、「check-in」にとって重要な情報が含まれる場合があります。例えば、施設 への到着予定時刻の通知要件、ゲスト用建物とは異なる場所での「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
- 予約が作成されるとすぐに返金不可の金額が発生します。
cancel_penaltiesとnonrefundable_date_rangesが詳細を提供します。
nonrefundable_date_ranges
- 予約が作成されると、この範囲の滞在期間は返金不可となります。
cancel_penalties
nonrefundable_date_rangesに含まれない滞在期間に適用されます。cancel_penaltiesが空欄か返されない場合、料金は 100% 返金不可です。cancel_penaltiesの期間内にキャンセルするとキャンセル料が発生します。- 将来のタイムラインの場合、最も早い
cancel_penalties.[].startは、無料キャンセル期限となります。 - 最新の
cancel_penalties.[].endの発表を受け、その割合は100％となっています。non-refundable
APIレスポンスの例：キャンセルポリシーおよびnon-refundableフラグ
"property_id": "11775754",
"rooms": [
{
"id": "230434524",
"room_name": "Traditional Room (Partner:Connect Test)",
"rates":
"id": "276321199",
"status": "available",
"available_rooms": 4999,
"refundable": true,
"cancel_penalties": [
{
"start": "2020-09-10T18:00:00.000-07:00",
"end": "2020-09-11T18:00:00.000-07:00",
"amount": "76.00",
"currency": "USD"ユーザーインターフェースの例
BP4：価格内訳に表示されている 施設 については、別途料金が発生します。
料金が fees 配列で返される場合、各値を施設で支払う料金 (チェックインまたはチェックアウト) として個別に表示します。旅行者に現地通貨をお渡しし、ご希望の通貨をお申し付けください。これらの料金は、施設 によって直接徴収されるものであり（当社や地方自治体によるものではありません）、税金および手数料の項目に含まれる通常の徴収手数料、税金、または手数料の一部ではありません。
APIの応答例：Fees配列
"fees" : {
"resort_fee": {
"request_currency": {
"value": "74.97",
"currency": "USD"
},
"billable_currency": {
"value": "74.97",
"currency": "USD"
},
"scope": "per_accommodation",
"frequency": "per_night"
}
},ユーザーインターフェースの例
BP5：価格表示には、合計金額に加え、税金および手数料の内訳を含める必要があります。
A) 合計価格
予約の合計価格は、お支払いページで旅行者に表示する必要があります。合計価格は API レスポンスと一致する必要があり、切り上げや切り捨て、通貨換算は許可されていません。最終的な内訳には、客室料金（合計額または1泊あたりの金額）、追加の1泊あたりの料金（後述の「property_fee」欄に記載されているものを除く）、滞在総額および税金、請求総額を含める必要があります。また、現在お支払いいただく金額と、施設で後日お支払いいただく金額を明記してください。
注： B2BおよびB2Cの両方において、ダイナミックパッケージ用ホテル料金 および公開されている ダイナミックパッケージ用ホテル料金 の実装には、追加の価格表示要件が適用されます。
B) 税金の明細
価格の表示には、「tax_and_service_fee」と「property_fee」の合計額を、「税金および手数料」という見出しの1行にまとめて記載する必要があります。価格の内訳において、税金や手数料の合計額について言及する際は、以下の正確な文言を法的に表示することが義務付けられています。これは、pop-up, 形式のプレーンテキスト、モーダル、またはその他の形式で表示することができます。施設 の手数料は、チェックアウトページに個別に表示されないようにしてください。
「これらの税金は、販売業者（e.g. のホテル）に支払われる税金回収手数料です。詳細については、当社の利用規約をご覧ください。」サービス手数料は、ご予約の手配に対する報酬として徴収されるものであり、提携先が請求する手数料が含まれる場合があります。
>> 翻訳については、Expedia Partner Solutionsをご覧ください
tax_and_service_feeで返される金額には、税務管轄区域によって義務付けられている税金および手数料のみが含まれます。
C) パートナーサービス料と予約手数料
Expedia Groupが、追加のサービス料または予約手 数料を認める特例を適用する場合、それらは明確に区分されなければなりません。貴社が予約に追加されるサービス料を課す場合、その料金が貴社によって徴収されるものであり、Expedia Groupが別途のサービスに対して課すものではないこと（つまり、宿泊施設の提供に対する追加料金ではないこと）を、旅行者に明確に伝える必要があります。料金を、既存の税金や手数料の明細項目に含めることはできません。施設 から課されるいかなる料金についても、「手数料」という言葉を使用しないでください。その代わりに、「アフィリエイト予約手数料」または「アフィリエイトサービス料」という表現をお使いいただけます。
注： B2BおよびB2Cの両方において、施設の収集およびダイナミックパッケージ用ホテル料金の実装には追加の要件が適用されます。
ユーザーインターフェースの例
BP7：お子様の年齢を改めて記載します（該当する場合）。
連携システムでお子様のご利用が許可されており、かつ旅行者が客室選択の際に子供を指定した場合は、予約ページ上で子供の人数と年齢を明確に確認する必要があります。この情報は、child_ages オブジェクトを通じて提供されます。
ユーザーインターフェースの例
BP8：最終旅行者からの支払いがいつ行われるかに関する記載（施設 の代金徴収の場合、またはExpedia GroupがMORである場合）
エクスペディア・グループがMORである場合は、ご提示いただいたクレジットカードに、予約の全額が直ちに請求される旨をご明記ください。
施設で徴収する場合、提示したクレジットカードでチェックインまたはチェックアウト時に施設により課金されることを明示します。施設 が「non-refundable post-pay」の料金体系を採用している場合は、その代わりに、予約完了直後に 施設 から旅行者に請求が行われる可能性があることを明記してください。
BP9：SCA規制に準拠しています
規制当局やカードネットワーク各社は、オンライン決済のセキュリティを強化し、消費者を不正利用から保護するため、新たな要件を導入しています。こうした規制の多くには、オンライン決済において「強固な顧客認証（SCA）」を実施することが義務付けられています。
BP10:「Expedia Group」がMORの場合、「check-out」ページに表示される決済処理場所
Expedia GroupがMORである場合、支払いが処理される国を、「check-out」ページの目立つ場所に表示する必要があります。というフレーズ「This payment will be processed in」 は、国名の前に挿入する必要があります。
この情報を取得するには、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"ユーザーインターフェースの例
B2B導入の詳細
皆様の開発を支援したり、フィードバックを提供したりするためのチェックリストをご用意いたしました。サイト審査のためにスクリーンショットをご提供いただく場合は、審査を円滑に進めるため、チェックリストにそれらのスクリーンショットと対応するログも併せてご記載ください。
GR3：下流のエージェントは、当社の在庫にアクセスするために、当社の「エージェント利用規約」に同意する必要があります。
旅行者に代わって予約を行う代理店は、当社の下流代理店契約に同意していただく必要があります。予約する前にエージェントが確認して承諾できるように、ダウンストリーム エージェント規約へのリンクを提供する必要があります。その他のバージョンは、Expedia Partner Solutionsのウェブサイトでご覧いただけます。
ユーザーインターフェースの例
ダイナミックパッケージ用ホテル料金 の追加要件
上記の一般的な要件に加え、実装に ダイナミックパッケージ用ホテル料金 要素を含める場合は、以下の要件も満たす必要があります。
AP4: ダイナミックパッケージ用ホテル料金 を、固有のラベルまたは識別子とともに表示する
「Expedia Group」パッケージ料金については、客室単位でパッケージ料金（個別の品目ではない）であることを明確に指定する必要があります。
ユーザーインターフェースの例
BP5：価格表示には、合計金額に加え、税金および手数料の内訳を含める必要があります。
ダイナミックパッケージ用ホテル料金 の総価格要件は、上記に記載されている一般的な要件とは異なります。
A) 合計価格
パッケージの合計価格を表示するには、パッケージ価格と運送費を組み合わせる必要があります。これは通常、施設 の料金に加え、送料を含めた「per-person」の合計金額を表示することで実現されま す。
予約の合計価格は、お支払いページで旅行者に表示する必要があります。合計価格は API レスポンスと一致する必要があり、切り上げや切り捨て、通貨換算は許可されていません。
ユーザーインターフェースの例
BP11：代理店に対し、小包料金規定の遵守を義務付ける
承認された運送手段とともに、この料金を販売していることをエージェントが認めるチェックボックスを購入手続きページに含めます。
ユーザーインターフェースの例
施設 の追加収集要件
上記の一般的な要件に加え、実装に 施設collectを組み込む場合は、以下の要件も満たす必要があります。
B2C導入の詳細
皆様の開発を支援したり、要件に関するフィードバックを提供したりするためのチェックリストを作成いたしました。サイト審査のためにスクリー ンショットをご提供いただく場合は、審査を円滑に進めるため、チェックリストにそれらのスクリーンショットと対応するログも併せてご記載ください。
GR10：member-onlyの特典への適切なアクセスを提供すること
Member-only本オファーは、closed-user環境内でのみ販売されるものとします（例：サイトへのログイン、モバイルアプリ、またはエージェントツールなどを通じて）。
ユーザーインターフェースの例
追加のパッケージ料金に関する要件
上記の一般的な要件に加え、実装にパッケージ料金要素を含める場合は、以下の要件も満たす必要があります。
BP5：パッケージ価格の表示には、合計金額に加え、税金および手数料の内訳を含める必要があります。
ダイナミックパッケージ用ホテル料金 の総価格要件は、上記に記載された一般的な要件とは異なります。
A) 合計価格
パッケージの合計価格を表示するには、パッケージ価格と運送費を組み合わせる必要があります。これは通常、施設 の料金に加え、送料を含めた「per-person」の合計金額を表示することで実現されます。
予約の合計価格は、お支払いページで旅行者に表示する必要があります。合計価格は API レスポンスと一致する必要があり、切り上げや切り捨て、通貨換算は許可されていません。
ユーザーインターフェースの例
ダイナミックパッケージ用ホテル料金 の追加公開要件
上記の一般的な要件に加え、実装に公開パッケージのレート要素を含める場合は、以下の要件も満たす必要があります。
施設 の追加収集要件
上記の一般的な要件に加え、実装に公開パッケージのレート要素を含める場合は、以下の要件も満たす必要があります。