Requisitos de lançamento para B2B somente quarto

BP5 – A exibição de preços deve incluir o preço total e o detalhamento dos impostos e taxa A) Preço total

O preço total da reserva deve ser mostrado ao viajante na página de pagamento. O preço total deve corresponder à resposta da API, sem permissão de arredondamento nem conversão de moeda. O detalhamento final do preço deve incluir as diárias ou o valor total, quaisquer outros valores de diárias, todos os valores das taxas e impostos bem como o total a ser cobrado informando o que é pago on-line na reserva e o que é pago na propriedade.

B) Detalhamento de impostos

O valor retornado para tax_and_service_fee não inclui mais taxas não exigidas por uma jurisdição fiscal, e o valor retornado para property_fee agora inclui taxas que não são cobradas pelo governo, bem como taxas que não são cobradas pela propriedade. O valor retornado para property_fee inclui outras taxas além das taxas impostas pela propriedade e não deve ser exibido como "taxas de propriedade". A exibição do preço da página de checkout deve incluir a soma de tax_and_service_fee e property_fee como uma linha intitulada "impostos e taxas". tax_and_service_fee line deve ser exibido de modo separado para todas as referências fiscais em outras páginas. A apresentação do texto abaixo é exigida por lei ao se referir a quaisquer valores de impostos e taxas em um detalhamento de preço.

Uma descrição de impostos e taxas deve ser apresentada retransmitindo as informações abaixo. Isso pode ser mostrado como uma janela pop-up, um texto simples, um modal ou de outra maneira:

_“Esta cobrança inclui os valores estimados que o provedor de serviços de viagem, por exemplo, o hotel ou a locadora de carros, vai pagar em impostos ou os impostos que vamos pagar às autoridades fiscais pela sua reserva, incluindo, entre outros, impostos sobre vendas, ocupação e o imposto sobre valor agregado. Esse valor também pode incluir quantias cobradas de nós por taxas de estadia, limpeza e outros tipos ou uma taxa que nós, o hotel ou o site no qual a reserva foi feita retemos como parte da remuneração pelo serviço prestado, a qual pode variar de acordo com fatores como a localização, o valor e o método de reserva. Para mais detalhes, consulte os termos e condições.”_Traduções podem ser encontradas [aqui] (https://support.expediapartnersolutions.com/hc/en-us/articles/360020962379-Tax-and-Fee-Translations).

C) Cobranças pelos serviços e pelas reservas de parceiros

Na medida em que o Expedia Group concede uma isenção para permitir cobranças por reservas, as cobranças pelos serviços ou pelas reservas de parceiros devem ser separadas com clareza. Se uma cobrança de serviço imposta pelo parceiro for adicionada à reserva, deve ficar nítido para o cliente que a cobrança é feita pelo parceiro, e não pela EPS por um serviço separado, ou seja, não é uma cobrança extra para o fornecimento da acomodação. As cobranças não podem ser incluídas nos itens de "impostos e taxas" existentes. O parceiro não deve usar a palavra "taxa" para descrever cobranças impostas por ele. É possível usar "cobrança de reserva de afiliados" ou "cobrança de serviços de afiliados".

CP1 – A exibição de preços deverá incluir o preço total e os impostos e taxas se um detalhamento for disponibilizado

A) Preço total

O preço total da reserva deve ser mostrado ao viajante na página de pagamento. O preço total deve corresponder à resposta da API, sem permissão de arredondamento nem conversão de moeda. O detalhamento final do preço deve incluir as diárias ou o valor total, quaisquer outros valores de diárias, todos os valores das taxas e impostos bem como o total a ser cobrado informando o que é pago on-line na reserva e o que é pago na propriedade.

B) Detalhamento de impostos

O valor retornado para tax_and_service_fee não inclui mais taxas não exigidas por uma jurisdição fiscal, e o valor retornado para property_fee agora inclui taxas que não são cobradas pelo governo, bem como taxas que não são cobradas pela propriedade. O valor retornado para property_fee inclui outras taxas além das taxas impostas pela propriedade e não deve ser exibido como "taxas de propriedade". A exibição do preço da página de checkout deve incluir a soma de tax_and_service_fee e property_fee como uma linha intitulada "impostos e taxas". tax_and_service_fee line deve ser exibido de modo separado para todas as referências fiscais em outras páginas. A apresentação do texto abaixo é exigida por lei ao se referir a quaisquer valores de impostos e taxas em um detalhamento de preço.

