Rapid Lodging APIにおけるキャンセルポリシーの仕組みについて、さらに詳しくご確認ください。
予約時に全額返金可能ではないすべての料金タイプは、API 応答で refundable=false と表示されます。
各料金の特定のキャンセルポリシーは、Rapid Shop Availability API の cancel_penalties オブジェクトと nonrefundable_date_ranges オブジェクトの組み合わせによって決定されます。
nonrefundable_date_ranges オブジェクトは、予約時に完全に返金不可の滞在期間を定義します。そのため、このオブジェクトは cancel_penalties オブジェクトで設定された追加のキャンセルポリシーよりも優先されます。nonrefundable_date_ranges オブジェクトを使用して、予約時に返金不可の滞在期間を設定することは任意です。 nonrefundable_date_range が含まれていることに注意してください。つまり、1 泊料金に加えて、「終了」日の税金や手数料も請求されます。cancel_penalties オブジェクトは追加のキャンセル料の詳細を設定し、これらのポリシーを構築するためのさまざまなオプションがあります。詳細には、指定されたキャンセル料適用期間の開始日と終了日、およびキャンセル料のタイプと値が含まれます。キャンセル料のタイプには、固定金額、宿泊数、合計料金に対する割合が含まれます。
nonrefundable_date_ranges オブジェクトで定義された料金に返金不可の期間がある場合、cancel_penalties オブジェクトで設定されているその他のキャンセル料に加えて、これらの宿泊料金が請求されることに注意してください。
予約の返金額は、Manage Booking API の一部として、Retrieve Booking サービス内の cancel_refund オブジェクトで確認できます。宿泊料金の返金ステータスの詳細については、以下を参照してください。
注 : cancel_penaltiesの開始時刻と終了時刻のタイムゾーンは宿泊施設の現地時間です。
キャンセルポリシーの作成に関する以下のガイドラインは、宿泊施設がキャンセルポリシーを正確に解釈してお客様に伝えたり、記載されていない形式で API がポリシーを返すときにお客様に返金不可のメッセージを表示したりする際に役立てることができます。
カリフォルニア州における最近の政策変更に準拠するため、Rapid APIを改定いたしました。これにより、カリフォルニア州にある物件については、check-inの時刻から72時間以内に予約が行われた場合を除き、キャンセル期間は予約作成のタイムスタンプから正確に24時間後に開始されることとなります。エクスペディアのシステムでは、この変更が自動的に行われるよう設定されています。
いくつか例を挙げますと：
- カリフォルニア州内の施設については、全額返金可能な料金設定となっており、キャンセル規定が設けられていないため、キャンセル規定の変更は行われません。
- カリフォルニア州内の施設について、non-refundableの料金プランで、予約時点からキャンセル料が適用される場合、キャンセル規定は、予約作成日からちょうど24時間後に適用されるよう変更されます。
- 施設 がカリフォルニア州外にある場合、たとえカリフォルニア州内で予約が行われたとしても、キャンセル規定に変更は生じません。
旅行者が商品を選んでいる間、更新されたキャンセル料の適用期間がAPI呼び出し時に自動的に表示されます。non-refundableでのご予約については、返金可能フラグが「false」のままとなっていることにご留意ください。そのため、キャンセル期間に基づき、この条件を遵守していただく必要があります。ホテルの場合、キャンセル期間は予約日時から24時間以内となり、Vrboの宿泊施設の場合は、予約日の翌日の終日までとなります。
このAPIでは、「GET/itineraries」の取得呼び出しにおいて、更新されたキャンセルペナルティ期間が表示されます。キャンセル規定は、予約確認メールにも記載されます。
Shopping APIの利用可能状況レスポンスに含まれる「refundable」というブール値は、今回の変更によって変更されることはありません。レートが「non-refundable,」となるように設定されている場合でも、Rapid API'sのフィルタリング機能を維持するため、表示は「refundable=false」のままとなります。現在と同じロジックを使用してこのパラメータでフィルタリングすることは引き続き可能ですが、インターフェース要素を表示する際には、カリフォルニア州の解約ポリシーの変更点を考慮に入れる必要があります。
「旅程の取得」レスポンスに含まれるrefundable パラメータには、その予約が現在、変更後のキャンセル料適用期間内にあるかどうかが反映される必要があります。これにより、在庫情報を取得する際に、その予約が全額返金可能かどうかを判断できるようになります。
キャンセルポリシーは、次のテンプレートで表される 4 つの主要な期間で構成されます。キャンセルポリシーを適切に表すために、4 つの期間をすべて含めるようにしましょう。
1. キャンセルポリシーの例外期間。
予約の確定を起点にキャンセル時に返金が行われない期間は nonrefundable_date_ranges オブジェクトで定義できます。この期間外の滞在期間は、cancel_penalties オブジェクト内で指定されたポリシーの対象となるため、予約された滞在の一部のみが例外期間内にある場合は、部分的な返金を受けることができます。
2. 無料キャンセル期間。
[最も早いキャンセル料適用期間の開始日時] までキャンセル料は無料です。注 : 返金不可期間 (nonrefundable_date_ranges オブジェクトで定義) 内にある予約済みの滞在期間は返金されませんが、この期間外の滞在期間は、cancel_penalties オブジェクトで指定された最も早いキャンセル料適用期間の開始時刻前にキャンセルが行われた場合、全額返金されます。
3. キャンセル料適用期間 (複数のキャンセル料金適用期間を設定可能) - API レスポンスに cancel_penalties が含まれる場合。
注 : 返金不可期間 (nonrefundable_date_ranges オブジェクトで定義) 内にある予約済みの滞在期間は全額請求されますが、cancel_penalties オブジェクトで指定されたポリシーに従って、この期間外の滞在期間は返金されます。
金額ベースのキャンセル料
[キャンセル料適用期間の開始日時] 以降のキャンセルには、[金額] [通貨] のキャンセル料が発生します。
または
宿泊数ベースのキャンセル料
[キャンセル料適用期間の開始日時] 以降のキャンセルには、[宿泊数] 泊分のキャンセル料に加えて、税およびサービス料が発生します。
または
割合ベースのキャンセル料
[キャンセル料適用期間の開始日時] 以降のキャンセルには、合計価格の [割合]% 分のキャンセル料が発生します。 金額ベースと宿泊ベース、または金額ベースと割合ベースのキャンセル料を同時に設定することはできますが、同じ期間に対して宿泊ベースと割合ベースのキャンセル料を設定することはできません。
4. レイトチェックインとノーショー期間。
ご予約の施設にチェックインされなかった場合、またはチェックイン後に予約をキャンセルもしくは変更された場合、施設の自由裁量により予約金額の最大 100% のキャンセル料が発生する可能性があります。
直近のキ ャンセル料金適用期間の終了日が、直近のキャンセル日時になります。
5. 宿泊料金の返金。
1 日以上の宿泊も返金不可である場合、宿泊オブジェクトで返される宿泊料金は返金不可とみなされます。宿泊全体が全額返金可能な場合にのみ宿泊料金が返金されます。
注： キャンセル時に支払うべき手数料について言及する際は、「キャンセル料」という表現の代わりに「施設 手数料」という用語を使用することをお勧めします。これにより、誰が手数料を徴収するのか、またなぜその手数料が発生するのかをより正確に反映することができます。
例 1 - 金額ベースのキャンセル料
**API レスポンス : **
"refundable": true,
"cancel_penalties": [
{
"start": "2027-08-26T23:59:00.000+07:00",
"end": "2027-09-29T23:59:00.000+07:00",
"amount": "200",
"currency": "USD"
}
],
予約の詳細 :
- お客様は2027年7月5日にご予約をされました。
- Check-in日付は2027年9月29日です
- Check-out日付は2027年10月6日です
キャンセルポリシーの内容 :
- 8月26日2027 11:59（GMT +7:00）までは無料でキャンセル可能です。
- 8月26日2027 11:59（GMT +7:00）以降にキャンセルされた場合、200 USDの手数料が発生いたします。
- キャンセル料適用期間の終了時刻は 2022 年 9 月 29 日午後 11 時 59 分 (GMT +7:00) です。この時点から予約は全額返金不可になります。
- ご予約の施設にチェックインされなかった場合、またはチェックイン後に予約をキャンセルもしくは変更された場合、施設の自由裁量により予約金額の最大 100% のキャンセル料が発生する可能性があります。
注 : 複数の客室のリクエストの場合、返金されるキャンセル手数料の金額は客室の定員タイプ単位となるため、状況に応じてキャンセル手数料を乗算する必要があります。
例 2 - 金額ベースのキャンセル料 + 返金不可の期間
**API レスポンス : **
"refundable": false,
"cancel_penalties": [
{
"start": "2027-08-26T23:59:00.000+07:00",
"end": "2027-09-29T23:59:00.000+07:00",
"amount": "200",
"currency": "USD"
}
],
"nonrefundable_date_ranges": [
{
"start": "2027-09-30",
"end": "2027-10-01"
}
{ "start": "2027-10-05",
"end": "2027-10-06"
}
],
予約の詳細 :
- お客様は2027年7月5日にご予約をされました。
- Check-in日付は2027年9月29日です
- Check-out日付は2027年10月7日です
キャンセルポリシーの内容 :
- 8月26日2027 11:59（GMT +7:00）までのキャンセルについては：
- 「non-refundable」の開催期間（2027年9月30日～2027年10月1日および2027年10月5日～2027年10月6日）に予約された宿泊は、予約時点から完全に「non-refundable」の対象となります。
- 返金不可期間外の宿泊については、キャンセルは無料です。
- 8月26日2027 11:59 PM（GMT +7:00）から9月29日2027 11:59 PM（GMT +7:00）までの間に キャンセルされた場合：
- 「non-refundable」の開催期間（2027年9月30日～2027年10月1日および2027年10月5日～2027年10月6日）に予約された宿泊は、予約時点から完全に「non-refundable」の対象となります。
- 返金不可の宿泊数分の費用に加え、200 米ドルの手数料がかかります。
- キャンセル料適用期間の終了時刻は 2022 年 9 月 29 日午後 11 時 59 分 (GMT +7:00) です。この時点から予約は全額返金不可になります。
- ご予約の施設にチェックインされなかった場合、またはチェックイン後に予約をキャンセルもしくは変更された場合、施設の自由裁量により予約金額の最大 100% のキャンセル料が発生する可能性があります。
**注 : **
nonrefundable_date_ranges オブジェクトは、この方法で任意の cancel_penalties オブジェクトの期間と組み合わせることができます。- 複数の客室のリクエストの場合、返金されるキャンセル手数料の金額は客室の定員タイプ単位となるため、状況に応じてキャンセル手数料を乗算する必要があります。
例 3 - 宿泊数ベースのキャンセル料
**API レスポンス : **
"refundable": true,
"cancel_penalties": [
{
"start": "2027-08-26T23:59:00.000+07:00",
"end": "2027-09-29T23:59:00.000+07:00",
"nights": "1",
"currency": "USD"
}
],
予約の詳細 :
- お客様は2027年7月5日にご予約をされました。
- Check-in日付は2027年9月29日です
- Check-out日付は2027年10月6日です
キャンセルポリシーの内容 :
- 8月26日2027 11:59（GMT +7:00）までは無料でキャンセル可能です。
- 8月26日2027 11:59（GMT +7:00）以降にキャンセルされた場合、1泊分の違約金が発生いたします。
- キャンセル料適用期間の終了時刻は 2022 年 9 月 29 日午後 11 時 59 分 (GMT +7:00) です。この時点から予約は全額返金不可になります。
- ご予約の施設にチェックインされなかった場合、またはチェックイン後に予約をキャンセルもしくは変更された場合、施設の自由裁量により予約金額の最大 100% のキャンセル料が発生する可能性があります。
注 : 複数泊予約されている場合、予約の 1 泊目に対してキャンセル料が請求されます。
例 4 - 割合ベースのキャンセル料
**API レスポンス : **
"refundable": true,
"cancel_penalties": [
{
"start": "2027-08-26T23:59:00.000+07:00",
"end": "2027-09-29T23:59:00.000+07:00",
"percent": "90%",
"currency": "USD"
}
],
予約の詳細 :
- お客様は2027年7月5日にご予約をされました。
- Check-in日付は2027年9月29日です
- Check-out日付は2027年10月6日です
キャンセルポリシーの内容 :
- 8月26日2027 11:59（GMT +7:00）までは無料でキャンセル可能です。
- 8月26日2027 11:59（GMT +7:00）以降にキャンセルされた場合、宿泊料金および諸費用の90％がキャンセル料として請求されます。
- キャンセル可能期間の終了時刻は、9月29日2027 11:59（GMT +7:00）です。この時刻になると、ご予約は完全にnon-refundable.
- ご予約の施設にチェックインされなかった場合、またはチェックイン後に予約をキャンセルもしくは変更された場合、施設の自由裁量により予約金額の最大 100% のキャ ンセル料が発生する可能性があります。
例 5 - キャンセル料無料 / キャンセル料なし
**API レスポンス : **
"refundable": true,
"cancel_penalties": [
{
"start": "2027-08-26T23:59:00.000+07:00",
"end": "2027-09-29T23:59:00.000+07:00",
"nights": "0",
"currency": "USD"
}
],
予約の詳細 :
- お客様は2027年7月5日にご予約をされました。
- Check-in日付は2027年9月29日です
- Check-out日付は2027年10月6日です
キャンセルポリシーの内容 :
- 8月26日2027 11:59（GMT +7:00）までは無料でキャンセル可能です。
- 2027年8月26日午後11時59分（GMT +7:00）から、check-in, の開催日である9月29日までの間にキャンセルされる場合、キャンセル料はかかりません。キャンセル料は発生しません。
- ご予約の施設にチェックインされなかった場合、またはチェックイン後に予約をキャンセルもしくは変更された場合、施設の自由裁量により予約金額の最大 100% のキャンセル料が発生する可能性があります。
例 6 - 返金不可
予約が全額返金不可の場合、cancel_penalties ウィンドウの開始日時は予約日時より前になります。
**API レスポンス : **
"cancel_penalties": [
{
"start": "2027-11-29T10:47:19.727+00:00",
"end": "2028-01-05T23:59:00.000+00:00",
"percent": "100%",
"currency": "USD"
}
],
予約の詳細 :
- お客様は2027年11月30日にご予約をされました
- Check-in日付は2028年1月5日です
- Check-out日付は2028年1月7日です
キャンセルポリシー テキスト :
- ご予約をキャンセルされた場合、返金は行われず、今後の宿泊に使用できる優待クーポンの発行もありません。
例 7 - 段階的なキャンセル
段階的なキャンセルポリシーにより、施設は、キャンセル時の通知の金額に応じて異なるキャンセル料をお客様に請求できます。通常は、滞在期間が近づくほどキャンセル料が高くなります。
**API レスポンス : **
"refundable": true,
"cancel_penalties": [
{
"start": "2027-08-31T23:59:00.000+07:00",
"end": "2027-12-09T23:59:00.000+07:00",
"percent": "70%",
"currency": "USD"
},
{
"start": "2027-12-09T23:59:00.000+07:00",
"end": "2027-12-12T23:59:00.000+07:00",
"percent": "90%",
"currency": "USD"
}
],
予約の詳細 :
- お客様は2027年7月5日にご予約をされました。
- Check-in日付は2027年12月12日です
- Check-out日付は2027年12月22日です
キャンセルポリシーの内容 :
- 8月31日2027 11:59（GMT +7:00）までのキャンセルは無料です。
- 8月31日2027 11:59 PM（GMT +7:00）から12月9日2027 11:59 PM（GMT +7:00）までの間にキャンセルされた場合、宿泊料金および諸費用の70％がキャンセル料として請求されます。
- 12月9日2027 11:59（GMT +7:00）から12月12日2027 11:59（GMT +7:00）までの間にキャンセルされた場合、宿泊料金および諸費用の90％がキャ ンセル料として請求されます。
- キャンセル可能期間の締め切りは、12月12日2027 11:59（GMT +7:00）です。この時刻になると、ご予約は完全にnon-refundable.
- ご予約の施設にチェックインされなかった場合、またはチェックイン後に予約をキャンセルもしくは変更された場合、施設の自由裁量により予約金額の最大 100% のキャンセル料が発生する可能性があります。
例 8 - 一部返金可
**API レスポンス : **
"refundable": false
"cancel_penalties": [
{
"start": "2027-11-27T22:21:15.996+01:00",
"end": "2028-01-10T18:00:00.000+01:00",
"percent": "90%",
"currency": "USD"
}
],
予約の詳細 :
- お客様は2027年11月28日にご予約をされました
- Check-in日付は2028年1月10日です
- Check-out日付は2028年1月14日です
キャンセルポリシーの内容 :
- 予約確定以降のすべてのキャンセルで 90% のキャンセル料が発生します。
- キャンセル可能期間の終了時刻は、1月10日2028 00:00（GMT +1:00）です。この時刻になると、ご予約は完全にnon-refundable.
- ご予約の施設にチェックインされなかった場合、またはチェックイン後に予約をキャンセルもしくは変更された場合、施設の自由裁量により予約金額の最大 100% のキャンセル料が発生する可能性があります。
例 9 - 返金不可の宿泊料金
**API レスポンス : **
"refundable" : false,
"cancel_penalties" : [
{
"start" : "2027-11-16T18:00:00.000+04:00",
"end" : "2027-11-19T18:00:00.000+04:00",
"nights" : "1",
"currency" : "EUR"
}
],
キャンセルポリシーの内容 :
- 予約全体が返金可能な場合にのみ宿泊料金の返金が可能です。
- この予約をキャンセルすると 1 泊分のキャンセル料が発生するため、予約全体は返金不可であり、この場合は宿泊料金が返金されません。
