currencyCodelocale 일반 요인에서 각각 지정된 통화 및 로케일과 호환되는 카드 종류를 검색합니다. 응답에서 반환되는 모든 카드 유형은 제공된 요인에 대한 예약에 유효합니다. 이 요청은 주로 예약할 때 고객이 선호하는 통화로 된 결제 옵션 목록을 생성하는 데 사용됩니다. 결제 카드 및 검증에 대한 자세한 내용은 유효한 카드 종류 를 검토하세요.
요청 형식
XML/REST URL: GET http://api.ean.com/ean-services/rs/hotel/v3/paymentInfo?
XML 상위 요소: <HotelPaymentRequest>


요청 매개 변수

서비스 특정 URL 매개 변수 요구 사항
이름 필수 설명
apiExperience 문자열 필수

이 속성을 사용하여 요청의 원본을 식별할 수 있습니다. 제출한 각 요청의 아래에 제시된 집합에서 해당 값을 선택합니다.

값:
PARTNER_CALL_CENTER - 콜센터 담당자 요청
PARTNER_WEBSITE - 고객용 웹사이트 요청
PARTNER_MOBILE_WEB - 모바일 형식 웹사이트 요청
PARTNER_MOBILE_APP - 모바일 앱 요청
PARTNER_BOT_CACHE - 캐시 봇 요청
PARTNER_BOT_REPORTING - 보고 봇 요청
PARTNER_AFFILIATE - 고유 제휴사 기반에 서비스하는 API/플랫폼 요청

currencyCode 문자열 필수 결제 정보에 대한 통화 코드가 필요합니다.
locale 문자열 필수

결제 정보에 대한 로케일이 필요합니다.


모든 요청에 대해 통화 코드, 로케일, 요금 유형 및 공급자 유형을 동적으로 채워야 합니다. 이러한 값을 하드 코딩하면 잘못된 결제 유형이 반환될 수 있습니다.



기본 요인
이름 필수 설명
hotelId 문자열 필수 숙박업소에 대한 hotelId입니다.
supplierType 문자열 필수

결제 정보에 대한 공급업체 유형이 필요합니다.
지원에서 다른 지침이 없는 한, E 값을 보냅니다(Expedia Collect의 경우).

rateType 문자열 필수 결제 정보가 필요한 호텔의 객실 예약 가능 여부 응답에 나온 요금 유형입니다.
허용되는 값:
  • MerchantStandard
  • MerchantPackage
  • DirectAgency


응답 컨텐츠
상위 요소: HotelPaymentResponse

상위 요소에는 size 특성이 있어 반환된 옵션 수를 나타내며 currencyCode 특성으로 요청에서 지정한 통화 코드를 확인할 수 있습니다. 상위 요소에는 개별 결제 옵션을 포함하는 PaymentType,이 제공됩니다.
이름 설명
PaymentType 개체 XML에 단일 결제 유형에 대한 코드와 이름이 포함되어 있습니다. REST에 모든 결제 유형의 연속된 배열을 포함하는 단일 인스턴스가 반환됩니다.
PaymentType.code 문자열 카드에 대한 두 자리 코드입니다. creditCardType 예약 요청 요소와 사용하는 경우입니다.
PaymentType.name 문자열 카드에 대한 설명형 이름입니다(표시에 적합함)
PaymentType.thirdPartyVerificationType 문자열 카드 확인 메커니즘에 대해 설명합니다.
PaymentType.mandatoryDisplayText 문자열

결제를 처리할 국가를 설명하는 전체 문장 문자열을 반환합니다(아래 예 참조). 모든 카드 유형에 대해 이 필드를 확인하십시오. 이 필드의 값을 하드 코딩하지 마십시오.

PaymentType.processorCountryCode 문자열

mandatoryDisplayText 문자열로 표시되는 결제 처리 국가를 확인하기 위한 2자리 국가 코드를 반환합니다.

XML 요청 예:

http://api.ean.com/ean-services/rs/hotel/v3/paymentInfo?
minorRev=[current minorRev #]
&cid=XXXXX
&sig=########
&apiKey=[xxx-yourOwnKey-xxx]
&customerUserAgent=[xxx]
&customerIpAddress=[xxx]
&customerSessionId=[xxx]
&locale=en_US
&currencyCode=USD
&xml=
<HotelPaymentRequest>
<hotelId>122212</hotelId>
<supplierType>E</supplierType>
<rateType>MerchantStandard</rateType>
</HotelPaymentRequest>

예시 XML 결제 유형 응답:

<ns2:HotelPaymentResponse xmlns:ns2="http://v3.hotel.wsapi.ean.com/" size="6" currencyCode="USD">
<customerSessionId>bdb5eab4-1eff-4874-8389-5105e6ea2bfd</customerSessionId>
<PaymentType>
<code>AX</code>
<name>American Express</name>
</PaymentType>
<PaymentType>
<code>DC</code>
<name>DINERS CLUB INTERNATIONAL</name>
</PaymentType>
<PaymentType>
<code>DS</code>
<name>Discover</name>
</PaymentType>
<PaymentType>
<code>JC</code>
<name>JCB</name>
</PaymentType>
<PaymentType>
<code>CA</code>
<name>Master Card</name> <thirdPartyVerificationType>3DS</thirdPartyVerificationType>
<mandatoryDisplayText>This payment will be processed in the United States.</mandatoryDisplayText>
</PaymentType>
<PaymentType>
<code>VI</code>
<name>Visa</name> <thirdPartyVerificationType>3DS</thirdPartyVerificationType>
<mandatoryDisplayText>This payment will be processed in the United States.</mandatoryDisplayText>
</PaymentType>
</ns2:HotelPaymentResponse>

 

예시 REST 결제 유형 응답:

http://api.ean.com/ean-services/rs/hotel/v3/paymentInfo?
minorRev=[current minorRev #]
&cid=XXXXX
&sig=########
&apiKey=[xxx-yourOwnKey-xxx]
&customerUserAgent=[xxx]
&customerIpAddress=[xxx]
&customerSessionId=[xxx]
&locale=en_US
&currencyCode=USD
&hotelId=122212
&supplierType=E
&rateType=MerchantStandard

예시 JSON 결제 유형 응답:

{
"HotelPaymentResponse": {
"@size": "6",
"@currencyCode": "USD",
"customerSessionId": "1c3bbc85-09bd-414f-9215-96c51cbf87b7",
"PaymentType": [
{
"code": "AX",
"name": "American Express"
}, {
"code": "DC",
"name": "DINERS CLUB INTERNATIONAL"
}, {
"code": "DS",
"name": "Discover"
}, {
"code": "JC",
"name": "JCB"
}, {
"code": "CA",
"name": "Master Card", "thirdPartyVerificationType": "3DS",
"mandatoryDisplayText": "This payment will be processed in the United States."
}, {
"code": "VI", "thirdPartyVerificationType": "3DS",
"name": "Visa",
"mandatoryDisplayText": "This payment will be processed in the United States."
}
]
}
}