B2C 向けホテル単体公開要件

以下の公開要件は、エンドユーザーと統合施設が直接やり取りを行う、EPS の B2C 向け統合モデルをご利用のすべてのパートナーに適用されます。

概要

これらの要件は、統合環境を効果的にサポートできるよう、次の 2 つのセクションに分類されています。

  • B2C SA 要件 : この予約フローに固有の要件です。これらの要件は、以前に統合した他の料金タイプ / 予約フローとは異なる場合があるため、注意深くお読みください。
  • 共通要件 : すべての予約フローに共通している要件です。すべてのフローでこれらすべての要件を満たしていることをご確認ください。

チェックリスト

こちらのリンクから、開発のサポートや、要件に関するフィードバックを提供できるチェックリストを参照できます。サイトレビューのスクリーンショットを提供する場合は、チェックリストにスクリーンショットと対応するログを追加してください。これにより、レビューの完了が円滑に進みます。

B2C ホテル単体要件

|

予約ページ

BP5 : 表示価格には合計価格と税およびサービス料の明細を含める必要があります。

A) 合計価格

予約の合計価格は、お支払いページで旅行者に表示する必要があります。合計価格は API レスポンスと一致する必要があり、切り上げや切り捨て、通貨換算は許可されていません。最終明細には、宿泊料金 (合計または 1 泊あたり)、追加の 1 泊あたりの料金、サービス料の総額と税金、請求可能な合計を含め、今すぐ支払うものと施設で現地払いするものを明記する必要があります。

B) 税金の明細

tax_and_service_fee に対して返される値には、税務管轄によって義務付けられていない料金は含まれなくなりました。また、property_fee に対して返される値には、政府によって義務付けられていない料金だけでなく、施設に義務付けられていない料金も含まれるようになりました。property_fee に対して返される値には、施設によって課される料金以外の料金も含まれるため、「施設料金」として表示されないようにしてください。お支払いページの料金表示には、tax_and_service_fee と property_fee の合計を「税およびサービス料」というタイトルで 1 行にして含める必要があります。tax_and_service_fee line は、他のページのすべての税参照に対して個別に表示する必要があります。税およびサービス料の合計が価格明細に記載される箇所では、以下と完全に一致する表現を使用して表示することが法的に義務付けられています。

「税およびサービス料」の説明には、以下の情報を記載する必要があります。これは、ポップアップ、プレーンテキスト、モーダル、またはその他の実装として表示できます。

「この料金には、旅行サービスプロバイダー (ホテル、レンタカー会社など) がお客様の予約時に税務当局に支払う税金 (売上税、宿泊税、付加価値税を含むがこれに限定されない) の見積額が含まれます。この金額には、リゾート料金、清掃料金、その他の料金、あるいは当社やホテルサプライヤーまたは予約したサイトで、当社またはそれらのサービスの補償の一部として保持する料金が含まれている場合がありますが、これは場所、金額、予約方法などにより異なります。詳細は、利用規約全文をご参照ください 」( - 翻訳はこちら)。

C) パートナーサービス料と予約手数料

Expedia Group が予約手数料の許可の権利放棄を認める範囲で、パートナーサービス料または予約手数料は明確に分離する必要があります。パートナーが課すサービス料金が予約に追加された場合、個別のサービスは EPS からではなく、パートナーによって請求されること (宿泊施設の提供に伴う追加料金ではないこと) をお客様に明示しなければなりません。既存の「税およびサービス料」の項目内に料金が含まれていない場合があります。パートナーは「手数料」という言葉を使用して請求する料金を説明することはできません。「アフィリエイト予約料」、または「アフィリエイト サービス料」という言葉を使用できます。

確認ページ

CP1 : 表示価格には、明細が提供されている場合は合計価格と税およびサービス料を含めなければなりません。

A) 合計価格

予約の合計価格は、お支払いページで旅行者に表示する必要があります。合計価格は API レスポンスと一致する必要があり、切り上げや切り捨て、通貨換算は許可されていません。最終明細には、宿泊料金 (合計または 1 泊あたり)、追加の 1 泊あたりの料金、サービス料の総額と税金、請求可能な合計を含め、今すぐ支払うものと施設で現地払いするものを明記する必要があります。

