通貨に対応している種類のクレジット カード、currencyCode および locale 共通パラメーターで指定されたロケールを取得します。レスポンスで返されるカードの種類はすべて、指定したパラメーターと共に使用した場合の予約で有効です。

このリクエストは通常、予約時にお客様が希望する通貨の支払いオプションの一覧を作成するために使用されます。

支払いカードと検証については、[有効なカード タイプ](/general-info/valid-card-types) を確認してください。

リクエストのフォーマット
XML / REST URL: GET http://api.ean.com/ean-services/rs/hotel/v3/paymentInfo?
XML 親エレメント : <HotelPaymentRequest>


リクエスト パラメータ

サービス固有の URL パラメータの要件
名前 必須 説明
apiExperience string はい

この属性を使用して、リクエストの発信元を識別します。以下に示されているセットの中から、送信する各リクエストに該当する値を 1 つ選択します。

値 :
PARTNER_CALL_CENTER - コール センターのエージェントからのリクエスト
PARTNER_WEBSITE - お客様向けの Web サイトからのリクエスト
PARTNER_MOBILE_WEB - モバイル向けの Web サイトからのリクエスト
PARTNER_MOBILE_APP - モバイル アプリからのリクエスト
PARTNER_BOT_CACHE - キャッシュ ボットからのリクエスト
PARTNER_BOT_REPORTING - レポート ボットからのリクエスト
PARTNER_AFFILIATE - 独自のアフィリエイト ベースに対応する API / プラットフォームからのリクエスト

currencyCode string はい 支払い情報が必要な通貨コード
locale string はい

支払い情報が必要なロケール


通貨コード、ロケール、料金タイプ、サプライヤ タイプはすべてのリクエストに対して動的に入力されなければなりません。これらの値をハードコーディングすると、正しくない支払いタイプを返す原因となる可能性があります。



基本パラメータ
名前 必須 説明
hotelId string はい 施設の hotelId
supplierType string はい

支払い情報が必要となるサプライヤ タイプ。
サポートによって指示があった場合を除き、E の値 (Expedia Collect 用) を送信します。

rateType string はい 支払い情報が必要なホテルの部屋の空室状況レスポンスの料金タイプ。
使用できる値 :
  • MerchantStandard
  • MerchantPackage
  • DirectAgency


レスポンス コンテンツ
親エレメント : HotelPaymentResponse

親エレメントには、返されたオプション数を示すための size 属性、およびリクエストで指定された通貨コードを確認するための currencyCode があります。親エレメントには、個別の支払いオプションを含む PaymentType, があります。
名前 説明
PaymentType object XML の下には、単一の支払いタイプ用のコードと名前があります。REST には、すべての支払いタイプのシリアル化された配列を含む単一のインスタンスが返されます。
PaymentType.code string カードの 2 桁のコード。creditCardType 予約リクエスト エレメントで使用する。
PaymentType.name string カードの記述的名称 (表示に適切)。

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