信用卡款項追回

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

簡介

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

此功能可讓您：

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

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

您需要準備什麼？

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

**步驟 1：**若您尚未使用通知 API，請採用該 API。這是一項建議：調整信用卡資訊的功能屬於「管理預訂 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" 
       } 
     } 
   } 
 ] 
}

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

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