B) 税金の明細

tax_and_service_fee に対して返される値には、税務管轄によって義務付けられていない料金は含まれなくなりました。また、property_fee に対して返される値には、政府によって義務付けられていない料金だけでなく、施設に義務付けられていない料金も含まれるようになりました。property_fee に対して返される値には、施設によって課される料金以外の料金も含まれるため、「施設料金」として表示されないようにしてください。お支払いページの料金表示には、tax_and_service_fee と property_fee の合計を「税およびサービス料」というタイトルで 1 行にして含める必要があります。tax_and_service_fee line は、他のページのすべての税参照に対して個別に表示する必要があります。税およびサービス料の合計が価格明細に記載される箇所では、以下と完全に一致する表現を使用して表示することが法的に義務付けられています。

「税およびサービス料」の説明には、以下の情報を記載する必要があります。これは、ポップアップ、プレーンテキスト、モーダル、またはその他の実装として表示できます。

「この料金には、旅行サービスプロバイダー (ホテル、レンタカー会社など) がお客様の予約時に税務当局に支払う税金 (売上税、宿泊税、付加価値税を含むがこれに限定されない) の見積額が含まれます。この金額には、リゾート料金、清掃料金、その他の料金、あるいは当社やホテルサプライヤーまたは予約したサイトで、当社またはそれらのサービスの補償の一部として保持する料金が含まれている場合がありますが、これは場所、金額、予約方法などにより異なります。詳細は、利用規約全文をご参照ください 」( - 翻訳はこちら)。

C) パートナーサービス料と予約手数料

Expedia Group が予約手数料の許可の権利放棄を認める範囲で、パートナーサービス料または予約手数料は明確に分離する必要があります。パートナーが課すサービス料金が予約に追加された場合、個別のサービスは EPS からではなく、パートナーによって請求されること (宿泊施設の提供に伴う追加料金ではないこと) をお客様に明示しなければなりません。既存の「税およびサービス料」の項目内に料金が含まれていない場合があります。パートナーは「手数料」という言葉を使用して請求する料金を説明することはできません。「アフィリエイト予約料」、または「アフィリエイト サービス料」という言葉を使用できます。

確認メール

ER6 : 表示価格には合計価格と税およびサービス料の明細を含める必要があります。

A) 合計価格

予約の合計価格は、お支払いページで旅行者に表示する必要があります。合計価格は API レスポンスと一致する必要があり、切り上げや切り捨て、通貨換算は許可されていません。最終明細には、宿泊料金 (合計または 1 泊あたり)、追加の 1 泊あたりの料金、サービス料の総額と税金、請求可能な合計を含め、今すぐ支払うものと施設で現地払いするものを明記する必要があります。

B) 税金の明細

tax_and_service_fee に対して返される値には、税務管轄によって義務付けられていない料金は含まれなくなりました。また、property_fee に対して返される値には、政府によって義務付けられていない料金だけでなく、施設に義務付けられていない料金も含まれるようになりました。property_fee に対して返される値には、施設によって課される料金以外の料金も含まれるため、「施設料金」として表示されないようにしてください。お支払いページの料金表示には、tax_and_service_fee と property_fee の合計を「税およびサービス料」というタイトルで 1 行にして含める必要があります。tax_and_service_fee line は、他のページのすべての税参照に対して個別に表示する必要があります。税およびサービス料の合計が価格明細に記載される箇所では、以下と完全に一致する表現を使用して表示することが法的に義務付けられています。

「税およびサービス料」の説明には、以下の情報を記載する必要があります。これは、ポップアップ、プレーンテキスト、モーダル、またはその他の実装として表示できます。

「この料金には、旅行サービスプロバイダー (ホテル、レンタカー会社など) がお客様の予約時に税務当局に支払う税金 (売上税、宿泊税、付加価値税を含むがこれに限定されない) の見積額が含まれます。この金額には、リゾート料金、清掃料金、その他の料金、あるいは当社やホテルサプライヤーまたは予約したサイトで、当社またはそれらのサービスの補償の一部として保持する料金が含まれている場合がありますが、これは場所、金額、予約方法などにより異なります。詳細は、利用規約全文をご参照ください 」( - 翻訳はこちら)。

