個別擷取與 currencyCodelocale 常用參數中指定的貨幣和地區設定相容的卡片類型。根據提供的參數,所有在回傳中傳回的卡片類型皆可供訂房使用。

此要求通常會在旅客預訂時針對旅客選擇的貨幣建立付款選擇的清單。

檢閱 有效卡片類型,了解付款信用卡與驗證的詳細資料。


要求格式
XML/REST URL: GET http://api.ean.com/ean-services/rs/hotel/v3/paymentInfo?
XML 父項目: <HotelPaymentRequest>


要求參數

服務指定網址參數要求
名稱 必要 說明
apiExperience 字串 yes

利用此屬性識別您要求的原點。請在下方提供的設定中,為每個您送出的要求選擇適當的值。

值:
PARTNER_CALL_CENTER - 來自客戶服務中心服務專員的要求
PARTNER_WEBSITE - 來自旅客服務網站的要求
PARTNER_MOBILE_WEB - 來自行動版網站的要求
PARTNER_MOBILE_APP - 來自行動 App 的要求
PARTNER_BOT_CACHE - 來自快取程式的要求
PARTNER_BOT_REPORTING - 來自報告程式的要求
PARTNER_AFFILIATE - 來自提供您專屬合作夥伴庫之 API/平台的要求

currencyCode 字串 yes 付款資訊中必要的貨幣代碼
locale 字串 yes

付款資訊中必要的地區代碼


必須針對每個要求動態填入貨幣代碼、地區設定、房價類型與供應商類型。對這些值進行硬式編碼可能會導致系統傳回錯誤的付款類型。



基本參數
名稱 必要 說明
hotelId 字串 yes 飯店的 hotelId
supplierType 字串 yes

付款資訊中必要的供應商類型。
除非客戶服務有另外的指示,否則請傳送 E 值 (針對 Expedia Collect)。

rateType 字串 yes 飯店空房情況回應的房價類型必須具備付款資訊。
允許的值:
  • MerchantStandard
  • MerchantPackage
  • DirectAgency


回應內容
父項目: HotelPaymentResponse

父項目具有 size屬性以指定回傳的選項數目;也具有 currencyCode屬性以確認要求中指定的貨幣代碼。父項目包含 PaymentType,,其中內含個別的付款選項。
名稱 說明
PaymentType 物件 XML 下包含單一付款類型的代碼及名稱。REST 下會回傳一個包含所有付款類型序列化陣列的單一個體。
PaymentType.code 字串 卡片的二位數代碼。與 creditCardType 預訂要求元素一起使用。
PaymentType.name 字串 卡片的敘述名稱 (可用於顯示)

範例 XML 要求:

http://api.ean.com/ean-services/rs/hotel/v3/paymentInfo?
minorRev=[current minorRev #]
&cid=55505
&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="4" currencyCode="USD">
<customerSessionId>0ABAAACD-001E-AA91-49E2-3C3A8FD9602A</customerSessionId>
<PaymentType>
<code>AX</code>
<name>American Express</name>
</PaymentType>
<PaymentType>
<code>DS</code>
<name>Discover</name>
</PaymentType>
<PaymentType>
<code>CA</code>
<name>Master Card</name>
</PaymentType>
<PaymentType>
<code>VI</code>
<name>Visa</name>
</PaymentType>
</ns2:HotelPaymentResponse>

 

REST 付款類型要求範例:

http://api.ean.com/ean-services/rs/hotel/v3/paymentInfo?
minorRev=[current minorRev #]
&cid=55505
&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": "4",
"@currencyCode": "USD",
"customerSessionId": "0ABAAAC9-9A32-7914-9E32-D7EC7F906769",
"PaymentType": [
{
"code": "AX",
"name": "American Express"
},
{
"code": "DS",
"name": "Discover"
},
{
"code": "CA",
"name": "Master Card"
},
{
"code": "VI",
"name": "Visa"
}
]
}
}