B2C 宿泊単体公開要件
これらのローンチ要件は、business-to-consumer（B2C）統合モデルで、旅行者が統合と直接やり取りする場合に適用されます。
概要
これらの要件は2つのセクションに分類されています：
- B2C SA 要件 : この予約フローに固有の要件です。これらの要件は、以前に統合した他の料金タイプ / 予約フローとは異なる場合があるため、注意深くお読みください。
- 共通要件 : すべての予約フローに共通している要件です。すべてのフローでこれらすべての要件を満たしていることをご確認ください。
チェックリスト
チェックリスト を作成しましたので、開発をサポートしたり、要件に関するフィードバックを提供したりする際にお役立てください。サイトレビューのスクリーンショットを提供する場合は、チェックリストにスクリーンショットと対応するログを追加してください。これにより、レビューの完了が円滑に進みます。
B2C 宿泊単体要件
共通要件
以下のローンチ要件は、すべての予約フローに適用されます。表示価格の詳細な説明を含む、各料金タイプに固有の追加要件は、個別の料金要件リストで提供されます。
GR1：Expedia Groupの名称およびロゴの使用禁止。
当社の名称およびロゴの使用は、traveler-facingまたはagent-facingのサイトにおいてのみ、例外として当社の書面による明確な事前承認がある場合に限り可能です。
例 :
GR2：利用規約URLへのリンクを表示します。
あなたのサイトの利用規約のテキスト内に当社の利用規約へのリンクを提供するか、あなたの予約ページから直接利用規約にリンクしてください。これらの規約には、予約管理のポリシーが詳述されています。以下のリンクを「サプライヤー利用規約」というリンクテキストを使用して、わかりやすい場所に配置してください。
英語版 およびその他のバージョン は、Expedia Partner Solutionsに掲載されています。
例 :
GR4: 当社はマーチャント・オブ・レコード（MoR）です：クレジットカード規制に関する適切な使用と表示
旅行者のカード会員情報を取得、使用、送信、保存、または処理する場合、PCIセキュリティ基準審議会が発行したPayment Card Industry Data Security Standard（PCI DSS）を遵守するものとします。これらの規制に関する完全なリファレンスは、公式サイトPCIセキュリティ基準 でご覧いただけます。
GR5: 当社はMoRまたは施設Collectです：該当する場合は、PCI準拠の証拠を提供します。
当社または施設がMoRである場合、PCI準拠の証拠として準拠証明書（AOC）を提出する必要があります。PCIコンプライアンスに関するアドバイスは、公式サイト（PCI Security Standards）。
SP1 : アフィリエイトが予約に子供を含めることを許可する場合、適切なメッセージと子供の年齢の入力を実装します。
お子様のご旅行が可能な場合、ご旅行の際にお子様の年齢を指定することができます。check-in. この情報は、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人、9歳と4歳の子供2人の部屋
AP1 : 各客室のベッドタイプの説明を記載します。
ショッピングのレスポンス は、単一の値あるいは複数のオプションを含むbed_groups 配列を返します。設定配列に含まれる値を表示し、旅行者のベッドの選択を説明します。
bed_groups配列が複数のオプションで返された場合、旅行者が選択できるように、各ベッドタイプのショッピングレスポンスで提供される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": [...]
}
},**ユーザー インターフェースの例 : **
AP2 : 返金不可フラグを明示します。
Non-refundable 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",**ユーザー インターフェースの例 : **
AP3 : チェックインに関する指示とチェックインに関する特記事項を表示します。
checkin,checkout,fees,policies オブジェクトの内容は、コンテンツ 施設 定義で返されるように、部屋ごとに表示されなければなりません。この情報は、check-inで発生する可能性のある料金や、特別なアクセス方法について旅行者が確実に認識できるよう、空室状況ページに表示する必要があります。
special_instructionsフィールドには、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.
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 オブジェクトの内容は、コンテンツ 施設 定義で返されるように、部屋ごとに表示されなければなりません。この情報は、旅行者が予約を確定する前に、check-inで発生する可能性のある料金や特別なアクセス方法を確実に認識できるように表示する必要があります。
special_instructionsフィールドには、checkin オブジェクトのinstructions フィールドには含まれない、check-inにとって重要な情報が含まれる場合があります。たとえば、施設 に到着予定時刻を通知する要件、ゲストビルとは異なる場所でのcheck-in到着予定時刻、施設 からの電子メールによる特別なcheck-in指示を期待するアラートなどです。
旅行者に対して同じエリア内に instructions と special_instructions の両方を必ず表示してください。
BP3 : キャンセルポリシーと返金不可タグを明確に表示します。
旅行者が最終予約ページで購入を確定する前に、選択した客室のキャンセルポリシーまたは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% 返金不可です。
**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 配列で返される場合、各値を施設で支払う料金 (チェックインまたはチェックアウト) として個別に表示します。旅行者に現地通貨を提示し、通貨を要求します。これらの料金は、施設によって直接徴収されるものであり（当社や地方自治体によって徴収されるものではありません）、標準的な税金回収料金、税金、または税金と手数料の行に含まれる料金の一部ではありません。
**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 : 該当する場合、子供の年齢を明示します。
お子様連れのご旅行が可能で、ご旅行者がお部屋の選択にお子様連れのご旅行者を指定された場合、予約ページでお子様連れの人数と年齢を明確に確認する必要があります。この情報は、child_ages 要素により提供されます。
BP8: 当社はMoRまたは施設Collectです：エンドトラベラーからの支払いがいつ行われるかを明記してください。
弊社がMoRの場合、提供されたクレジットカードに予約金額全額が直ちに請求されることを明記します。
施設で徴収する場合、提示したクレジットカードでチェックインまたはチェックアウト時に施設により課金されることを明示します。もし施設がnon-refundable post-payレートを提供している場合は、代わりに旅行者が予約完了後すぐに施設から請求される可能性があることを示します。
BP9 : 欧州経済領域の決済サービス指令第 2 版 (PSD2) に準拠します。
欧州経済地域（EEA）内の旅行者と取引を行う場合は、PSD2への準拠が必要です。
私たちはMoRまたは施設Collectです。
私たちがMoRである場合、または施設Collectがヨーロッパの旅行者に使用される場合、予約経路にはRapidのAPIの採用が含まれている必要がありますtwo-factor認証。
アフィリエイトMoR - 一般。
旅行者との取引がPSD2規制の範囲内にある場合、PSD2規制のStrong Customer Authentication（SCA）要件に従う必要があります。指令の全文は、欧州委員会から入手できます。採用可能な準拠規格の詳細については、EMVCo の『3D Secure Protocol and Core Functions Specification』を参照してください。
アフィリエイトMoR - コーポレートカードまたはバーチャルカード。
EEA内の国で発行されたご自身のカードでお支払いをされる場合は、PSD2規制の要件に従う必要があります。PSD2 2FAの必要性を軽減するために、B2B決済に準拠し、2FA（two-factor認証）が免除されるカードを使用することができます。
準拠オプションに含まれるもの :
- シングルユースのバーチャルカード
- 会社 (人ではない) に登録されているマルチユースの法人カード特別なプロファイル設定が必要です。
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: 私たちはMoRです：チェックアウトページに表示される支払い処理場所
MoRの場合、お支払いが処理される国をチェックアウトページの目立つ場所に表示する必要があります。国名のあとに、「で支払いが行われます」のフレーズを挿入しなければなりません。
この情報を取得するには、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"
}
]
}**ユーザー インターフェースの例 : **