C) パートナーサービス料と予約手数料

Expedia Group が予約手数料の許可の権利放棄を認める範囲で、パートナーサービス料または予約手数料は明確に分離する必要があります。パートナーが課すサービス料金が予約に追加された場合、個別のサービスは EPS からではなく、パートナーによって請求されること (宿泊施設の提供に伴う追加料金ではないこと) をお客様に明示しなければなりません。既存の「税およびサービス料」の項目内に料金が含まれていない場合があります。パートナーは「手数料」という言葉を使用して請求する料金を説明することはできません。「アフィリエイト予約料」、または「アフィリエイト サービス料」という言葉を使用できます。

共通要件

以下の公開要件は、すべての予約フローのすべての EPS パートナーに適用されます。表示価格の詳細な説明を含む、各料金タイプに固有の追加要件は、個別の料金要件リストで提供されます。

|

一般的な要件

GR1 : Expedia Group や EPS の名前およびロゴを使用しないでください。

いかなる目的であっても、お客様向けパートナーサイトで Expedia Group / EPS の名前またはロゴは一切使用することはできません。例外 (ゲストレビューなど) は、EPS が事前に承認し、書面で明示的に同意している必要があります。

例 :

EPS のベストプラクティス

GR2 : EPS 利用規約を表示する URL へのリンク。

サイト独自の利用規約のテキスト内に EPS 利用規約へのリンクを表示するか、予約ページから直接利用規約にリンクします。これらの規約には、予約管理のポリシーが詳述されています。以下のリンクを「サプライヤー利用規約」というリンクテキストを使用して、わかりやすい場所に配置してください。

英語版はこちらです。

他言語版はこちらに掲載されています。

例 :

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 歳))

EPS ユーザーインターフェースの例

ホテル / 客室の空室状況

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": [...]
                            }
                        },

EPS の客室の詳細の例

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 の例 :

EPS のベーシックダブルルームの返金不可フラグの例

AP3 : チェックインに関する指示とチェックインに関する特記事項を表示します。

checkincheckoutfeespolicies の各オブジェクトの内容は、施設の内容の定義で返されるように、客室ごとに表示する必要があります。チェックイン時にかかる料金や特別なアクセス方法をお客様が認識できるように、この情報は必ず空き室情報ページに表示する必要があります。

special_instructionsフィールドには、checkin オブジェクトの instructions フィールドに含まれていないチェックインに関する重要な情報が含まれる場合があり、これには、到着時刻について施設に通知する必要性、別の場所でチェックインすること、電子メールにより施設からチェックインに関する特記事項を受け取ることなどが含まれます。

旅行者に対して同じエリア内に instructionsspecial_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."

**施設コンテンツの抜粋例 : **

EPS チェックインと重要な情報の例

予約ページ

BP1 : 個人データを SSL 暗号化します。

個人データを送受信する場合は、SSL 暗号化を使用して、クライアントのブラウザ / アプリケーションとサイト間の接続、および依存システムとのネットワーク通信を保護する必要があります。個人データには、お客様の名前、電話番号またはメールアドレス、決済カードの詳細、予約 / 旅程の受領と確認のページが含まれます。接続が保護されていない場合は、接続を停止またはリダイレクトします。

BP2 : チェックインに関する指示とチェックインに関する特記事項を表示します。

checkincheckoutfeespolicies の各オブジェクトの内容は、施設の内容の定義で返されるように、客室ごとに表示する必要があります。チェックイン時にかかる料金や特別なアクセス方法をお客様が認識できるように、お客様が予約を確定する前に、この情報を必ず表示する必要があります。

special_instructionsフィールドには、checkin オブジェクトの instructions フィールドに含まれていないチェックインに関する重要な情報が含まれる場合があり、これには、到着時刻について施設に通知する必要性、別の場所でチェックインすること、電子メールにより施設からチェックインに関する特記事項を受け取ることなどが含まれます。

