B2B 宿泊単体公開要件
これらの発売要件は、最終顧客が貴社の旅行代理店のいずれかとやり取りする企業間（B2B）統合モデルを持つすべてのパートナーに適用されます。
概要
B2Bのローンチ要件は2つのセクションに分類されます：
B2B SA要件 - この予約フローに固有の要件です。これらの要件は、以前に統合した他の料金タイプ / 予約フローとは異なる場合があるため、注意深くお読みください。
共通要件 - これらの要件は、すべての予約フローで共通です。すべてのフローでこれらすべての要件を満たしていることをご確認ください。
チェックリスト
開発支援に役立つチェックリストや、要件に関するフィードバックは、こちらをご覧ください。サイトレビューのスクリーンショットを提供する場合は、チェックリストにスクリーンショットと対応するログを追加してください。これにより、レビューの完了が円滑に進みます。
B2B SA固有の要件
共通の打ち上げ要件
以下のローンチ要件は、すべての予約フローにおいて、すべてのエクスペディア グループのパートナーに適用されます。表示価格の詳細な説明を含む、各料金タイプに固有の追加要件は、個別の料金要件リストで提供されます。
GR1: エクスペディア グループの名称およびロゴの使用
エクスペディア グループの名称およびロゴの使用は、例外としてエクスペディア グループから事前に書面による明確な承認を得た場合に限り、顧客向けサイトまたは代理店向けサイトでのみ使用できます。
例 :
GR2：エクスペディア グループの利用規約へのリンク URL を表示します。
エクスペディア グループの利用規約へのリンクを、お客様のサイトの利用規約のテキスト内に記載するか、または予約ページから利用規約に直接リンクしてください。これらの規約には、予約管理のポリシーが詳述されています。以下のリンクを「サプライヤー利用規約」というリンクテキストを使用して、わかりやすい場所に配置してください。英語版はこちら その他のバージョンはこちら 。
例 :
GR4: エクスペディア・グループ MoR: クレジットカード規制に関する適切な使用と表示
エンドカスタマーのカード会員データを取得、使用、転送、保管、または処理する場合、PCIセキュリティ基準審議会 が発行するPCI DSSに準拠するものとします。これらの規制に関する完全なリファレンスは、公式ウェブサイト（PCI Security Standards Council ）で入手できます。
GR5: エクスペディア グループの MoR またはプロパティ コレクト：該当するパートナーに提供された PCI コンプライアンスの証拠
エクスペディア グループまたはプロパティが MoR である場合、PCI 準拠の証拠として準拠証明書 (AOC) を提出する必要があります。
PCIコンプライアンスに関するアドバイスは、公式ウェブサイト（PCI Security Standards Council ）でご覧いただけます。
SP1：アフィリエイトが子供を予約に含めることを許可している場合、適切なメッセージと子供の年齢の入力が実装されています。
お子様連れのご旅行を許可する場合は、チェックイン時にお子様の年齢を指定できるようにする必要があります。この情報は、occupancy オブジェクトを通じて提供されます（以下の例を参照）。
お客様が子供の旅行者を指定する場合、API レスポンスには年齢制限、追加料金、補助ベッド料金が含まれることがあり、それが予約の料金や有効性に影響する場合があります。
子供とみなされる年齢の範囲は、ホテルごとに設定されます。多くの場合、17 歳以下が子供とみなされます。一部の施設では、18 歳未満の宿泊を許可していません。
API リクエストの例 :
https://api.ean.com/2.4/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 名 / 子供 2 名 (9 歳と 4 歳))。
AP1: 各部屋にベッドタイプの説明があります。
ショップのレスポンスでは、bed_groups 配列を単一の値で返すこともあれば、複数のオプションで返すこともあります。configuration 配列に含まれる値を表示し、お客様が選択できるベッドを記載します。
bed_groups 配列が複数オプションを返した場合、お客様が選択できるように、各ベッドタイプのショップレスポンスにより提供された price_check リンクを表示します。
同じ客室に複数ベッドタイプのオプションを選んだお客様に対しては、リクエストはできるものの、空室状況によってはホテルで受け付けられない場合があるというメッセージを表示しなければなりません。
客室の名前は、ショップレスポンスの 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：払い戻し不可の旗がはっきりと見えること
払い戻し不可の空席状況は、refundable=falseShop の空席状況レスポンスに で表示されます。空室状況のレスポンスで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: チェックインと特別チェックインに関する注意事項の表示
checkin,checkout,fees,policies オブジェクトの内容は、プロパティコンテンツ 定義で返されるように、各部屋について表示されなければなりません。この情報は、チェックイン時に発生する可能性のある料金や、特別なアクセス方法をお客様に確実にお知らせするために、空室状況のページに表示する必要があります。
特別チェックインフィールドには、checkin オブジェクトの指示フィールドには含まれない、チェックインに不可欠な情報が含まれていてもかまいません。たとえば、到着予定時刻を宿泊施設に通知する要件、宿泊棟とは異なる場所でのチェックイン、宿泊施設からの特別なチェックイン指示を電子メールで期待するアラートなどです。
旅行者に対して同じエリア内に 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：チェックインおよび特別チェックインに関する注意事項の表示
checkin,checkout,fees,policies オブジェクトの内容は、プロパティコンテンツ 定義で返されるように、各部屋について表示されなければなりません。チェックイン時にかかる料金や特別なアクセス方法をお客様が認識できるように、お客様が予約を確定する前に、この情報を必ず表示する必要があります。
特別チェックインフィールドには、checkin オブジェクトの指示フィールドには含まれない、チェックインに不可欠な情報が含まれていてもかまいません。たとえば、到着予定時刻を宿泊施設に通知する要件、宿泊棟とは異なる場所でのチェックイン、宿泊施設からの特別なチェックイン指示を電子メールで期待するアラートなどです。
旅行者に対して同じエリア内に instructions と special_instructions の両方を必ず表示してください。
BP3: キャンセルのポリシーと返金不可のタグを明確に表示します。
最終予約ページでお客様が購入を確定できるようにする前に、選択した客室のキャンセルポリシー / 返金不可タグを提示する必要があります。各料金のキャンセルポリシーは、Rapid Shop Availability API の cancel_penalties オブジェクト内で提供されます。
返金可の料金の場合、レスポンスには一連のキャンセルポリシーの詳細が含まれます。詳細には、指定されたキャンセル料の適用開始日と終了日、およびキャンセル料のタイプ、値、適用される例外予約期間が含まれます。キャンセル料のタイプには、固定金額、宿泊数、合計料金に対する割合が含まれます。
| レスポンス | 意味 |
|---|---|
refundable=true | この料金は全額返金可能です。 |
refundable=true + cancel_penalties | • この料金は、キャンセル期間内であれば払い戻しが可能です。 • 最も早い cancel_penalties.[].start 、将来のタイムラインであれば、無料キャンセル期限となります。• 料金は100％払い戻しできません。 cancel_penalties.[].end |
refundable=false | • この料金は払い戻しできません。 • キャンセル料適用期間は返されません。 |
refundable=false + cancel_penalties | • 料金の一部は払い戻し可能です。 • cancel_penaltiesは、nonrefundable_date_ranges と共に表示されます。この範囲の宿泊日は、予約が作成されると払い戻し不可であることが示されます。 |
キャンセルポリシーの作成方法に関する詳細は、こちら をご覧ください。
参考ページ :
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％できません。
API レスポンスの例：キャンセルポリシーと返金不可フラグ
"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" : {
"resort_fee": {
"request_currency": {
"value": "74.97",
"currency": "USD"
},
"billable_currency": {
"value": "74.97",
"currency": "USD"
},
"scope": "per_accommodation",
"frequency": "per_night"
}
},**ユーザー インターフェースの例 : **
スタンダードダブルルーム一例](resources/reference/assets/Price_display_must_include_the_total_price_and_breakdown_of_the_taxes_and_fees.png'Standard double room example'
BP7: 該当する場合、子供の年齢を再度説明する必要があります。
統合施設で子供の旅行者が許可されており、客室選択でお客様が子供の旅行者を指定した場合、予約ページで子供の旅行者の人数と各自の年齢を明確に確認する必要があります。この情報はchild_ages オブジェクトを通じて提供されます。
BP8: エクスペディア グループの MoR またはプロパティ コレクト：エンド トラベラーからの支払いはいつ行われるかを明記します。
エクスペディア グループの MoR の場合は、提供されたクレジットカードに予約全額が直ちに請求されることを明記します。
施設で徴収する場合、提示したクレジットカードでチェックインまたはチェックアウト時に施設により課金されることを明示します。施設が返金不可の後払い料金を提供している場合、予約実行後にお客様が施設により課金されることを示さなければなりません。
BP9: 欧州経済領域規制への対応：決済サービス指令2（PSD2）
PSD2 への準拠は、欧州経済領域 (EEA) のお客様と取引を行うパートナーに必須です。詳細情報はこちらを参照してください。
エクスペディアグループMoRまたはプロパティコレクト
Expedia GroupがMoRである場合、またはProperty Collectがヨーロッパの顧客に使用される場合、予約経路にRapidのAPIを採用し、二要素認証 。
アフィリエイトMoR - 一般
パートナーは、お客様との取引が規制の範囲内にある場合、PSD2 規制の強力な顧客認証 (SCA) 要件に従う必要があります。指令の全文は、欧州委員会から入手できます。採用可能な準拠規格の詳細については、EMVCo の『3D Secure Protocol and Core Functions Specification』を参照してください。
アフィリエイトMoR - コーポレートカードまたはバーチャルカード
EEA内の国で発行されたパートナー所有のカードでエクスペディア グループに支払いを行うパートナーは、PSD2規制の要件に従う必要があります。PSD2 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": "/2.4/payment-sessions?token=XXXX"
}
}
}BP10: Expedia Group MoR - チェックアウトページに表示される支払い処理場所
エクスペディアグループがMoRである場合、お支払いが処理される国をチェックアウトページの目立つ場所に表示する必要があります。"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"**ユーザー インターフェースの例 : **
