Requisitos de lançamento para B2C somente quarto
Estes requisitos de lançamento são válidos para todos os parceiros da EPS com um modelo de integração entre a empresa e o cliente (B2C) em que clientes finais interagem com a sua integração de maneira direta.
Visão geral
Estes requisitos foram categorizados em duas seções para oferecer melhor suporte à sua experiência de integração:
- **Requisitos para B2C somente quarto: **são específicos para esse fluxo de reservas. Leia com atenção os requisitos, pois podem diferir de todos os outros tipos de tarifas ou fluxos de reserva que você integrou antes.
- Requisitos comuns: são comuns em todos os fluxos de reserva. Confirme que todos esses requisitos são atendidos em todos os fluxos.
Lista de verificação
Neste link você encontra uma lista de verificação para ajudar no seu desenvolvimento ou para enviar comentários sobre os requisitos. Se pretende disponibilizar capturas de tela para a revisão do seu site, adicione as imagens e os registros correspondentes na lista de verificação, pois isso nos ajuda a concluir o processo.
Requisitos para B2C somente quarto
Requisitos comuns
Os requisitos de lançamento abaixo se aplicam a todos os parceiros que usam a EPS em todos os fluxos de reserva. Outros requisitos específicos a cada tipo de tarifa, incluindo uma descrição detalhada da apresentação de preço, são disponibilizados em listas individuais de requisitos de tarifa.
GR1 – Sem uso de nomes e logotipos do Expedia Group ou da EPS
Nenhum dos nomes ou logotipos do Expedia Group ou 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. Os 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 PDF 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 implementadas
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 de ocupação (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 hotel 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=XXXXExemplo de resposta da API:
"occupancies": {
"2-9,4" : {
"nightly": [
[Exemplo: 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 no hotel 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:
"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 de interface do usuário de sinalização de não reembolsável:
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:
"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, 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 últimocancel_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_penaltiesdeve ser mostrado comnonrefundable_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_penaltiesenonrefundable_date_rangestê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 emnonrefundable_date_ranges.- A tarifa é 100% não reembolsável quando
cancel_penaltiesestiver 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 últimocancel_penalties.[].end.
- A tarifa é 100% não reembolsável quando
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 fees, 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 pelo governo local 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:
- Cartões virtuais de uso único.
- Cartão corporativo multiuso registrado em nome da empresa, não de uma pessoa.
Exemplo de solicitação da API:
https://api.ean.com<Price Check link from previous availability request>Exemplo de resposta da API:
{
"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:
https://api.ean.com<payment-options link from previous availability request>Exemplo de resposta da API:
"credit_card": {
"name": "Credit Card",
"card_options": [
{
"name": "MasterCard",
"processing_country": "US"
},
{
"name": "Visa",
"processing_country": "US"
}
]
}Exemplo:
