クレジットカードの奪還

旅行者用支払いカードが無効になった際のアラート受信

概要

クレジットカードの再取得機能は、予約の支払いに使用された無効なクレジットカード情報を有効なクレジットカード情報に置き換えるためのものです。これにより、支払い問題による予約の失敗やサプライヤーのキャンセルを減らすことができます。

この機能により、以下のことが可能になります：

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

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

必要情報

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

**ステップ 1 : **Notification API を採用してください。これは推奨事項です。クレジットカード情報を調整する機能はManage Booking APIの一部ですが、このサービスを有効にしていないと、変更が必要なときに通知されません。

ステップ 2. 新しい通知イベントをサブスクライブして消費しますitinerary.payment_verification.failure。

ステップ 3.payment_changeエンドポイントを使用して、更新された支払手段の詳細を送信します。

仕組み

予約が支払い変更の対象となる場合（無効なクレジットカードが使用された場合）、payment_changeRetrieve API レスポンスにリンクが表示されます。旅行者が自分で変更できるように、更新リンクを自分で使用するか、予約フローに埋め込むことができます。

**ステップ 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": "2025-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時間以内に提供されない場合、予約はキャンセルするサプライヤーの対象となります。