Uma descrição de impostos e taxas deve ser apresentada retransmitindo as informações abaixo. Isso pode ser mostrado como uma janela pop-up, um texto simples, um modal ou de outra maneira:

_“Esta cobrança inclui os valores estimados que o provedor de serviços de viagem, por exemplo, o hotel ou a locadora de carros, vai pagar em impostos ou os impostos que vamos pagar às autoridades fiscais pela sua reserva, incluindo, entre outros, impostos sobre vendas, ocupação e o imposto sobre valor agregado. Esse valor também pode incluir quantias cobradas de nós por taxas de estadia, limpeza e outros tipos ou uma taxa que nós, o hotel ou o site no qual a reserva foi feita retemos como parte da remuneração pelo serviço prestado, a qual pode variar de acordo com fatores como a localização, o valor e o método de reserva. Para mais detalhes, consulte os termos e condições.”_Traduções podem ser encontradas [aqui] (https://support.expediapartnersolutions.com/hc/en-us/articles/360020962379-Tax-and-Fee-Translations).

C) Cobranças pelos serviços e pelas reservas de parceiros

Na medida em que o Expedia Group concede uma isenção para permitir cobranças por reservas, as cobranças pelos serviços ou pelas reservas de parceiros devem ser separadas com clareza. Se uma cobrança de serviço imposta pelo parceiro for adicionada à reserva, deve ficar nítido para o cliente que a cobrança é feita pelo parceiro, e não pela EPS por um serviço separado, ou seja, não é uma cobrança extra para o fornecimento da acomodação. As cobranças não podem ser incluídas nos itens de "impostos e taxas" existentes. O parceiro não deve usar a palavra "taxa" para descrever cobranças impostas por ele. É possível usar "cobrança de reserva de afiliados" ou "cobrança de serviços de afiliados".

ER6 – A exibição de preços deve incluir o preço total e o detalhamento dos impostos e taxas

A) Preço total

O preço total da reserva deve ser mostrado ao viajante na página de pagamento. O preço total deve corresponder à resposta da API, sem permissão de arredondamento nem conversão de moeda. O detalhamento final do preço deve incluir as diárias ou o valor total, quaisquer outros valores de diárias, todos os valores das taxas e impostos bem como o total a ser cobrado informando o que é pago on-line na reserva e o que é pago na propriedade.

B) Detalhamento de impostos

O valor retornado para tax_and_service_fee não inclui mais taxas não exigidas por uma jurisdição fiscal, e o valor retornado para property_fee agora inclui taxas que não são cobradas pelo governo, bem como taxas que não são cobradas pela propriedade. O valor retornado para property_fee inclui outras taxas além das taxas impostas pela propriedade e não deve ser exibido como "taxas de propriedade". A exibição do preço da página de checkout deve incluir a soma de tax_and_service_fee e property_fee como uma linha intitulada "impostos e taxas". tax_and_service_fee line deve ser exibido de modo separado para todas as referências fiscais em outras páginas. A apresentação do texto abaixo é exigida por lei ao se referir a quaisquer valores de impostos e taxas em um detalhamento de preço.

Uma descrição de impostos e taxas deve ser apresentada retransmitindo as informações abaixo. Isso pode ser mostrado como uma janela pop-up, um texto simples, um modal ou de outra maneira:

_“Esta cobrança inclui os valores estimados que o provedor de serviços de viagem, por exemplo, o hotel ou a locadora de carros, vai pagar em impostos ou os impostos que vamos pagar às autoridades fiscais pela sua reserva, incluindo, entre outros, impostos sobre vendas, ocupação e o imposto sobre valor agregado. Esse valor também pode incluir quantias cobradas de nós por taxas de estadia, limpeza e outros tipos ou uma taxa que nós, o hotel ou o site no qual a reserva foi feita retemos como parte da remuneração pelo serviço prestado, a qual pode variar de acordo com fatores como a localização, o valor e o método de reserva. Para mais detalhes, consulte os termos e condições.”_Traduções podem ser encontradas [aqui] (https://support.expediapartnersolutions.com/hc/en-us/articles/360020962379-Tax-and-Fee-Translations).

C) Cobranças pelos serviços e pelas reservas de parceiros