旅行者に対して同じエリア内に instructionsspecial_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_penaltiesnonrefundable_date_ranges と一緒に表示する必要があります。これにより、予約が作成されると返金不可となるこの範囲の滞在期間が表示されます。

キャンセル ポリシーの作成方法の詳細については、こちらをご覧ください。

参考ページ :

  • refundable=false : - 予約が作成されるとすぐに返金不可の金額が発生します。cancel_penaltiesnonrefundable_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"
                            }
                        ],

例 :

EPS キャンセルポリシーの例

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"
            }
        },

例 :

Rapid API のスタンダード ダブルルームの例

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"
            }
        ]
}

例 :

EPS キャンセルポリシー UI の例

確認メール / バウチャー

モバイル アプリケーション内でホスティングされたバウチャーを提供する場合、以下の要件に引き続き従ってください。

ER1 : 旅程 ID を正しく表示します。

統合施設で EPS の itinerary_id をお客様に直接提供する場合、この番号を確認メールに明確に表示しなければなりません。該当する場合は、エージェントが EPS カスタマー サポートのサポートを必要とする際に、エージェントはオリジナルの EPS の旅程 ID にアクセスできる証拠を提供しなければなりません。

ER2 : オンライン カスタマー サービス ツールへのリンクを含め、カスタマー サポートを明確に表示します。

予約フローまたは確認メール内にカスタマー サポート チャネル (電話番号やライブチャットなど) を明確に表示します。EPS エージェントがお客様に直接サポートを提供する場合は、予約フローに EPS サポート番号を表示します。

ER3 : 各客室のベッドタイプの説明を記載します。

確認メール / バウチャーで旅行者がリクエストしたベッドタイプを確認し、同じ客室に複数ベッドタイプのオプションを選んだ旅行者には、リクエストはできるものの、空室状況によってはホテルで受け付けられない場合があるというメッセージを表示します。

configuration 配列に含まれる値を表示し、お客様が選択できるベッドを記載します。

ER4 : チェックインに関する指示とチェックインに関する特記事項を表示します。

checkincheckoutfeespolicies の各オブジェクトの内容は、施設の内容の定義で返されるように、客室ごとに表示する必要があります。チェックイン時にかかる料金や特別なアクセス方法をお客様が認識できるように、お客様が予約を確定する前に、この情報を必ず表示する必要があります。

special_instructionsフィールドには、checkin オブジェクトの instructions フィールドに含まれていないチェックインに関する重要な情報が含まれる場合があり、これには、到着時刻について施設に通知する必要性、別の場所でチェックインすること、電子メールにより施設からチェックインに関する特記事項を受け取ることなどが含まれます。

旅行者に対して同じエリア内に instructionsspecial_instructions の両方を必ず表示してください。

ER5 : 施設で支払うべき料金を価格明細内に個別に表示します。

料金が fees 配列で返される場合、各値を施設で支払う料金 (チェックインまたはチェックアウト) として個別に表示します。これらの料金は施設が (EPS や地方自治体ではなく) 直接徴収するものであり、「税およびサービス料」の行に含まれている標準の税立替費用、税金、または手数料の一部ではありません。

技術要件および制裁関連の要件

TR1 - 各予約リクエストで一意のアフィリエイト リファレンス ID を提供します。

予約リクエストごとに、複数フォーム送信による二重予約 / 二重課金を回避する目的で affiliate_reference_id 要素を使用しなければなりません。予約がタイムアウトになった場合や、アップストリーム タイムアウトのため空の結果が返された場合、旅程がないか EPS システムで確認します。

