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 カードの記述的名称 (表示に適切)。
PaymentType.thirdPartyVerificationType string クレジットカードの検証メカニズムの説明。
PaymentType.mandatoryDisplayText string

どの国で支払いが処理されるかを説明する完全な文章を返します (下記の例を参照)。すべてのカード タイプのフィールドを確認してください。このフィールドの値をハードコード化しないでください。

PaymentType.processorCountryCode string

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