Na medida em que o Expedia Group concede uma isenção para permitir cobranças por reservas, as cobranças pelos serviços ou pelas reservas de parceiros devem ser separadas com clareza. Se uma cobrança de serviço imposta pelo parceiro for adicionada à reserva, deve ficar nítido para o cliente que a cobrança é feita pelo parceiro, e não pela EPS por um serviço separado, ou seja, não é uma cobrança extra para o fornecimento da acomodação. As cobranças não podem ser incluídas nos itens de "impostos e taxas" existentes. O parceiro não deve usar a palavra "taxa" para descrever cobranças impostas por ele. É possível usar "cobrança de reserva de afiliados" ou "cobrança de serviços de afiliados".

GR1 – Sem uso de nomes e logotipos do Expedia Group ou da EPS

Nenhum dos nomes ou logotipos do Expedia Group ou da EPS podem ser usados nos sites dos parceiros voltados para clientes qualquer que seja a finalidade. Qualquer exceção, por exemplo, avaliações de hóspedes, deve ser aprovada com antecedência pela EPS e aceita por escrito de maneira explícita.

Exemplo:

GR2 – Exibição de links para o URL dos termos e condições da EPS

Disponibilize um link para os termos e condições da EPS no texto dos termos e condições do seu site ou um link direto na sua página de reserva. Esses termos detalham as políticas que regem a reserva. Coloque o link a seguir em um local fácil de encontrar, usando o texto do link "termos e condições do fornecedor".

A versão em inglês pode ser encontrada aqui. Outras versões estão aqui.

Exemplo:

GR4 – EPS como MOR – Utilização e apresentação adequadas dos regulamentos referentes a cartões de crédito

Quando receber, usar, transmitir, armazenar ou processar os dados do titular do cliente final, você deve estar em conformidade com o PCI DSS conforme emitido pelo PCI Security Standards Council. Os regulamentos completos estão disponíveis para consulta no site oficial do PCI Security Standards.

GR5 – EPS como MOR ou Property Collect – Envio da comprovação de conformidade com o PCI aos parceiros apropriados

Quando a EPS ou a propriedade for o merchant of record, um atestado de conformidade (Attestation of Compliance ou AOC) deve ser fornecido como comprovação de conformidade com o PCI. Parceiros da EPS devem usar o arquivo do Questionário de autoavaliação do PCI Security Standards Council "SAQ D - Merchants" para gerar o AOC adequado.

É possível consultar as instruções e diretrizes dos questionários SAQ e encontrar o arquivo SAQ D - Merchants na Biblioteca de documentos oficial do PCI Security Standards Council ou baixar o arquivo SAQ D - Merchants como documento em formato GR ou do Word.

SP1 – Quando o afiliado permite a inclusão de crianças nas reservas, as devidas mensagens e informações sobre a idade das crianças são exigidas

Se a sua integração permite crianças, é preciso oferecer a possibilidade de especificar a idade de cada uma. Essas informações são apresentadas pelo elemento occupancy (veja exemplos de códigos abaixo).

Quando os clientes especificam viajantes crianças, a resposta da API pode conter restrições de idade e cobranças de ocupação extra ou uso de berço que, talvez, influenciem o custo ou a qualificação da reserva.

Cada propriedade define a faixa etária que classifica como criança. Menores de 17 anos costumam ser considerados crianças. Algumas propriedades não permitem hóspedes com menos de 18 anos.

Exemplo de solicitação da API:

https://api.ean.com/v3/properties/availability?checkin=2020-09-11
&checkout=2020-09-14
¤cy=USD&language=en-US& occupancy=2-9,4 &property_id=XXXX
&country_code=XX&sales_channel=XXXX
&sales_environment=XXXX&filter=XXXX&rate_plan_count=XXXX
&rate_option=XXXX&billing_terms=XXXX&payment_terms=XXXX
&partner_point_of_sale=XXXX&platform_name=XXXX

Exemplo de resposta da API:

