信用卡追回

当旅行者支付卡无效时收到警报

概述

信用卡重新捕获功能旨在帮助您的组织用有效的信用卡信息替换用于支付预订的无效信用卡信息。这减少了由于付款问题导致的预订失败和供应商取消的情况。

此功能允许您：

pre-authorization 之后，一旦卡显示无效，就会收到通知。
更新信用卡（不包括虚拟信用卡）的详细信息。
与现有预订流程无缝集成。

**注意：**此功能目前仅适用于 Rapid Lodging API。

您需要提供什么

要添加信用卡回收功能，请按照以下步骤操作：

**第 1 步，**如果您尚未使用通知 API，请采用它。这是一项建议，调整信用卡信息的能力是管理预订 API 的一部分，但如果不激活此服务，当需要更改时您将不会收到通知。

**第 2 步，**订阅并使用新的通知事件itinerary.payment_verification.failure。

**第 3 步，**使用 payment_change端点发送更新的付款工具详细信息。

如何操作

当预订符合付款变更条件时（使用无效信用卡时），payment_change 链接将出现在检索 API 响应中。您可以自己使用更新链接，也可以将其嵌入到您的预订流程中，以便旅行者可以自行进行更改。

**第 1 步，**当使用信用卡创建酒店到付预订时，我们将对用于预订的信用卡进行 pre-authorization 检查。

注意：

对于 Expedia 收集预订，仅 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": "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 小时。为了满足 10 晚或以上的 last-minute 预订，更改付款链接将在预订后 2 小时内有效。如果 24 小时内未提供新的付款信息，供应商将有权取消该预订。