Recupera os tipos de cartão compatíveis com a moeda e a localidade especificadas nos parâmetros comuns currencyCode e locale, respectivamente. Todos os tipos de cartão retornados na resposta são válidos para reservas com os parâmetros fornecidos.

Esta solicitação costuma ser usada para criar listas de opções de pagamento na moeda preferida de um cliente ao fazer uma reserva.

Consulte tipos de cartão válidos para obter mais detalhes sobre cartões de pagamento e validação.

Formatos de solicitação
URL em XML/REST: GET http://api.ean.com/ean-services/rs/hotel/v3/paymentInfo?
Elemento pai XML: <HotelPaymentRequest>


Parâmetros de solicitação

Requisitos de parâmetro de URL específico do serviço
Nome Valor Obrigatório Descrição
apiExperience string sim

Use esse atributo para identificar a origem de sua solicitação. Selecione um valor aplicável do conjunto fornecido abaixo para cada solicitação enviada.

Valores:
PARTNER_CALL_CENTER - solicitação de um agente no seu call center
PARTNER_WEBSITE - solicitação de um site direcionado aos clientes
PARTNER_MOBILE_WEB - solicitação de um site formatado para dispositivos móveis
PARTNER_MOBILE_APP - solicitação de um app
PARTNER_BOT_CACHE - solicitação de um robô de cache
PARTNER_BOT_REPORTING - solicitação de um robô de relatório
PARTNER_AFFILIATE - solicitação de uma API/plataforma usada por sua própria base de afiliados

currencyCode string sim O código da moeda para o qual são necessárias informações de pagamento
locale string sim

O local para o qual são necessárias informações de pagamento


Código de moeda, local, tipo de tarifa e tipo de fornecedor devem ser populados dinamicamente para todas as solicitações. Incorporar ao código qualquer desses valores pode fazer com que tipos de pagamento incorres sejam retornados.



Parâmetros base
Nome Valor Obrigatório Descrição
hotelId string sim O elemento hotelId do estabelecimento.
supplierType string sim

O tipo de fornecedor para o qual são necessárias informações de pagamento
Envie um valor de E (de Expedia Collect), exceto se instruído de outra forma pelo suporte.

rateType string sim O tipo de tarifa obtido da resposta de disponibilidade de quartos do hotel, para o qual são necessárias as informações de pagamento.
Valores permitidos:
  • MerchantStandard
  • MerchantPackage
  • DirectAgency


Conteúdo da resposta
Elemento pai: HotelPaymentResponse

O elemento pai tem os atributos size para indicar o número de opções retornadas e currencyCode para confirmar o código de moeda especificado na solicitação. O elemento pai contém PaymentType, com opções de pagamento individuais.
Nome Valor Descrição
PaymentType object Em XML, contém o código e o nome de um único tipo de pagamento. Em REST, uma única instância contendo uma matriz serializada de todos os tipos de pagamento que serão retornados.
PaymentType.code string O código de dois dígitos do cartão. Para usar com o elemento de solicitação de reserva creditCardType.
PaymentType.name string O nome descritivo do cartão (adequado para exibição).

Exemplo de solicitação 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>

Exemplo de resposta de tipo de pagamento 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>

 

Exemplo de solicitação de tipo de pagamento 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

Exemplo de resposta de tipo de pagamento 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"
}
]
}
}