信用卡款項追回

當旅客支付卡無效時，將收到通知

簡介

「信用卡資訊更新」功能旨在協助貴機構將用於支付預訂的無效信用卡資訊，替換為有效的信用卡資訊，以便收取飯店預訂款項。這有助於減少因付款問題而導致的預訂失敗及供應商取消訂單的情況。

此功能讓您能夠：

一旦卡片顯示為無效，您將立即收到通知 pre-authorization.
更新信用卡的詳細資訊 (不包括虛擬信用卡)。
與現有的預訂流程無縫整合。

注意：此功能目前僅提供給 Rapid Lodging API。

您需要準備什麼？

若要新增「信用卡款項追回」功能，請依照以下步驟操作：

**步驟 1：**若您尚未使用，請採用通知 API。這是一項建議：調整信用卡資訊的功能屬於「管理預訂」API 的一部分，但若未啟用此服務，當需要進行變更時，您將不會收到通知。

**步驟 2：**訂閱並處理新的通知事件itinerary.payment_verification.failure。

**步驟 3：**請使用 ``payment_change 端點來傳送更新後的支付工具詳細資料。

運作方式

當某筆預訂符合付款變更條件 (例如使用無效信用卡時)，在payment_change的「管理預訂」頁面 () 回應中，「」連結將會出現在「檢索」區段。您可以自行使用更新連結，或將其嵌入預訂流程中，讓旅客自行進行變更。

**步驟 1：**當使用信用卡建立飯店集體預訂時，我們會對用於預訂的信用卡執行 pre-authorization 驗證。

注意：

對於 Expedia Collect 的預訂，僅會將 Expedia 卡資訊提供給供應商。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" 
       } 
     } 
   } 
 ] 
}

如果提供的新的卡片資料同樣無效，系統將重複此流程，直到提供有效的支付工具為止。

「更改付款」連結的有效期限會因預訂情況而異：若預訂日期距離當前時間超過 48 小時 (check-in)，該連結將保持有效 24 小時。若 check-in 是在 48 小時內，該連結將保持有效 12 小時。針對 10 晚或以上的 last-minute 預訂，預訂完成後 2 小時內將提供一個付款變更連結。若未在 24 小時內提供新的付款資訊，供應商將有權取消該預訂。