宿泊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）データセキュリティ基準」を遵守しなければなりません。
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に掲載されている可能性のある手数料や、特別なアクセス方法について把握できるよう、この情報は空き状況ページに必ず表示してください。
特別な「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」ページの目立つ場所に表示する必要があります。「この支払いは、」 という文言を、国名の前に挿入する必要があります。
この情報を取得するには、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 レスポンスと一致する必要があり、切り上げや切り捨て、通貨換算は許可されていません。
ユーザーインターフェースの例
ダイナミックパッケージ用ホテル料金 の追加の公開要件
上記の一般的な要件に加え、実装に公開パッケージのレート要素を含める場合は、以下の要件も満たす必要があります。
施設 の追加収集要件
上記の一般的な要件に加え、実装に公開パッケージのレート要素を含める場合は、以下の要件も満たす必要があります。