Developer Hub
자동 생성된 번역입니다.

구매 카드 환불

공급업체가 다음을 통해 예약된 항공편을 취소할 경우, 적립된 여행 포인트를 환불해 드립니다. P-cards

항공사가 여행객의 일정을 변경한 경우, 구매 카드(P-card) 예약 시 사용한 적립 포인트의 환급 절차를 도와드릴 수 있습니다. 파일을 생성한 후 익스피디아 SFTP 서버에 업로드하게 됩니다. 대략적으로 말하자면, 이는 다음과 같은 일을 하게 된다는 뜻입니다:

  1. 익스피디아에 TPID, EAPID 및 SITEID 정보를 요청하십시오. 이 정보는 환불 정보가 올바르게 매핑되도록 하기 위해 보고서 이름의 필수 구성 요소입니다.
    >> 자세한 내용은 ‘명명 규칙’ 섹션을 참조하십시오.
  2. 지정된 형식과 구조에 따라 파일을 생성하고, 명명 규칙에 따라 파일 이름을 지정하십시오.
  3. 파일을 익스피디아 SFTP 서버에 업로드하십시오.

본 문서에 정의된 섹션을 준수하면, 자동화 처리 과정에서 오류나 누락 없이 파일이 원활하게 처리되도록 할 수 있습니다.

정보 확보하기

P-card 발급사에, 귀사가 익스피디아(Expedia)에 제출하는 구매 카드 환불 보고서에 필요한 보고 항목을 포함하는 일일 데이터 파일을 제공해 줄 것을 요청하십시오. 일반적으로 P-card 의 결제 처리 업체(예: TSYS)에서 이 보고서를 제공합니다.

파일 형식

환불 처리를 위해 파일을 정상적으로 처리하려면 해당 파일이 다음 기준을 충족해야 합니다:

  • 파일 형식은 암호화되지 않은 파일의 경우 .csv, 암호화된 파일의 경우 .pgp 중 하나여야 합니다. 암호화된 파일을 제출할 때는 각 행을 개별적으로 암호화하는 대신, 파일 전체를 PGP 암호화를 사용하여 하나의 단위로 암호화해야 합니다.
  • 파일의 첫 번째 행에는 반드시 열 머리글이 포함되어야 합니다.
  • 아래 표에 있는 10개의 열을 모두 나열된 순서대로 포함해야 합니다. 추가 열을 포함해서는 안 됩니다.
  • 각 행의 내용은 쉼표가 아닌 파이프 기호(|)로 구분되어야 합니다.
  • 열 머리글 다음의 각 행은 하나의 거래 기록에 해당합니다.
  • 모든 필수 열이 존재해야 하며, 유효한 데이터가 포함되어야 합니다. 필수 입력란이 누락된 기록은 처리에서 제외되거나 담당자의 검토를 위해 표시됩니다.

파일 구조

통신사는 ‘ AIR_CONFIRMATION_NUMBER ’ 또는 ‘ AIR_TICKET_NUMBER ’ 중 하나를 제공하므로, 환불 내역이 정상적으로 보고되도록 두 속성을 모두 포함해야 합니다.

조건부로 필수 입력 항목(AIR_TICKET_NUMBERAIRLINE_CARRIER_CODE)을 보고서에 포함하는 것이 가장 좋지만, 운송사가 해당 데이터를 제공하지 않더라도 익스피디아에 데이터가 전송될 때 보고서가 오류로 처리되지는 않습니다.

