信用卡追回
当旅行支付卡无效时,接收提醒。
概述
信用卡信息恢复功能旨在帮助您的组织将用于支付酒店预订的无效信用卡信息替换为有效的信用卡信息。这样可以减少因付款问题导致的预订失败和供应商取消订单的情况。
此功能允许您:
- pre-authorization 之后,当卡片显示为无效时,立即收到通知。
- 更新信用卡信息(不包括虚拟信用卡)。
- 与现有预订流程无缝集成。
**注意:**此功能目前仅适用于 Rapid Lodging API。
您需要提供什么
要添加信用卡扣款回收功能,请按照以下步骤操作:
**第 1 步,**如果您尚未采用通知 API,请采用它。这是一项建议,调整信用卡信息的功能是“管理预订 API”的一部分,但如果不激活此服务,则在需要更改时您将不会收到通知。
**第 2 步,**订阅并使用新的通知事件itinerary.payment_verification.failure。
**第 3 步,**使用 payment_change端点发送更新后的支付工具详细信息。
如何操作
当预订符合付款更改条件(使用无效信用卡时)时,payment_change链接将出现在管理预订响应的检索部分中。您可以自行使用更新链接,也可以将其嵌入到您的预订流程中,以便旅客可以自行进行更改。
**第 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"
}
}
}
]
}如果提供的新卡信息也无效,则该过程将重复进行,直到提供有效的支付工具为止。
根据预订情况,更改付款链接的有效时间长短不一:对于距离预订日期超过 48 小时的 check-in 日期,该链接的有效时间为 24 小时。如果 check-in 在 48 小时内,则该链接将有效 12 小时。为方便预订 10 晚或以上的 last-minute 订单,预订后 2 小时内将提供更改付款链接。如果 24 小时内未提供新的付款信息,供应商将有权取消预订。