{
  "affiliate_reference_id": "Launch_Requirement_TR1" ,
 "hold": false,
 "email": "TR4@Launch.Requirement",
 "phone": {
    "country_code": "Launch_Requirement_TR5b",
    "number": "Launch_Requirement_TR5b",
    "area_code": "Launch_Requirement_TR5b"
 },
"rooms": [
 {
    "given_name": "John_Launch_Requirement_TR5a",
    "family_name": "Doe_Launch_Requirement_TR5a",
    "smoking": false,
 },
 {
    "given_name": "David_Launch_Requirement_TR5a",
    "family_name": "Smith_Launch_Requirement_TR5a",
    "smoking": false,
 }
],

TR2 : 各リクエストで旅行者の国コードを提供します。

Shopping と Recommendations の API リクエストで、旅行者の country_code を渡す必要があります。国コードは、お客様がアクセスしている POS (販売時点情報管理) と一致する必要があります。

この要件により、EPS システムは、お客様に関係するコンテンツ、お客様のセールスマーケットに基づく最適な料金を提示できます。

API リクエストの例 :

https://api.ean.com/v3/properties/availability?checkin=2020-09-11
&checkout=2020-09-14
¤cy=USD&language=en-US&occupancy=2-3,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

TR3 : 課金情報

TR3a) 支払人名

  • 法人カードとバーチャルカードのお客様 :
    • パートナーは、EPS によってカードが請求されるカードの所有者名を送信する必要があります。
  • アフィリエイト徴収 / EAC パートナー :
    • EPS では、パートナーが予約の実際の最終支払者の名前を送信することを強くお勧めします。この情報は、規制 / 制裁審査の目的で必要です。
    • 実際の最終支払人の名前を提供できない場合は、EPS への支払いを行うパートナーの会社名 / 法人名を提供します。
    • POS がロシア、ウクライナ、ベネズエラの場合、常に正確な支払人情報が必要です。

TR3b) 課金国

請求先 / 支払人名フィールドに渡された個人名を表す必要があります。

TR3c) 課金郵便番号

請求先 / 支払人名フィールドに渡された個人名を表す必要があります。

郵便番号が管理されていない国は、この情報を提供する必要はありません。

"payments": [
   {
       "type": "customer_card",
       "billing_contact": {
           "given_name": "Launch_Requirement_TR3a",
           "family_name": "Launch_Requirement_TR3a",
       "address": {
           "line_1": "555 1st St",
           "line_2": "10th Floor",
           "line_3": "Unit 12",
           "city": "Seattle",
           "state_province_code": "WA",
           "postal_code": "Launch_Requirement_TR3c",
           "country_code": "Launch_Requirement_TR3b"
       }
   },

TR4 : お客様のメールアドレスまたはモニター対象とするメールボックスを提供します。

各旅程の email 要素には、旅行者のメールアドレスの情報、または統合施設で確認メール処理のためにモニター対象とするメールボックスの情報が含まれていなければなりません。これは、予約の紛争やトラブルシューティングの事例が発生した場合に必要です。

TR5 : 正確な旅行者情報を提供します。

TR5a) 旅行者名

EPS の予約情報は、常に、それぞれの予約した部屋に滞在する実際の旅行者の名前で送信しなければなりません。つまり、予約リクエスト本文の中で、rooms オブジェクト内の given_namefamily_name の値は、各客室にチェックインする代表の宿泊者の氏名と一致する必要があります。

TR5b) 旅行者の電話番号

予約には、旅行者の有効な連絡先番号が含まれていなければなりません。各旅程で、この番号を予約リクエストの電話番号フィールドに含めてください。パートナーのエージェントがエンド ユーザーに直接サポートを提供する場合、EPS は旅行者に連絡することはありません。

TR6 : 複数の客室の予約

複数の客室の予約がサポートされている場合、各客室が予約、キャンセルされたことを示すテスト予約の API リクエストとレスポンスのログを提供します。

予約した客室に対して、それぞれ別の確認用 ID が作成されるので、客室を別々にキャンセルすることができます。すべての客室をキャンセルするには、確認用 ID ごとにキャンセルコールを完了します。

EPS では、API やテンプレート経由の 8 室を超えるグループ予約を直接提供していません。8 室を超える予約が必要な場合は、EPS 担当者からアドバイスを受けることができます。

TR7 : Rapid でのエラー処理に関する推奨事項

Rapid でのエラー処理に関する推奨事項を確認し、処理用のロジックを実装していることを確認してください。

このページは役に立ちましたか ?
このコンテンツに改善が必要な点があれば、
サービス向上にご協力いただきありがとうございます。