"occupancies": {
        "2-9,4" : {
            "nightly": [
            [

Exemplo da interface do usuário: 1 quarto com 2 adultos e 2 crianças de 9 e 4 anos.

AP1 – Descrições do tipo de cama devem estar presentes em cada quarto

Respostas de compra podem retornar a matriz bed_groups com um único valor ou várias opções. Mostre os valores contidos na matriz de configuração para descrever as opções de cama do cliente.

Quando a matriz bed_groups retornar com várias opções, mostre os links de price_check apresentados pela resposta de compra para cada tipo de cama, para permitir a seleção do cliente.

É necessário mostrar uma mensagem ao viajante avisando que as escolhas entre vários tipos de cama para o mesmo quarto são apenas solicitações e podem não ser respeitadas na propriedade caso a disponibilidade não permita.

Os nomes dos quartos são retornados na matriz dos quartos da resposta de compra como room_name.

Exemplo de resposta da API, grupos de camas:

"property_id": "11775754",
        "rooms": [
            {
                "id": "230434524",
                 "room_name": "Superior double room" ,
                "rates": [
                    {
                       ...
                        "bed_groups": {
                            "133243": {
                                "id": "133243",
                                 "description": "Double bed" ,
                                "links": {...},
                                "configuration": [...]
                            },
                            "133242": {
                                "id": "133242",
                                 "description": "2 single beds" ,
                                "links": {...},
                                "configuration": [...]
                            }
                        },

AP2 – A sinalização de não reembolsável precisa estar bem visível

As tarifas não reembolsáveis devem ser claramente indicadas na página de disponibilidade. Quando refundable=false e nenhuma política de cancelamento é enviada, o quarto deve ser identificado como não reembolsável.

Exemplo de resposta da API:

"property_id": "XXXX",
"rooms": 
"id": "XXXX",
"room_name": "Fairmont King",
"rates": 
    "id": "XXXX",
    "status": "available",
    "available_rooms": 4999,
    "refundable": false ,
    "deposit_required": false,
    "merchant_of_record": "expedia",

Exemplo:

AP3 – Exibição de instruções especiais para o check-in e para o check-in

O conteúdo dos objetos checkin, checkout, fees e policies deve ser mostrado para cada quarto como retornado na definição do conteúdo da propriedade. Essas informações devem ser mostradas na página de disponibilidade para garantir que o cliente esteja ciente de possíveis taxas no momento do check-in ou instruções de acesso especial.

O campo special_instructions pode conter informações importantes para o check-in não incluídas no campo checkin do instructionsobjeto, como o requisito de informar à propriedade o horário estimado de chegada, check-in em um local diferente ou um aviso para esperar instruções especiais para o check-in enviadas pela propriedade por e-mail.

Confirme que instructions e special_instructions são mostradas na mesma área para o viajante.

Exemplo de resposta da API com instruções especiais para o check-in:

"11775754": {
        "property_id": "11775754",
        "checkin": {
            "begin_time": "16:00 PM",
            "end_time": "4:00 AM",
            "instructions": "Minimum age to check in is 18 years old.
                            Extra-person charges may apply and vary depending on property policy.
                            Government-issued photo identification and a credit card may be required at
                            check-in for incidental charges.
                            Special requests are subject to availability upon check-in and
                            may incur additional charges. Special requests cannot be guaranteed.",
            "special_instructions": "Front desk staff will greet guests on arrival. For more details,
                                    please contact the property using the information on the booking confirmation.",
            "min_age": 18
        "checkout": {
            "time": "11:00 AM"
        "fees": {
            "mandatory": "You'll be asked to pay the following charges at the property:
                            Deposit: USD 50 per day
                            Resort fee: USD 28.25 per accommodation, per night. The resort fee includes: Pool access, Fitness center access, Fitness/yoga classes, Airport shuttle, Phone calls, In-room safe, Self parking, Valet parking, and Parking.
                            We have included all charges provided to us by the property. However, charges can vary, for example, based on length of stay or the room you book.",
            "optional": "The following fees and deposits are charged by the property at time of service,
                        check-in, or check-out:
                        Breakfast fee: between USD 6 and USD 25 per person (approximately)
                        Late check-out is available for a fee (subject to availability)
                        Rollaway bed fee: USD 20.0 per night
                        The above list may not be comprehensive. Fees and deposits may not include tax
                        and are subject to change."
        "policies": {
            "know_before_you_go": "Up to 2 children 12 years old and younger stay free when
                                occupying the parent or guardian's room, using existing bedding. The property has connecting/adjoining rooms, which are subject to availability
                                and can be requested by contacting the property using the number on the booking confirmation."

Exemplo de conteúdo extraído da propriedade:

BP1 – A criptografia SSL está presente para dados pessoais

Ao enviar ou transmitir dados pessoais, você deve usar a criptografia SSL para proteger as conexões entre os navegadores ou apps do cliente e o seu site, bem como as comunicações de rede com sistemas dependentes. Dados pessoais incluem nomes, números de telefone ou e-mails de hóspedes, dados do cartão de pagamento, além de recibos de reserva ou itinerário e páginas de confirmação. Pare ou redirecione a conexão quando não for segura.

BP2 – Exibição de instruções especiais para o check-in e para o check-in

O conteúdo dos objetos checkin, checkout, fees e policies deve ser mostrado para cada quarto como retornado na definição do conteúdo da propriedade. Essas informações devem ser mostradas para garantir que o cliente esteja ciente de possíveis taxas no momento do check-in ou instruções de acesso especial antes de finalizar a reserva.

O campo special_instructions pode conter informações importantes para o check-in não incluídas no campo checkin do instructionsobjeto, como o requisito de informar à propriedade o horário estimado de chegada, check-in em um local diferente ou um aviso para esperar instruções especiais para o check-in enviadas pela propriedade por e-mail.

Confirme que instructions e special_instructions são mostradas na mesma área para o viajante.

BP3 – A política de cancelamento e a tag de não reembolsável devem ser exibidas de maneira nítida

Antes de permitir que clientes confirmem a compra na página final de reserva, você deve disponibilizar a política de cancelamento ou tag de não reembolsável para os quartos selecionados. A política de cancelamento de cada tarifa é apresentada no objeto cancel_penalties na API de disponibilidade de compras da Rapid.

No caso de tarifas reembolsáveis, a resposta inclui uma matriz de detalhes da política de cancelamento. Os detalhes incluem as datas inicial e final da multa especificada, bem como o tipo e o valor da multa, além de todas as datas de reserva com exceção que possam ser aplicadas. Os tipos de multa incluem um valor fixo, número de diárias e porcentagem do custo total.

Quando:

• refundable=true
  • Essa tarifa é totalmente reembolsável.
• refundable=true + cancel_penalties
  • Essa tarifa é reembolsável durante o período de cancelamento.
  • O primeiro cancel_penalties.[].start é o prazo de cancelamento grátis, se for um cronograma futuro, a taxa é 100% não reembolsável após o último cancel_penalties.[].end.
• refundable=false
  • Essa tarifa não é reembolsável.
  • Nenhuma janela de multa de cancelamento é retornada. refundable=false + cancel_penalties
• A tarifa pode ser parcialmente reembolsável.
  • cancel_penalties deve ser mostrado com nonrefundable_date_ranges, que vai mostrar as datas de estadia do intervalo que não são reembolsáveis depois da criação da reserva.

Mais informações sobre como elaborar políticas de cancelamento podem ser encontradas aqui.

Referência:

• refundable=false - Um valor não reembolsável vai ser cobrado imediatamente após a criação da reserva. cancel_penalties e nonrefundable_date_ranges têm mais detalhes.

• nonrefundable_date_ranges - As datas de estadia apresentadas nesse intervalo não são reembolsáveis depois da criação da reserva.

• cancel_penalties - Aplicável às datas de estadia que não estão envolvidas em nonrefundable_date_ranges.

  • A tarifa é 100% não reembolsável quando cancel_penalties estiver em branco ou não for retornado.
  • Uma cobrança de multa vai ser feita no cancelamento durante o período de cancel_penalties.
  • O primeiro cancel_penalties.[].start é o prazo de cancelamento grátis. Se é um cronograma futuro, a taxa é 100% não reembolsável após o último cancel_penalties.[].end.

Exemplo de respostas da API:

Totalmente reembolsável:

"property_id": "XXXX",
        "rooms": [
            {
                "id": "XXXX",
                "room_name": "Traditional Room",
                "rates": 
                        "id": "XXXX",
                        "status": "available",
                        "available_rooms": 4999,
                         "refundable": true,
                         "cancel_penalties":  [
                            {
                                "start": "2021-05-27T18:00:00.000-07:00",
                                "end": "2021-05-28T18:00:00.000-07:00",
                                "amount": "76.00",
                                "currency": "USD"

Não reembolsável:

"property_id": "XXXX",
        "rooms": 
                "id": "XXXX",
                 "room_name": "Traditional Room",
                "rates": 
                        "id": "XXXX",
                        "status": "available",
                        "available_rooms": 4999,
                         "refundable": false ,
                        "deposit_required": false,
                        "merchant_of_record": "expedia",

Parcialmente reembolsável:

"property_id": "XXXX",
        "rooms": [
            {
                "id": "XXXX",
                "room_name": "Traditional Room",
                "rates": 
                        "id": "XXXXXXXX",
                        "status": "available",
                        "available_rooms": 4999,
                         "refundable": false,

                         "cancel_penalties": [
                            {
                                "start": "2023-09-03T13:59:00.000+02:00",
                                "end": "2023-09-04T13:59:00.000+02:00",
                                "nights": "1",
                                "currency": "USD"
                            }
                        ],
                        "nonrefundable_date_ranges": [
                            {
                                "start": "2023-09-08",
                                "end": "2023-09-13"
                            }
                        ],

Exemplo:

BP4 – Exibição de cobranças devidas na propriedade separada no detalhamento do preço

Quando as cobranças forem retornadas na matriz de taxas, mostre cada valor separado como uma cobrança devida na propriedade, no check-in ou no check-out. Essas cobranças são feitas pela propriedade, não pelos governos locais nem pela EPS, e não fazem parte das cobranças padrão de impostos, encargos de restituição de imposto ou taxas incluídos na linha correspondente.

Exemplo de resposta da API:

"fees" : {
                                     "resort_fee":  {
                                        "request_currency": {
                                            "value": "74.97",
                                            "currency": "USD"
                                        },
                                        "billable_currency": {
                                            "value": "74.97",
                                            "currency": "USD"
                                        },
                                        "scope": "per_accommodation",
                                        "frequency": "per_night"
                                    }
                                },

Exemplo:

BP7 – Se apropriado, as idades das crianças devem ser reiteradas

Se a sua integração permite a inclusão de crianças, e o cliente as especificar na seleção do quarto, você deve confirmar com clareza o número de viajantes que são crianças e as idades delas nas páginas de reservas. Essas informações são apresentadas pelo elemento occupancy.

BP8 – EPS como MOR ou Property Collect: informe quando o pagamento será cobrado de viajantes finais

No caso da EPS como MOR, declare que o valor total da reserva vai ser cobrado de imediato no cartão de crédito informado.

No caso de Property Collect, declare que a cobrança vai ser feita pela propriedade no momento do check-in ou do check-out no cartão de crédito informado. Se a propriedade oferece uma tarifa de pós-pagamento não reembolsável, indique que o cliente pode receber uma cobrança da propriedade logo após concluir a reserva.

BP9 – Conformidade com os Regulamentos do Espaço Econômico Europeu: Diretiva de Serviços de Pagamento 2 (PSD2)

A conformidade com a PSD2 é necessária para qualquer parceiro que pretenda realizar transações com clientes no Espaço Econômico Europeu (EEE). Saiba mais aqui.

EPS como MOR ou Property Collect

Se a EPS é o merchant of record ou se o modelo Property Collect é usado com clientes europeus, o caminho de reserva deve incluir a adoção das APIs da Rapid para autenticação de dois fatores.

Afiliado como MOR - Geral

Os parceiros devem seguir os requisitos de autenticação forte do cliente (SCA) dos regulamentos da PSD2 quando as transações com clientes estiverem nesse escopo. O texto completo da diretiva está disponível na Comissão Europeia. Mais informações sobre os padrões em conformidade que podem ser adotados estão disponíveis no “protocolo 3D Secure e especificação das funções principais” da EMVCo.

Afiliado como MOR - Cartão corporativo ou virtual

Parceiros que pagam a EPS com um cartão próprio do parceiro, emitido em um país do EEE, devem seguir os requisitos dos regulamentos da PSD2. Para mitigar a necessidade da PSD2 2FA, o parceiro pode usar um cartão em conformidade com pagamentos B2B, isento da autenticação de dois fatores (2FA).

Algumas opções em conformidade:

1. Cartões virtuais de uso único.
2. Cartão corporativo multiuso registrado em nome da empresa, não de uma pessoa.

Exemplo de solicitação da API para verificação de preço:

https://api.ean.com<Price Check link from previous availability request>

Exemplo de resposta da API para verificação de preço:

{
  "status": "available",
    "occupancy_pricing": {... },
    "links": {
         "payment_session":  {
            "method": "POST",
            "href": "/v3/payment-sessions?token=XXXX"
        }
    }
}

BP10 – EPS como MOR ou Property Collect Premium – Exibição do local de processamento do pagamento nas páginas de pagamento

Quando a EPS ou a propriedade for o merchant of record, mostre em destaque na página de pagamento o país no qual o pagamento vai ser processado. A frase "Este pagamento será processado em" deve ser inserida antes do nome do país.

Use a função de opções de pagamento da API de compras para conseguir essa informação.

Exemplo de solicitação da API para opções de pagamento:

https://api.ean.com<payment-options link from previous availability request>

Exemplo de resposta da API para opções de pagamento:

"credit_card": {
        "name": "Credit Card",
        "card_options": [
                 "name": "MasterCard",
                 "processing_country": "US"

                "name": "Visa",
                 "processing_country": "US"

Exemplo de interface do usuário:

Se você vai disponibilizar um voucher hospedado em um app para dispositivo móvel, continue seguindo os requisitos abaixo.

ER1 – IDs de itinerário mostrados de maneira correta

Se a sua integração apresentar o itinerary_id da EPS a clientes, mostre esse número com nitidez no e-mail de confirmação. Se aplicável, você deve fornecer provas de que seus agentes têm acesso aos IDs de itinerário de EPS originais, caso precisem de assistência do suporte ao cliente da EPS.

ER2 – O serviço de atendimento ao cliente deve ser mostrado em evidência, incluindo os links para as ferramentas on-line desse serviço

Mostre com clareza os seus canais de atendimento ao cliente no fluxo de reservas ou no e-mail de confirmação. Por exemplo: número de telefone ou chat ao vivo. Se os agentes da EPS vão oferecer atendimento direto aos seus clientes, mostre o número do atendimento da EPS no seu fluxo de reservas.

ER3 – Descrições do tipo de cama devem estar presentes em cada quarto

Confirme o tipo de cama solicitado pelos viajantes no seu voucher ou e-mail de confirmação e mostre uma mensagem avisando que as escolhas entre vários tipos de cama para o mesmo quarto são apenas solicitações e talvez não sejam respeitadas no hotel caso a disponibilidade não permita.

Mostre os valores contidos na matriz de configuração para descrever as opções de cama do cliente.

ER4 – Exibição de instruções especiais para o check-in e para o check-in

O conteúdo dos objetos checkin, checkout, fees e policies deve ser mostrado para cada quarto como retornado na definição do conteúdo da propriedade. Essas informações devem ser mostradas para garantir que o cliente esteja ciente de possíveis taxas no momento do check-in ou instruções de acesso especial antes de finalizar a reserva.

O campo special_instructions pode conter informações importantes para o check-in não incluídas no campo checkin do instructionsobjeto, como o requisito de informar à propriedade o horário estimado de chegada, check-in em um local diferente ou um aviso para esperar instruções especiais para o check-in enviadas pela propriedade por e-mail.

Confirme que instructions e special_instructions são mostradas na mesma área para o viajante.

ER5 – Exibição de cobranças devidas na propriedade separada no detalhamento do preço

Quando as cobranças forem retornadas na matriz de taxas, mostre cada valor separado como uma cobrança devida na propriedade, no check-in ou no check-out. Essas cobranças são feitas pela propriedade, não pelos governos locais nem pela EPS, e não fazem parte das cobranças padrão de impostos.

TR1 – Exibição do ID de referência de afiliado exclusivo em cada solicitação de reserva

Em cada solicitação de reserva, você deve usar o elemento affiliate_reference_id para fins de:

• seu próprio rastreamento;
• evitar reservas ou cobranças duplicadas pelo envio de vários formulários;
• verificar os sistemas da EPS quanto a um itinerário se a reserva alcançar o tempo limite ou retornar um resultado vazio devido a processos de upstream que alcançaram o tempo limite.

{
  "affiliate_reference_id": "Launch_Requirement_TR1" ,
 "hold": false,
 "email": "TR4@Launch.Requirement",
 "phone": {
    "country_code": "Launch_Requirement_TR5b",
    "number": "Launch_Requirement_TR5b",
    "area_code": "Launch_Requirement_TR5b"
 },
"rooms": [
 {
    "given_name": "John_Launch_Requirement_TR5a",
    "family_name": "Doe_Launch_Requirement_TR5a",
    "smoking": false,
 },
 {
    "given_name": "David_Launch_Requirement_TR5a",
    "family_name": "Smith_Launch_Requirement_TR5a",
    "smoking": false,
 }
],

TR2 – Exibição do código do país do viajante em cada solicitação

• O country_code do viajante deve ser passado nas solicitação da API de compras e de recomendações. O código do país deve corresponder ao ponto de venda acessado pelo cliente.
• Esse requisito garante que os sistemas da Rapid forneçam o conteúdo relevante e as tarifas mais adequadas aos clientes, de acordo com o mercado de venda.

Exemplo de solicitação da API:

https://api.ean.com/v3/properties/availability?checkin=2020-09-11
&checkout=2020-09-14
¤cy=USD&language=en-US&occupancy=2-3,4&property_id=XXXX
&country_code=XX&sales_channel=XXXX
&sales_environment=XXXX&filter=XXXX&rate_plan_count=XXXX
&rate_option=XXXX&billing_terms=XXXX&payment_terms=XXXX
&partner_point_of_sale=XXXX&platform_name=XXXX

TR3 – Dados de cobrança

TR3a) Nome do pagante

Para cliente, cartão corporativo e virtual:

• Parceiros devem enviar o nome do titular cujo cartão está sendo cobrado pela EPS.

Para parceiros Affiliate Collect/EAC:

• Sempre que possível, a EPS recomenda que parceiros enviem o nome do pagante final real da reserva.
• Essas informações são necessárias para fins de triagem regulatória ou sanções.
• Caso não seja possível informar o nome do pagante final real, informe o nome da empresa ou pessoa jurídica do parceiro que vai pagar a EPS.

Se o ponto de venda é Rússia, Ucrânia ou Venezuela, as informações do pagante real são sempre obrigatórias.

TR3b) País de cobrança

Deve representar o nome individual passado no campo de contato para cobrança ou nome do pagante.

TR3c) CEP de cobrança

Deve representar o nome individual passado no campo de contato para cobrança ou nome do pagante.

No caso de países que não têm CEP, essa informação não precisa ser apresentada.

"payments": [
   {
       "type": "customer_card",
       "billing_contact": {
           "given_name": "Launch_Requirement_TR3a",
           "family_name": "Launch_Requirement_TR3a",
       "address": {
           "line_1": "555 1st St",
           "line_2": "10th Floor",
           "line_3": "Unit 12",
           "city": "Seattle",
           "state_province_code": "WA",
           "postal_code": "Launch_Requirement_TR3c",
           "country_code": "Launch_Requirement_TR3b"
       }
   },

TR4 – Exibição do endereço de e-mail do cliente ou da caixa de entrada de e-mail monitorada

O elemento de e-mail de cada itinerário deve conter o endereço de e-mail do viajante ou a caixa de entrada monitorada pela sua integração para o processamento dos e-mails de confirmação. Isso é necessário para casos de disputas de reserva ou solução de problemas.

TR5 – Exibição de informações corretas de viajantes

TR5a) Nome do viajante

As reservas da Rapid sempre devem ser enviadas com o nome dos viajantes que vão, de fato, se hospedar em cada quarto reservado. Isso significa que no corpo da solicitação da reserva, os valores de given_name e family_name no objeto rooms devem corresponder ao nome e ao sobrenome do hóspede principal que vai fazer o check-in em cada quarto.

TR5b) Número de telefone do viajante

A reserva deve incluir um número de contato funcional do viajante. Inclua esse número no campo de telefone da solicitação de reserva de cada itinerário. A EPS não vai entrar em contato com viajantes se os agentes do parceiro disponibilizarem atendimento direto a clientes finais.

TR6 – Reservas de vários quartos

Se as reservas de vários quartos forem compatíveis, forneça os registros de solicitação e resposta da API para uma reserva de teste que mostre que cada quarto foi reservado e cancelado.

Cada quarto reservado cria um ID de confirmação diferente, que permite que os quartos sejam cancelados separados. Para cancelar todos os quartos, faça uma chamada de cancelamento para cada ID de confirmação no itinerário.

A EPS não oferece reservas para grupos com mais de 8 quartos de maneira direta por meio da nossa API ou do nosso modelo. O seu representante da EPS poderá orientar você se for preciso reservar mais de 8 quartos.

TR7 – Recomendações de tratamento de erros da Rapid

Confirme que você leu as nossas recomendações de tratamento de erros da Rapid e implementou a lógica necessária para a sua aplicação.