신용카드 환수

여행자 결제 카드가 유효하지 않을 때 알림을 받습니다

개요

‘신용카드 정보 재입력’ 기능은 호텔 대금 후불 예약의 경우, 예약 결제에 사용된 유효하지 않은 신용카드 정보를 유효한 신용카드 정보로 대체할 수 있도록 귀사를 지원하기 위해 마련되었습니다. 이를 통해 결제 문제로 인한 예약 실패 및 공급업체 측의 취소 사례를 줄일 수 있습니다.

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

다음과 같은 상황에서 카드가 무효로 표시되는 즉시 알림을 받게 됩니다. pre-authorization.
신용카드(가상 신용카드 제외)의 정보를 업데이트합니다.
기존 예약 절차와 원활하게 연동됩니다.

참고: 이 기능은 현재 Rapid Lodging API에서만 제공됩니다.

필요한 사항

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

1단계. 아직 알림 API를 사용하지 않고 있다면 이를 도입하십시오. 이는 권장 사항입니다. 신용카드 정보를 수정하는 기능은 ‘예약 관리(Manage Booking)’ API의 일부이지만, 이 서비스를 활성화하지 않으면 변경이 필요할 때 알림을 받지 못합니다.

>> 알림 API에 대해 알아보기

2단계. 새로운 알림 이벤트를 구독하고 수신하세요 itinerary.payment_verification.failure.

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

작동 방식

예약에 결제 변경이 필요한 경우(유효하지 않은 신용카드가 사용된 경우 등), ‘예약 관리(Manage Booking)’ 응답의 ‘조회(Retrieve)’ 섹션에 ‘예약 변경( payment_change)’ 링크가 표시됩니다. 업데이트 링크를 직접 사용하거나, 예약 절차에 해당 링크를 삽입하여 여행자가 직접 변경할 수 있도록 할 수 있습니다.

1단계. 신용카드로 호텔 수령 예약이 생성되면, 당사는 예약에 사용된 신용카드에 대해 ‘ pre-authorization ’ 확인 절차를 진행합니다.

참고:

Expedia Collect 예약의 경우, 익스피디아 카드 정보만 공급업체와 공유됩니다. Expedia Virtual Card 는 pre-authorization, 가 필요하지 않으며, 호텔 콜렉트(hotel collect)를 통해 제휴사가 제공하는 VCC 카드 역시 마찬가지입니다.

2단계. 사용한 카드가 유효하지 않은 경우, 다음과 같은 알림이 표시됩니다:

예시

{ 
 "affiliate_reference_id": "123abc", 
 "email": "test@test.com", 
 "event_id": "86e91a86-ca04-4928-b177-f410879b99a1", 
 "event_time": "2027-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시간 동안 유효합니다. last-minute 에서 10박 이상 예약 시, 예약 완료 후 2시간 동안 결제 변경 링크가 활성화됩니다. 24시간 이내에 새로운 결제 정보를 제공하지 않을 경우, 해당 예약은 공급자가 취소할 수 있는 대상이 됩니다.