B2C 向けホテル単体公開要件
以下の公開要件は、エンドユーザーと統合施設が直接やり取りを行う、EPS の B2C 向け統合モデルをご利用のすべてのパートナーに適用されます。
概要
これらの要件は、統合環境を効果的にサポートできるよう、次の 2 つのセクションに分類されています。
- B2C SA 要件 : この予約フローに固有の要件です。これらの要件は、以前に統合した他の料金タイプ / 予約フローとは異なる場合があるため、注意深くお読みください。
- 共通要件 : すべての予約フローに共通している要件です。すべてのフローでこれらすべての要件を満たしていることをご確認ください。
チェックリスト
こちらのリンクから、開発のサポートや、要件に関するフィードバックを提供できるチェックリストを参照できます。サイトレビューのスクリーンショットを提供する場合は、チェックリストにスクリーンショットと対応するログを追加してください。これにより、レビューの完了が円滑に進みます。
B2C ホテル単体要件
共通要件
以下の公開要件は、すべての予約フローのすべての EPS パートナーに適用されます。表示価格の詳細な説明を含む、各料金タイプに固有の追加要件は、個別の料金要件リストで提供されます。
GR1 : Expedia Group や EPS の名前およびロゴを使用しないでください。
いかなる目的であっても、お客様向けパートナーサイトで Expedia Group / EPS の名前またはロゴは一切使用することはできません。例外 (ゲストレビューなど) は、EPS が事前に承認し、書面で明示的に同意している必要があります。
例 :
GR2 : EPS 利用規約を表示する URL へのリンク。
サイト独自の利用規約のテキスト内に EPS 利用規約へのリンクを表示するか、予約ページから直接利用規約にリンクします。これらの規約には、予約管理のポリシーが詳述されています。以下のリンクを「サプライヤー利用規約」というリンクテキストを使用して、わかりやすい場所に配置してください。
英語版はこちらです。
他言語版はこちらに掲載されています。
例 :
GR4 : EPS MOR - クレジット カードの規制に関して適切な使用と表示を守ってください。
エンドユーザーのカード会員データを取得、使用、送信、保存、または処理する場合は、PCI Security Standards Council が発行した PCI DSS を遵守するものとします。これらの規則の全文については、公式 PCI セキュリティ基準サイトを参照してください。
GR5 : EPS MOR または施設での徴収 - 該当するパートナーに提供される PCI コンプライアンスの証拠。
EPS または施設が最終販売責任を負う商業者 (Merchant of Record) である場合、PCI コンプライアンスの証拠として、準拠証明書 (AOC) を提出する必要があります。EPS パートナーは、PCI SSC (Security Standards Council) の自己問診ファイル「SAQ D - Merchants」を使用して、適切な AOC を作成しなければなりません。
SAQ の指示とガイドラインを確認したり、"SAQ D - Merchants" ファイルを入手したりするには、公式 PCI セキュリティ基準ドキュメント ライブラリを参照してください。または、SAQ D - Merchants ファイルを PDF または Word 文書として直接ダウンロードできます。
SP1 : アフィリエイトが予約に子供を含めることを許可する場合、適切なメッセージと子供の年齢の入力を実装します。
統合施設で子供の旅行者が許可される場合、それぞれの子供の旅行者の年齢を指定する機能を提供しなければなりません。この情報は、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 名 / 子供 2 名 (9 歳と 4 歳))
AP1 : 各客室のベッドタイプの説明を記載します。
ショップレスポンスは、1 つの値または複数オプションを含む 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=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",返金不可フラグ UI の例 :
AP3 : チェックインに関する指示とチェックインに関する特記事項を表示します。
checkin、checkout、fees、policies の各オブジェクトの内容は、施設の内容の定義で返されるように、客室ごとに表示する必要があります。チェックイン時にかかる料金や特別なアクセス方法をお客様が認識できるように、この情報は必ず空き室情報ページに表示する必要があります。
special_instructionsフィールドには、checkin オブジェクトの instructions フィールドに含まれていないチェックインに関する重要な情報が含まれる場合があり、これには、到着時刻について施設に通知する必要性、別の場所でチェックインすること、電子メールにより施設からチェックインに関する特記事項を受け取ることなどが含まれます。
旅行者に対して同じエリア内に 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 : チェックインに関する指示とチェックインに関する特記事項を表示します。
checkin、checkout、fees、policies の各オブジェクトの内容は、施設の内容の定義で返されるように、客室ごとに表示する必要があります。チェックイン時にかかる料金や特別なアクセス方法をお客様が認識できるように、お客様が予約を確定する前に、この情報を必ず表示する必要があります。
special_instructionsフィールドには、checkin オブジェクトの instructions フィールドに含まれていないチェックインに関する重要な情報が含まれる場合があり、これには、到着時刻について施設に通知する必要性、別の場所でチェックインすること、電子メールにより施設からチェックインに関する特記事項を受け取ることなどが含まれます。
旅行者に対して同じエリア内に instructions と special_instructions の両方を必ず表示してください。
BP3 : キャンセルポリシーと返金不可タグを明確に表示します。
最終予約ページでお客様が購入を確定できるようにする前に、選択した客室のキャンセルポリシー / 返金不可タグを提示する必要があります。各料金のキャンセルポリシーは、Rapid Shop Availability API の cancel_penalties オブジェクト内で提供されます。
返金可の料金の場合、レスポンスには一連のキャンセルポリシーの詳細が含まれます。詳細には、指定されたキャンセル料の適用開始日と終了日、およびキャンセル料のタイプ、値、適用される例外予約期間が含まれます。キャンセル料のタイプには、固定金額、宿泊数、合計料金に対する割合が含まれます。
タイミング :
refundable=true:- この料金は全額返金可能です。
refundable=true+cancel_penalties:- キャンセル期間中であればこの料金は返金可能です。
- 最も早い
cancel_penalties.[].startは無料のキャンセル期限です。それが将来の日付である場合、最新のcancel_penalties.[].end以降の料金は 100% 返金不可です。
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": "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 配列で返される場合、各値を施設で支払う料金 (チェックインまたはチェックアウト) として個別に表示します。これらの料金は施設が (EPS や地方自治体ではなく) 直接徴収するものであり、「税およびサービス料」の行に含まれている標準の税立替費用、税金、または手数料の一部ではありません。
**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 : 該当する場合、子供の年齢を明示します。
統合施設で子供の旅行者が許可されており、客室選択でお客様が子供の旅行者を指定した場合、予約ページで子供の旅行者の人数と各自の年齢を明確に確認する必要があります。この情報は、occupancy 要素により提供されます。
BP8 : EPS MOR または施設での徴収 : 旅行者から支払いを受けるタイミングを明記する
EPS MOR の場合、指定のクレジットカードに予約の全額が即座に請求されることが記載されていなければなりません。
施設で徴収する場合、提示したクレジットカードでチェックインまたはチェックアウト時に施設により課金されることを明示します。施設が返金不可の後払い料金を提供している場合、予約実行後にお客様が施設により課金されることを示さなければなりません。
BP9 : 欧州経済領域の決済サービス指令第 2 版 (PSD2) に準拠します。
PSD2 への準拠は、欧州経済領域 (EEA) のお客様と取引を行うパートナーに必須です。詳細情報はこちらを参照してください。
EPS MOR または施設での徴収。
EPS がクレジットカードの請求元である場合、またはヨーロッパ在住のお客様が施設での徴収を使用する場合、予約販路には Rapid API の二段階認証の採用を含める必要があります。
アフィリエイト MOR - 一般。
パートナーは、お客様との取引が規制の範囲内にある場合、PSD2 規制の強力な顧客認証 (SCA) 要件に従う必要があります。指令の全文は、欧州委員会から入手できます。採用可能な準拠規格の詳細については、EMVCo の『3D Secure Protocol and Core Functions Specification』を参照してください。
アフィリエイト MOR - 法人カードまたはバーチャルカード。
EEA 内の国で発行されたパートナー所有のカードで EPS を支払うパートナーは、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": "/v3/payment-sessions?token=XXXX"
}
}
}BP10 : EPS MOR または現地払い Premium - お支払いページに決済処理の場所を表示します。
EPS または施設がクレジットカードの請求元である場合、お支払いページのはっきりと見える場所に決済を処理する国を表示する必要があります。国名のあとに、「で支払いが行われます」のフレーズを挿入しなければなりません。
この情報を取得するには、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"
}
]
}例 :
