신용 카드 회수

여행자 결제 카드가 유효하지 않은 경우 알림 받기

개요

신용카드 재캡처 기능은 예약 결제에 사용된 유효하지 않은 신용카드 정보를 유효한 신용카드 정보로 대체할 수 있도록 설계되었습니다. 이렇게 하면 결제 문제로 인한 예약 실패와 공급업체 취소가 줄어듭니다.

이 기능을 사용하면 다음과 같이 할 수 있습니다:

카드가 유효하지 않은 것으로 표시되는 즉시 알림을 받습니다. pre-authorization.
신용 카드(가상 신용 카드 제외)의 세부 정보를 업데이트합니다.
기존 예약 흐름과 원활하게 통합하세요.

참고: 이 기능은 현재 빠른 숙소 API에만 제공됩니다.

필요한 사항

신용카드 재캡처 기능을 추가하려면 다음 단계를 따르세요:

1단계. 아직 사용하지 않는 경우 알림 API()를 채택하세요. 신용카드 정보 조정 기능은 예약 관리 API에 포함되어 있지만, 이 서비스를 활성화하지 않으면 변경이 필요할 때 알림을 받지 못합니다.

2단계. 새 알림 이벤트를 구독하고 사용하세요 itinerary.payment_verification.failure.

3단계. payment_change엔드포인트를 사용하여 업데이트된 결제 수단 세부 정보를 전송합니다.

작동 방식

예약이 결제 변경 대상인 경우(유효하지 않은 신용카드를 사용한 경우), payment_changeAPI 검색 응답에 링크가 표시됩니다. 업데이트 링크를 직접 사용하거나 예약 흐름에 임베드하여 여행자가 직접 변경할 수 있도록 할 수 있습니다.

1단계. 신용카드로 호텔 픽업 예약이 생성되면 예약에 사용된 신용카드에 대해 pre-authorization 확인을 실행합니다.

참고:

Expedia Collect 예약의 경우, 익스피디아 카드만 공급업체와 공유됩니다. 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" 
       } 
     } 
   } 
 ] 
}

제공된 새 카드 정보도 유효하지 않은 경우 유효한 결제 수단이 제공될 때까지 프로세스가 반복됩니다.

변경 결제 링크는 예약에 따라 다양한 시간 동안 활성 상태로 유지됩니다: 48시간 이상 남은 check-in 날짜의 경우, 링크가 24시간 동안 활성화됩니다. check-in 이 48시간 이내인 경우 링크는 12시간 동안 활성화됩니다. 10박 이상 예약( last-minute )의 경우, 예약 후 2시간 동안 변경 결제 링크가 활성화됩니다. 24시간 이내에 새 결제 정보를 제공하지 않으면 공급업체가 예약을 취소할 수 있습니다.