주문열 이름설명데이터 유형필수 여부
1AIR_TICKET_NUMBER항공권 번호. 반드시 10자리여야 합니다. 이 필드에 값이 입력되어 있지 않은 경우, 익스피디아의 기록과 대조하기 위해 상담원의 검토가 필요합니다. 참고: 무티켓 항공사의 경우 확인 번호를 대신 사용합니다.String9607721439필수 (조건부)
2AIRLINE_CARRIER_CODE2~3자 영숫자로 구성된 항공사명 IATA 코드. 이 필드에 값이 입력되어 있지 않은 경우, 익스피디아의 기록과 대조하기 위해 상담원의 검토가 필요합니다.StringDL (델타)
AC (에어 캐나다)
UA (유나이티드 항공)
필수 (조건부)
3TRANSACTION_AMOUNT카드에 청구된 금액을 나타내는 소수점 이하 2자리 숫자. 마이너스 금액은 환불을 의미합니다.
참고: 이 필드는 환불 거래 시 필수 항목이지만, 적립 거래 시에는 필수 항목이 아닙니다.
숫자104.23 (과금됨)
-104.23 (환불)
필수 항목
4CURRENCY_CODE3글자 ISO 통화 코드.StringCAD
USD
필수 항목
5POST_DATEP-card 게시 날짜는 mm/dd/yyyy 형식으로 입력하십시오.날짜11/07/2024필수 항목
6TRANSACTION_DATEP-card 거래 날짜(mm/dd/yyyy 형식).날짜07/07/2024필수 항목
7TRAVELER_FIRST_NAME해당 항공권과 연결된 여행자의 이름. 최대 50자. 파이프 문자를 사용하지 마십시오.
허용되는 값: 라틴 알파벳(A-Z, a-z),, 악센트가 붙은 문자(예: é, ü, ç), 숫자, 공백.
String파르바티
메리 앤
Optional
8TRAVELER_LAST_NAME항공권과 연결된 여행자의 성. 최대 50자. 파이프 문자를 사용하지 마십시오.
허용되는 값: 라틴 알파벳(A-Z, a-z),, 악센트가 붙은 문자(예: é, ü, ç), 숫자, 공백.
StringSmith
데 라 크루즈
Optional
9SUPPLY_INFO공급자에 대한 추가 정보로, 대개 판매자 이름입니다. 최대 300자.
허용되는 값: 라틴 알파벳(A-Z, a-z),, 숫자, 공백. 특수 문자(예: @, ', -, #, é, ç 등)는 사용할 수 없습니다.
String에어 캔 0111111111111
카리브해 AI1062222222222
브뤼셀 AI 0823333333333
Optional
10AIR_CONFIRMATION_NUMBER6자리 영숫자 항공편 확인 번호. 이 필드는 티켓 번호가 없는 경우 식별자로 사용됩니다. 이는 무표권 항공사를 이용할 때에만 필요합니다.
허용되는 값: 라틴 알파벳(A-Z, a-z),, 숫자.
다음은 사용하지 마십시오: 공백, 특수 문자(예: @, #, é, ç)
StringABCD12선택 사항 (티켓 없는 처리 시 필수)

샘플 파일

파일 이름: [PARTNERNAME]_ 5002_900188_ 900188_20241108.csv

AIR_TICKET_NUMBER|AIRLINE_CARRIER_CODE|TRANSACTION_AMOUNT|CURRENCY_CODE|POST_DATE|TRANSACTION_DATE|TRAVELER_FIRST_NAME|TRAVELER_LAST_NAME|SUPPLY_INFO|AIR_CONFIRMATION_NUMBER 
9607721439|AC|104.23|CAD|11/07/2024|11/01/2024|Sam F.|Doe|AIR CAN 0111111111111|ABCD12
5954412772|WS|-550.9|CAD|02/08/2024|02/04/2024|John|Smith|CARIBBEAN AI1062222222222|WQJGL5 
54412723|UA|-265.9|CAD|02/09/2024|02/04/2024||||

파일 매개변수

환불 파일을 업로드하기 전에, 파일 이름 지정 및 정보 암호화 등 몇 가지 표준 규정을 따라야 합니다.

명명 규칙

환불을 위해 제출되는 모든 파일은 아래에 명시된 파일명 규칙을 따라야 합니다. 이 형식을 준수하지 않을 경우, 해당 파일은 처리 대상에서 제외됩니다.

파일 이름은 다음과 같은 형식으로 지정해야 합니다: [PARTNERNAME]_TPID_EAPID_SITEID_YYYYMMDD.csv. 여기서:

  • PARTNERNAME: 귀사의 이름.
  • TPID: 익스피디아가 할당한 여행 상품 ID.
  • EAPID: 익스피디아에서 할당하는 익스피디아 제휴 파트너 ID.
  • SITEID: 익스피디아가 해당 사이트에 할당한 판매처 ID입니다.
  • YYYYMMDD = 파일이 생성된 연도, 월, 일로, 연도는 4자리, 월과 일은 각각 2자리로 표시됩니다.

파일 이름에 특수 문자나 공백을 포함하지 마십시오. 파일 크기는 5GB를 초과해서는 안 됩니다.

암호화

보안 강화를 위해 PGP를 사용하여 파일을 암호화할 수 있습니다. 담당자에게 당사의 공개 PGP 키를 요청하신 후 다음을 수행하십시오:

  • 파일의 내용뿐만 아니라 파일 전체를 보호하십시오.
  • .pgp 확장자를 추가하세요(예: PARTNERNAME_0_1_1_20250101.pgp).

업로드 방법

파일을 정상적으로 처리하려면 익스피디아 SFTP 호스트명을 사용하여 파일을 제출해야 합니다: eps-pcard-transactions-datafeed.transfer.expedia.com.

SFTP 연결을 설정하기 위해 UAT 및 프로덕션용 SFTP 계정을 생성했습니다. 두 계정 모두에 대해 다음 정보를 제공해 주셔야 합니다:

  • SSH(Secure Shell) 공개 키
  • 허용 목록에 추가할 IP 서브넷 (SFTP 연결은 이 허용된 서브넷에서만 허용됩니다)

원하신다면, UAT 계정과 프로덕션 계정 모두에 동일한 키와 IP 서브넷을 사용할 수도 있습니다.

SFTP 연결 도구를 사용하여 SFTP 클라이언트에서 새 연결을 열어주세요. '보안 파일 전송 프로토콜(Secure File Transfer Protocol)'을 선택하고, 익스피디아 계정 관리자가 제공한 서버 주소와 사용자 이름을 입력하세요.

SFTP 계정의 사용자 이름은 다음 형식을 따릅니다:

  • 제작: <partner_name>-refunds
  • UAT: <partner_name>-refunds-uat

참고: 환불 파일은 하루에 한 번만 업로드할 수 있습니다.

테스트

템플릿 사이트를 출시하기 전에 환불 처리 절차를 미리 테스트해 보시는 것이 좋습니다.

초기 검증 단계에서는 먼저 모의 데이터가 포함된 샘플 보고서 파일을 UAT 계정에 업로드하십시오. 파일이 수신되었는지 확인하고, 데이터가 성공적으로 처리되었는지 확인해 드리겠습니다.

그런 다음, 사이트 출시 전에 실제 예약 내역을 바탕으로 검증하십시오. 익스피디아 담당자는 사용자 수용 테스트 기간 동안 이루어진 생산 테스트 예약을 바탕으로, 귀하와 협의하여 특정 날짜에 대한 보고서를 제출할 예정입니다.

이 페이지가 도움이 되었나요?
이 콘텐츠를 어떻게 개선하면 좋을까요?
더 나은 Developer Hub를 만드는 데 도움을 주셔서 감사합니다!