信用卡追回
當旅行者支付卡無效時收到警報
簡介
信用卡重新擷取功能旨在幫助您的組織以有效的信用卡資訊取代用於支付預訂的無效信用卡資訊。這減少了由於付款問題導致的預訂失敗和供應商取消的情況。
此功能允許您:
- pre-authorization 之後,一旦卡片顯示無效,就會收到通知。
- 更新信用卡 (不包括虛擬信用卡) 的詳細資訊。
- 與現有預訂流程無縫整合。
**注意:**此功能目前僅適用於 Rapid Lodging API。
您需要準備什麼?
若要新增信用卡回收功能,請依照下列步驟操作:
**步驟 1:**如果您尚未使用通知 API,請採用它。這是一項建議,調整信用卡資訊的能力是管理預訂 API 的一部分,但如果不啟動此服務,當需要變更時您將不會收到通知。
**步驟 2:**訂閱並使用新的通知事件itinerary.payment_verification.failure
。
**步驟 3:**使用 payment_change
端點傳送更新的付款工具詳細資料。
運作方式
當預訂符合付款變更條件時 (使用無效信用卡時),payment_change
連結將出現在檢索 API 回應中。您可以自己使用更新鏈接,也可以將其嵌入到您的預訂流程中,以便旅行者可以自行進行更改。
**步驟 1:**當使用信用卡建立飯店到付預訂時,我們將對用於預訂的信用卡進行 pre-authorization 檢查。
**步驟 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 小時內未提供新的付款信息,供應商將有權取消該預訂。