キャンセルポリシーの作成
Rapid Lodging APIを通じて、キャンセルポリシーのモデル化および公開の仕組みについて理解しましょう
概要
Rapid Shopping APIは、「Availability」レスポンスに含まれる各料金プランについて、キャンセルポリシーの詳細を返します。各料金プランごとの具体的なキャンセル規定は、以下の主要な要素に基づいて構成されています：
- tri-stateフラグ（
current_refundability）は、リクエスト実行時点におけるその料金の払い戻し可否状況を正確に表します。 cancel_penaltiesオブジェクトは、開始日・終了日、ペナルティの種類、および値を用いてポリシー期間を定義します。nonrefundable_date_rangesでは、その予約においてnon-refundableとして保持される滞在日数を定義します（cancel_penaltiesよりも優先されます）。
注：cancel_penalties.start およびcancel_penalties.end で返されるISO-8601のオフセットは、表示および計算を行う際の基準となる値です。これは通常、現地の 施設 時刻と一致しますが、supplier-configuredのタイムゾーンデータを反映している場合もあり、施設 の住所や地理情報から再計算すべきではありません。
このページにあるすべての例では、オフセットを明示的に（例えば、GMT+7:00）示しており、指定されたとおりにオフセットを保持し、表示する必要があることを強調しています。
>> カリフォルニア州の物件に関する具体的な表示規定をご覧ください
ガイドライン
返金の可否
refundability-drivenのロジックおよびユーザーエクスペリエンスの主な制御手段として、current_refundability をご利用ください。これは、特にpartial-penaltyのシナリオにおいて、ポリシー設定を最も正確に反映したものです。
| Value | 意味 |
|---|---|
refundable | 全額返金可 |
non_refundable | 返金はできません |
partially_refundable | ペナルティが0より大きく、予約総額より小さい場合、および／または滞在期間内にnon-refundableの日程範囲が含まれている場合 |
refundableというブール値は、ポリシーの払い戻し可否に関する可視性を提供しますが、その範囲は限定的であり、一部払い戻しや複雑な違約金の仕組み、あるいはその他の手数料が適用される可能性があるかどうかについては、完全に説明しているわけではありません。ご予約時に全額返金不可の料金プランには、「refundable=false」と表示されます。
Non-refundable日付範囲
nonrefundable_date_ranges オブジェクトを使用して、予約 時に返金不可の滞在期間を設定することは任意です。なお、「nonrefundable_date_range」には、1泊あたりの宿泊料金に加え、税金および諸手数料が含まれておりますので、あらかじめご了承ください。
nonrefundable_date_rangesオブジェクトに「non-refundable」の日付が定義されている料金プランの場合、これらの宿泊日数に対して、cancel_penalties オブジェクトに規定されているその他のキャンセル料に加え、料金が請求されます。
施設使用料
キャンセル時に支払うべき手数料について言及する際は、「キャンセル料」という表現の代わりに「施設 手数料」という用語を使用することが推奨されます。これにより、誰が手数料を徴収するのか、またなぜその手数料が発生するのかをより正確に反映することができます。
予約時
キャンセル規定の詳細は、ご予約がキャンセル料の対象期間内か対象期間外かによって、返信の内容が異なります。以下の例にある「refundable」施設 をご覧ください。
キャンセル料が発生する期間内に予約された場合：
{
"itinerary_id": "9999999999999",
...
"rooms": [
{
"links": {
...
},
"id": "1111",
...
"status": "booked",
"checkin": "2026-08-03",
"checkout": "2026-08-07",
...
"rate": {
"id": "2222",
...
"refundable": false,
"cancel_refund": {
"amount": "0.00",
"currency": "USD"
},
"cancel_penalties": [
{
"currency": "USD",
"percent": "100%",
"start": "2026-07-16T06:56:59.311-07:00",
"end": "2026-08-03T23:59:00.000-07:00"
}
],
...
"pricing": {
...
}
}
}
]
}キャンセル料の対象期間外に行われたご予約：
{
"itinerary_id": "9999999999999",
...
"rooms": [
{
"links": {
...
},
"id": "1111",
...
"status": "booked",
"checkin": "2026-09-27",
"checkout": "2026-10-02",
...
"rate": {
"id": "2222",
...
"refundable": true,
"cancel_refund": {
"amount": "-1131.85",
"currency": "EUR"
},
"cancel_penalties": [
{
"currency": "EUR",
"percent": "100%",
"start": "2026-07-18T01:21:30.000-07:00",
"end": "2026-09-27T23:59:00.000-07:00"
}
],
...
"pricing": {
...
}
}
}
]
}政策の構成要素
旅行者に提示しなければならないキャンセル規定は、の4つの主要な期間 に加え、per-stayの払い戻し規定 に基づいています。ロジックにおいては、これら4つの時間枠すべてを考慮に入れる必要があり、必要に応じてUIのテキストにも反映させてください。
キャンセル規定の例外
定義： nonrefundable_date_ranges
これらは、ご予約時点から完全にnon-refundableとなる宿泊日です。ご予約いただいた宿泊日がこれらの期間のいずれかに該当する場合、お客様がいつキャンセルされたかに関わらず、その宿泊日分の料金は常に全額請求されます。
期間には開始日と終了日が含まれます。宿泊日数が終了した際、終了日の1泊分の料金に加え、税金および諸手数料も請求されます。non-refundable.
滞在期間の一部のみがnon-refundableの適用期間と重なる場合でも、cancel_penalties に規定されているその他のペナルティ期間に該当しない限り、その期間外の宿泊日については払い戻しが可能となる場合があります。
Traveler-facingお問い合わせ先： これらの日程は、ご予約時点での「non-refundable」の対象となります。ご予約を変更またはキャンセルされた場合、これらの日程分の返金や次回のご宿泊に利用できるクレジットは発生せず、また、税金や手数料もご負担いただくことになります。
キャンセル無料
これは、予約の作成から、「cancel_penalties」オブジェクトにペナルティが設定されている最も早い保険適用期間の開始までの期間であり、「nonrefundable_date_ranges」に含まれる宿泊日は除外されます。すべてのウィンドウの中から最も早いcancel_penalties.start を特定し、そのタイムスタンプを無料キャンセル期間の終了時刻としてください。
注： のキャンセルポリシーには、最大3段階の期間を設定できます。
Traveler-facingお問い合わせ： [違約金適用開始日の時刻] までに予約をキャンセルしていただければ、全額返金いたします。「non-refundable」の対象期間内に予約された宿泊日については、払い戻しはいたしかねます。
ペナルティの取り消し
定義元： ``cancel_penalties に含まれる各要素（存在する場合）。
対応しているペナルティの種類
各ペナルティ期間内において、nonrefundable_date_ranges での宿泊日数はnon-refundableのままとなり、追加のペナルティは、該当するcancel_penalties ウィンドウで設定されたとおりに適用されます。なお、の「金額」と「宿泊数」、あるいはの「金額」と「パーセント」 を、同じ期間内で組み合わせることは可能ですが、のように、 宿泊数とパーセントを単一のティア期間内で併用することはできません。
金額ベースのキャンセル料
- 指定された通貨での固定手数料（e.g. 200 USD)
Traveler-facingメッセージ： [保険期間の開始日時] 以降にキャンセルされた場合、[金額] [通貨] が請求されます。
宿泊数ベースのキャンセル料
- 指定された宿泊日数分の料金に加え、税金および手数料が加算されます（複数泊をご予約の場合、料金は1泊目から請求されます）。
Traveler-facingお問い合わせ先： [保険期間の開始日時] 以降にキャンセルされた場合、[宿泊日数] 泊分の料金に加え、税金および手数料が請求されます。
割合ベースのキャンセル料
- 宿泊料金および諸費用の総額のうち、一定の割合（e.g. 90%）となります。
Traveler-facingメッセージ： [保険期間の開始日時] 以降にキャンセルされた場合、ご滞在総額の [パーセンテージ] が請求されます。
Post-check-inキャンセルおよびno-show
これは 、最後に設定されたペナルティ期間（cancel_penalties[end]）が終了した後の期間です。つまり、check-inの時刻の直前のティアウィンドウのことです。
Traveler-facingお問い合わせ先： このご予約について「no-show」をご利用の場合、または「check-in」の期限を過ぎてからご予約をキャンセルまたは変更された場合、[直近の設定されたペナルティ期間で定められた金額／通貨／宿泊日数／割合]が請求されます。
per-stayの返金について
Per-stay stayオブジェクトで返される数値には、1つのルールが適用されます：
- 滞在期間中のいずれかの日がnon-refundable, per-stayに該当する場合、金額は以下の通りとなります。non-refundable
- Per-stay でのご滞在全体が全額返金対象となる場合のみ、でのご滞在料金が返金されます。
注： VRBOの物件については、サービス手数料の請求や返金に関して、さらに細かい注意点がございます。詳細については、統合コンサルタントにお問い合わせください。
カリフォルニア州の物件に関する保険証券表示の更新
カリフォルニア州のポリシー変更に準拠するため、キャンセル期間は、予約作成のタイムスタンプから正確に24時間後に開始される必要があります。ただし、予約が以下の72時間以内に行われた場合はこの限りではありません。check-in. エクスペディアのシステムでは、カリフォルニア州にある 施設の予約について、キャンセル可能期間が自動的に調整されます。
想定される動作の例：
- カリフォルニア州内の施設については、全額返金可能でキャンセル料も発生しない料金設定となっているため、キャンセル規定に変更はありません。
- カリフォルニア州内の施設について、non-refundableの料金プランで、予約時点からキャンセル料が適用される場合、キャンセル規定は、予約作成日からちょうど24時間後に適用されるよう変更されます。
- 施設 がカリフォルニア州外にある場合、たとえカリフォルニア州内で予約が行われたとしても、キャンセル規定に変更は生じません。
Pre-bookingキャンセル規定
旅行者が商品を選んでいる間、更新されたキャンセル料の適用期間がAPI呼び出し時に自動的に表示されます。「refundable」フラグは、non-refundableでの予約についてはfalseのままとなっていることにご留意ください。そのため、キャンセル期間に基づき、この設定を遵守していただく必要があります。ホテルの場合、そのキャンセル期間は予約日時から24時間となります。Vrboの物件については、ご予約の翌日の終日までとなります。
Post-bookingキャンセル規定
ご予約後も、調整後のカリフォルニア州の規定が引き続き適用されます。
- 予約の払い戻し可否や払い戻し額については、「予約の管理」にある
GET /itinerariesおよびcancel_refundを、正確な情報源としてご参照ください。 - 確認メールには、変更後のキャンセル規定も記載されています。
- Shoppingの「
refundable」ブール値は、今回の変更によって変更されません。引き続き、フィルタリングの目的で、そのレートが「non-refundable」となることを意図しているかどうかを反映します。 - 「旅程の取得」レスポンスに含まれる
refundableパラメータは、その予約が現在、該当するキャンセル期間内にあるかどうかを示しています。post-bookingのオプションを表示する際、この情報を基に、その予約が全額返金可能かどうかを判断してください。