分别检索与 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 - 来自缓存 bot 的请求
PARTNER_BOT_REPORTING - 来自报告 bot 的请求
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 字符串指示的付款处理国家/地区。

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