Retrieves card types compatible with the currency and locale specified in the currencyCode and locale common parameters, respectively. All card types returned in the response are valid for bookings under the provided parameters.

This request is typically used to create lists of payment options for a customer's preferred currency when booking.

Review valid card types for more details on payment cards and validation.

If your integration will use virtual or corporate cards, review our virtual & corporate card best practices.

Request Formats
XML/REST URL: GET http://api.ean.com/ean-services/rs/hotel/v3/paymentInfo?
XML Parent Element: <HotelPaymentRequest>


Request Parameters

Service-Specific URL Parameter Requirements
Name Value Required Description
apiExperience string yes

Use this attribute to identify the origin of your request. Choose an applicable value from the set provided below for each request you send.

Values:
PARTNER_CALL_CENTER - request from an agent in your call center
PARTNER_WEBSITE - request from a customer-facing website
PARTNER_MOBILE_WEB - request from a mobile-formatted website
PARTNER_MOBILE_APP - request from a mobile app
PARTNER_BOT_CACHE - request from a cache bot
PARTNER_BOT_REPORTING - request from a reporting bot
PARTNER_AFFILIATE - request from an API/platform that serves your own affiliate base

currencyCode string yes The currency code for which payment information is needed
locale string yes

The locale for which payment information is needed


Currency code, locale, rate type and supplier type must be populated dynamically for every request. Hardcoding any of these values may cause incorrect payment types to return.



Base Parameters
Name Value Required Description
hotelId string yes The hotelId for the property.
supplierType string yes

The supplier type for which payment information is needed.
Send a value of E (for Expedia Collect) unless otherwise instructed by support.

rateType string yes The rate type from the hotel's room availability response for which payment information is needed.
Permitted values:
  • MerchantStandard
  • MerchantPackage
  • DirectAgency


Response Content
Parent Element: HotelPaymentResponse

The parent element has the attributes size, to indicate the number of options returned, and currencyCode, to confirm the currency code specified in the request. The parent element contains PaymentType, containing individual payment options.
Name Value Description
PaymentType object Under XML, contains the code and name for a single payment type. Under REST, a single instance containing a serialized array of all payment types will return.
PaymentType.code string The two-digit code for the card. For use with the creditCardType booking request element.
PaymentType.name string The descriptive name for the card (suitable for display).
PaymentType.thirdPartyVerificationType string Describes the card verification mechanism.
PaymentType.mandatoryDisplayText string

Returns a complete-sentence string describing where the country where the payment will be processed (see examples below). Check for this field for all card types. Do not hard-code values for this field.

This field's text is localized for the requested locale- see per-language string formats in the next table below.

PaymentType.processorCountryCode string

Returns a two-digit country code confirming the payment processing country indicated by the mandatoryDisplayText string.


> Jump to request/response examples


Localized mandatoryDisplayText String Formats

The mandatoryDisplayText string is localized according to the locale value using the following formats, where {0} represents the processing country:

Language mandatoryDisplayText string
English This payment will be processed {0}. This does not apply when a travel provider (airline / hotel / rail, etc.) processes your payment.
Arabic ستتم معالجة هذه المدفوعات {0}. لا يسري هذا في حالة قيام وكيل السفريات (خطوط الطيران/الفندق/شركة السكك الحديدية..إلخ) بمعالجة مدفوعاتك.
Czech Tato platba bude zpracována {0}. Výjimkou jsou případy, kdy zpracování platby zajišťuje sám dodavatel cestovní služby (letecká společnost, hotel, železniční dopravce atd.).
Danish Betalingen behandles {0}. Dette gør sig ikke gældende, når en rejseudbyder (flyselskab/hotel/togselskab osv.) behandler din betaling.
German Diese Zahlung wird {0} abgewickelt. Dies gilt nicht, wenn ein Reiseanbieter (Fluglinie/Hotel/Bahn usw.) Ihre Zahlung abwickelt.
Greek Η επεξεργασία αυτής της πληρωμής θα γίνει {0}. Αυτό δεν ισχύει, όταν ένας ταξιδιωτικός πάροχος (αεροπορική εταιρεία / ξενοδοχείο / σιδηροδρομική εταιρεία, κτλ.) πραγματοποιεί επεξεργασία της πληρωμής σας.
Spanish (Spain) El pago se procesará {0}. No es aplicable en los casos en los que un proveedor de viajes, ya sea una línea aérea, un hotel o una empresa ferroviaria, procesa el pago.
Spanish (Mexico) Este pago se procesará {0}. Esto no se aplica cuando un proveedor de viajes (aerolínea/hotel/servicios ferroviarios, etc.) procesa el pago.
Estonian Seda makset töödeldakse {0}. See ei kehti, kui teie makset töötleb reisipakkuja (lennufirma / hotell / rongfirma jne).
Finnish Tämä maksu käsitellään {0}. Tätä käsittelytapaa ei sovelleta silloin, kun maksun käsittelee matkantarjoaja (lentoyhtiö, hotelli, junayhtiö, jne.)
French Ce paiement sera traité {0},  sauf dans le cas où le paiement est traité par un fournisseur de voyage (compagnie aérienne / hôtel / compagnie ferroviaire, ou autre).
French (Canada) Ce paiement sera traité {0}. Cette modalité ne s'applique pas lorsque le fournisseur du produit de voyage (compagnie aérienne, hôtel, société ferroviaire, etc.) traite votre paiement.
Croatian Ovo će plaćanje biti obrađeno {0}. To se ne primjenjuje kad plaćanje obrađuje pružatelj usluga putovanja (zrakoplovna kompanija / hotel / željeznica itd.).
Hungarian A fizetés feldolgozására {0} kerül sor. Ez nem vonatkozik azokra a kifizetésekre, melyeket az utazási szolgáltató (pl. légitársaság/ szállás/ vasúttársaság, stb.) dolgoz fel.
Indonesian Pembayaran ini akan diproses {0}. Ini tidak berlaku jika penyedia travel (maskapai / hotel / kereta, dll.) yang memproses pembayaran Anda.
Icelandic Þessi greiðsla verður afgreidd {0}. Þetta á ekki við þegar ferðaþjónustuaðili (flugfélag / hótel / lestarfyrirtæki o.s.frv.) afgreiðir greiðsluna.
Italian Questo pagamento verrà elaborato {0}, a meno che a gestirlo non sia il fornitore del servizio (compagnia aerea, hotel, compagnia ferroviaria, ecc.).
Japanese このお支払いは{0}処理されます。旅行サービス業者 (航空会社 / 宿泊施設 / 鉄道など) がお客様のお支払いを処理する場合は該当しません。
Korean 이 결제는 {0} 처리됩니다. 이는 여행 공급자(예: 항공사, 호텔, 철도 등)가 결제를 처리하는 경우에는 해당되지 않습니다.
Lithuanian Šis mokėjimas bus apdorotas {0}. Tai netaikoma, kai jūsų mokėjimą apdoroja kelionės teikėjas (oro linijos, viešbutis, geležinkelio bendrovė ir t. t.).
Latvian Šī maksājuma apstrādes vieta būs {0}. Tas neattiecas uz gadījumiem, kad maksājumu apstrādā ceļojuma pakalpojuma sniedzējs (lidsabiedrība/viesnīca/dzelzceļa pārvadātājs utt.).
Malay Pembayaran ini akan diproses {0}. Ini tidak berkaitan apabila pembekal perjalanan (penerbangan / hotel / kereta api, dll.) memproses bayaran anda.
Dutch Deze betaling wordt verwerkt {0}. Dit geldt niet wanneer een reisaanbieder (luchtvaartmaatschappij / hotel / spoorwegmaatschappij etc.) de betaling verwerkt.
Norwegian Denne betalingen vil bli behandlet {0}. Dette gjelder ikke når en reiseoperatør (flyselskap / hotell / togselskap, osv.) behandler betalingen din.
Polish Płatność zostanie przetworzona {0}. Nie ma to jednak zastosowania, jeśli płatność przetwarza dostawca usług podróży (linia lotnicza / hotel / kolej itp.).
Portuguese (Portugal) O pagamento será processado {0}. Não se aplica se o seu pagamento for processado por um prestador de serviços de viagem (companhia área/ferroviária, hotel, etc.).
Portuguese (Brazil) Este pagamento será processado {0}. Isso não se aplica quando o pagamento é processado pelo fornecedor de viagem (companhia aérea/hotel/companhia ferroviária, etc.).
Russian Этот платеж будет обработан {0}, за исключением случаев, когда платеж обрабатывает поставщик туристических услуг (авиакомпания/отель/агентство по оформлению железнодорожных билетов и т. д.).
Slovak Táto platba bude spracovaná {0}. Neplatí v prípade, že poskytovateľ cesty (letecká spoločnosť / hotel / železničná spoločnosť atď.) spracuje vašu platbu.
Swedish Den här betalningen kommer att behandlas {0}. Gäller inte när din betalning hanteras av en reseleverantör (flygbolag/hotell/tågbolag, etc.).
Thai การชำระเงินนี้จะได้รับการดำเนินการ{0} ยกเว้นกรณีที่ผู้ให้บริการ (สายการบิน/โรงแรม/รถไฟ ฯลฯ) เป็นผู้เก็บเงิน
Turkish Bu ödeme {0} işleme alınacaktır. Ödemeniz bir seyahat tedarikçisi (havayolu şirketi/otel/tren şirketi vb.) tarafından işleme konduğunda bu durum söz konusu değildir.
Ukrainian Обробка платежу відбуватиметься {0}. Це не стосується платежів, що обробляються безпосередньо авіаперевізником, готелем, залізницею тощо.
Vietnamese Sẽ xử lý thanh toán {0}. Không áp dụng nếu đơn vị cung cấp dịch vụ (hãng hàng không / khách sạn / dịch vụ đường sắt, v.v.) xử lý thanh toán.
Chinese Simplified 付款将在{0}进行处理。旅行供应商(航空公司/酒店/铁路公司等)处理您付款的情况例外。
Chinese Traditional TW 付款將會在{0}進行處理。由旅遊供應商 (航空公司/飯店/火車票等) 所處理的付款不在此限。

Example XML Request:

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>

Example XML payment type response:

<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>

Example REST payment type request:

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

Example JSON payment type response:

{
"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."
}
]
}
}