クレジットカードの返金請求

旅行者の支払いカードが無効な場合に通知を受け取る

概要

「クレジットカード情報の再取得」機能は、ホテル側負担の予約において、予約の支払いに使用された無効なクレジットカード情報を、有効なクレジットカード情報に置き換えることを支援するために設計されています。これにより、決済上の問題による予約の失敗やサプライヤーによるキャンセルが減少します。

この機能では、以下のことが可能です：

カードが無効と表示された直後に通知を受け取るには、pre-authorization.
クレジットカード（バーチャルクレジットカードを除く）の詳細情報を更新してください。
既存の予約フローとシームレスに連携します。

注：この機能は現在、Rapid Lodging APIでのみ提供されています。

必要情報

「クレジットカード再請求」機能を追加するには、以下の手順に従ってください：

**ステップ 1 : ** まだご利用でない場合は、Notification APIを導入してください。これは推奨事項ですが、クレジットカード情報の変更機能は「予約管理API」の一部です。ただし、このサービスを有効にしていない場合、変更が必要になった際に通知は届きません。

>> 通知APIについて詳しくはこちら

ステップ 2. 新しい通知イベントを購読し、処理してくださいitinerary.payment_verification.failure。

ステップ 3.payment_changeエンドポイントを使用して、更新された決済手段の詳細を送信してください。

仕組み

予約が支払い方法の変更対象となる場合（無効なクレジットカードが使用された場合など）、予約管理のレスポンスにある「取得」セクションに「payment_change」というリンクが表示されます。更新リンクをご自身でご利用いただくか、予約フローに埋め込んで、旅行者ご自身で変更を行えるようにすることも可能です。

**ステップ 1 : ** クレジットカードを使用してホテルの「後払い予約」が作成された場合、予約に使用されたクレジットカードに対してpre-authorizationの照会を行います。

注意 :

Expedia Collect (事前決済) の予約については、エクスペディアカードの情報のみがサプライヤーと共有されます。Expedia Virtual Cardにはpre-authorization, は必要ありません。また、提携先が提供するホテルコレクトのVCCカードについても同様です。

ステップ 2. ご利用のカードが無効な場合、次のような通知が表示されます：

例

{ 
 "affiliate_reference_id": "123abc", 
 "email": "test@test.com", 
 "event_id": "86e91a86-ca04-4928-b177-f410879b99a1", 
 "event_time": "2027-06-11T21:56:40.242Z", 
 "event_type": "itinerary.payment_verification.failure", 
 "itinerary_id": "980339849842", 
 "message": "Payment validation has failed during Supplier initiated validation." 
}

ステップ 3. 通知が届きましたら、予約の詳細を確認できます。そこには、お支払いの変更用リンクが含まれています。そのリンクは、次のような感じになります：

例

{ 
    “links”: { 
        “payment_change”: { 
            “method”: “PUT”, 
            “href”: “/v3/itineraries/7090158334868/payment?token=REhZAQsABQsHQhEDTVtVC0w6WA1UXF98IiF8ZmF7KH0oFwtWR1oMAloQZgtSOUFTWgpHAFllMS5hfDBga0BVR0dCWF5TQW9GUhFHDFtaPl9cDHFwczYkdnwhb2RwazZ3fjdzFUQEQBBRWwo-XVwPAA9XB1MDVghIC1MGVBlSBlABGwlXVQMeAQMAUAdQUwlQXwcMFxJKDkgERxVLaw8HDw0EBVBWBVQAEwZUCFFBVUYEVG4WC1sHXgMEUFAcBQsUAwE2BlQTCnlQBxwAdVQGFwEIVQEKBwBTBW4WB11BC0cXG20HCgFVXCR6RVRVFVgHBQQeFFZKWQZaEmoXA0YTURcBUAkXQEAGERZQFEBXAEc-QRNXA15aXWhbAV5XBwxcBVMRDlVAWwdBCFZeawZbUQ9fVltZVRVXFFIDS25QAQkGQl1ZAwpcDQlfDVYRVQQAGlILEQlWHFBXCR97CgFTCktED18KDlFWBQEGVwxQ” 
        }

**ステップ4。**その後、新しいクレジットカード情報を入力できるよう、支払い情報の変更用リンクが表示されます。変更手続き中は、サプライヤーは予約をキャンセルすることができません。

例

{ 
 "change_reference_id": "JohnCCTest", 
 "payments": [ 
   { 
     "type": "customer_card", 
     "number": "4111111111111111", 
     "security_code": "123", 
     "expiration_month": "08", 
     "expiration_year": "2029", 
     "billing_contact": { 
       "given_name": "JohnUPDATE", 
       "family_name": "SmithUPDATE", 
       "address": { 
         "line_1": "555 1st St", 
         "line_2": "10th Floor", 
         "line_3": "Unit 12", 
         "city": "Seattle", 
         "state_province_code": "WA", 
         "postal_code": "98121", 
         "country_code": "US" 
       } 
     } 
   } 
 ] 
}

提供された新しいカードの情報がやはり無効である場合、有効な決済手段が提供されるまで、この手順が繰り返されます。

支払いの変更用リンクの有効期間は、予約内容によって異なります。check-inでの予約で、予約日から48時間以上先の日程の場合、リンクは24時間有効となります。check-inが48時間以内である場合、リンクは12時間有効となります。last-minuteでの10泊以上のご予約の場合、ご予約後2時間の間、支払額の変更用リンクが有効となります。24時間以内に新しいお支払い情報をご提供いただけない場合、当該予約は提供業者によるキャンセル対象となります。