Requisitos de lançamento para B2C somente acomodação
Esses requisitos de lançamento se aplicam a todos os parceiros do Expedia Group com um modelo de integração business-to-consumer (B2C), em que os clientes finais interagem diretamente com sua integração.
Visão geral
Esses requisitos foram categorizados em duas seções:
- **Requisitos para B2C somente acomodação: **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
Você pode encontrar uma lista de verificação para ajudar a dar suporte ao seu desenvolvimento ou fornecer feedback sobre os requisitos aqui. 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 acomodação
Requisitos comuns
Os requisitos de lançamento abaixo se aplicam a todos os parceiros do Expedia Group 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: É proibido o uso de nomes e logotipos do Expedia Group ou do Expedia Group.
O uso de nomes e logotipos do Expedia Group só pode ser feito em sites de contato com clientes ou agentes mediante aprovação prévia e explícita por escrito do Expedia Group, como exceção.
Exemplo:
GR2: Links para o URL dos Termos e Condições do Grupo Expedia a serem exibidos.
Forneça um link para os Termos e Condições do Expedia Group no texto dos termos e condições do seu site ou crie um link direto para os termos na sua página de reservas. 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: Expedia Group MoR - Uso e exibição adequados em relação aos regulamentos de cartão de crédito.
Ao obter, usar, transmitir, armazenar ou processar dados do titular do cartão do cliente final, você deverá cumprir o PCI DSS emitido pelo PCI Security Standards Council. Uma referência completa para estes regulamentos está disponível no site oficial Site de padrões de segurança PCI .
GR5: Expedia Group MoR ou Property Collect - Evidência de conformidade com PCI fornecida para parceiros aplicáveis.
Quando o Expedia Group ou a propriedade for MoR, uma Atestado de Conformidade (AOC) deverá ser fornecida como evidência de conformidade com o PCI. Você pode encontrar conselhos sobre conformidade com PCI no site oficial Site de padrões de segurança PCI .
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 permitir crianças viajando, você deve oferecer a possibilidade de especificar a idade de cada criança viajando no momento do check-in. 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 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 de interface de 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 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": [...]
}
},Exemplo de interface do usuário:
AP2 – A sinalização de não reembolsável precisa estar bem visível
As disponibilidades não reembolsáveis são indicadas porrefundable=false no Comprar resposta de disponibilidade. Quandorefundable=false for retornado em uma resposta de disponibilidade, identifique claramente os quartos aplicáveis. Esse valor sempre prevalece sobre quaisquer dados de políticas diferentes. Essas reservas não serão reembolsadas pela propriedade em nenhuma circunstância.
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:
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.
Ospecial_instructions o campo pode incluir informações críticas para o check-in que não estão incluídas nocheckin objetoinstructions campo, como um requisito para notificar a propriedade sobre o horário previsto de chegada, fazer check-in em um local diferente do prédio do hóspede ou um alerta para esperar instruções especiais de check-in da 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 interface do usuário:
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.
Ospecial_instructions o campo pode incluir informações críticas para o check-in que não estão incluídas nocheckin objetoinstructions campo, como um requisito para notificar a propriedade sobre o horário previsto de chegada, fazer check-in em um local diferente do prédio do hóspede ou um alerta para esperar instruções especiais de check-in da 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.
| Resposta | Significado |
|---|---|
refundable=true | Essa tarifa é totalmente reembolsável. |
refundable=true + cancel_penalties | • Esta tarifa é reembolsável durante o período de cancelamento. • O mais antigo cancel_penalties.[].start é o prazo de cancelamento gratuito, se for um cronograma futuro.• A tarifa é 100% não reembolsável após o último cancel_penalties.[].end |
refundable=false | • Esta taxa é non-refundable. • Nenhuma janela de multa de cancelamento é retornada. |
refundable=false + cancel_penalties | • A tarifa pode ser parcialmente reembolsável. • cancel_penaltiesdeve ser exibido em conjunto com nonrefundable_date_ranges, que mostrará as datas de estadia desse intervalo como non-refundable assim que a reserva for criada. |
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 de interface do usuário:
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. Apresente ao viajante a moeda local e solicite moeda. Essas taxas são cobradas diretamente pelo propriedade (não pelo Expedia Group ou governos locais) e não fazem parte das taxas, impostos ou encargos padrão de recuperação de impostos incluídos na linha de impostos e taxas.
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 de interface do usuário:
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 child_ages.
BP8: Expedia Group MoR ou propriedade Cobrar: informe quando o pagamento será cobrado do viajante final.
Se Expedia Group MoR, informe que o cartão de crédito fornecido será cobrado imediatamente pelo valor total da reserva.
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.
Expedia Group MoR ou propriedade Coletar.
Se Expedia Group for o MoR, ou propriedade Collect for usado com clientes europeus, o caminho de reserva deve incluir a adoção das APIs do Rapid para autenticação two-factor.
Afiliado 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 MoR - Cartão corporativo ou cartão virtual.
Os parceiros que pagam Expedia Group com um cartão partner-owned, emitido em um país dentro do EEE, devem seguir os requisitos dos regulamentos 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. Configuração de perfil especial necessária.
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: Expedia Group MoR – Local de processamento de pagamento exibido nas páginas de checkout
Quando Expedia Group for MoR, o país onde o pagamento será processado deve ser exibido em um local de destaque na página de finalização da compra. 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 de interface do usuário:
