信用卡重新獲取

當旅客支付卡無效時接收通知

簡介

信用卡重新擷取功能旨在協助貴機構替換用於支付預訂的無效信用卡資訊，以有效信用卡資訊重新擷取飯店的預訂。這可減少因付款問題導致的預訂失敗及供應商取消情況。

此功能可讓您：

當卡片顯示為無效後，立即收到通知 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,，同樣地，由飯店 collect 分支機構提供的 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” 
        }

**步驟四。**付款變更連結隨後將提供，以便輸入新的信用卡資料。在變更進行期間，供應商將無法取消預訂。

範例

{ 
 "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 小時內提供新的付款資訊，供應商將有權取消該預訂。