Requisitos de lançamento para B2C somente acomodação
Esses requisitos de lançamento se aplicam se você tiver um modelo de integração business-to-consumer (B2C) em que os viajantes 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
Criamos uma lista de verificação para ajudar a dar suporte ao seu desenvolvimento ou fornecer feedback 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 acomodação
Requisitos comuns
Os requisitos de lançamento abaixo se aplicam a 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: Não é permitido o uso de nomes e logotipos Expedia Group.
O uso de nossos nomes e logotipos só pode ser feito nos sites traveler-facing ou agent-facing com nossa aprovação prévia e explícita por escrito, como exceção.
Exemplo:
GR2: Links para a URL dos nossos termos e condições a serem exibidos.
Forneça um link para nossos termos e condições 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".
Você pode encontrar a versão em inglês e outras versões listado no Expedia Partner Solutions.
Exemplo:
GR4: Somos Merchant responsáveis pelo registro (MoR): Uso e exibição adequados em relação aos regulamentos de cartão de crédito.
Ao obter, usar, transmitir, armazenar ou processar os dados do titular do cartão do viajante, você deverá cumprir o Padrão de Segurança de Dados do Setor de Cartões de Pagamento (PCI DSS), conforme emitido pelo Conselho de Padrões de Segurança PCI. Uma referência completa para estes regulamentos está disponível no site oficial Site de padrões de segurança PCI .
GR5: Somos MoR ou propriedade Coleta: Evidências de conformidade com PCI fornecidas quando aplicável.
Quando nós ou o propriedade for MoR, uma Atestação 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 sua integração permitir crianças viajando, você deve oferecer a capacidade de especificar a idade de cada criança viajando no momento de check-in. Essas informações são apresentadas pelo elemento occupancy (veja exemplos de códigos abaixo).
Quando os viajantes especificam crianças, a resposta da API pode conter restrições de idade e/ou taxas extras de ocupação ou berço que podem afetar o custo ou a elegibilidade 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 compras pode retornar obed_groups matriz com um único valor ou múltiplas opções. Exiba os valores contidos na matriz de configuração para descrever as escolhas de cama do viajante.
Quando obed_groups array retorna com múltiplas opções, exibe oprice_check links fornecidos pela resposta de compras para cada tipo de cama para permitir a seleção pelo viajante.
É 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 dentro da matriz de quartos da resposta de compras 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 de Non-refundable são indicadas porrefundable=false no Compras 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 pelo 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 docheckin,checkout,fees, epolicies os objetos devem ser exibidos para cada sala conforme devolvido no Contente Definição de propriedade. Essas informações devem ser exibidas na sua página de disponibilidade para garantir que o viajante esteja ciente de quaisquer taxas potenciais em check-in ou instruções especiais de acesso.
O campo special_instructionspode incluir informações críticas para check-in que não estão incluídas no campo checkindo objeto instructions, como um requisito para notificar o propriedade sobre o horário de chegada previsto, check-in em um local diferente do prédio do hóspede ou um alerta para esperar instruções especiais check-in do 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, feese policiesdeve ser exibido para cada sala, conforme retornado na definição Content propriedade. Essas informações devem ser exibidas para garantir que o viajante esteja ciente de quaisquer taxas potenciais em check-in ou instruções especiais de acesso antes de finalizar sua reserva.
O campo special_instructionspode incluir informações críticas para check-in que não estão incluídas no campo checkindo objeto instructions, como um requisito para notificar o propriedade sobre o horário de chegada previsto, check-in em um local diferente do prédio do hóspede ou um alerta para esperar instruções especiais check-in do 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 os viajantes confirmem a compra na sua página final de reserva, você deve fornecer a política de cancelamento ou a tag non-refundable para o(s) quarto(s) selecionado(s). A política de cancelamento para cada tarifa é fornecida no objeto cancel_penaltiesna API de Disponibilidade de Compras Rápidas.
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 prazo mais antigo cancel_penalties.[].starté o prazo de cancelamento gratuito, se for um cronograma futuro.• A taxa é de 100% non-refundable 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. |
Saiba mais sobre como elaborar políticas de cancelamento.
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 por nós ou governos locais) e não fazem parte das taxas, impostos ou taxas de recuperação de impostos padrão 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 sua integração permitir crianças viajantes e o viajante tiver especificado crianças viajantes para sua seleção de quarto, você deverá confirmar claramente o número de crianças viajantes e suas idades em suas páginas de reserva. Essas informações são apresentadas pelo elemento child_ages.
BP8: Somos MoR ou propriedade Cobrar: Informe quando o pagamento será cobrado do viajante final.
Se formos o 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 o propriedade estiver servindo uma tarifa non-refundable post-pay, indique que o viajante poderá ser cobrado pelo 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 se você pretende fazer transações com viajantes no Espaço Econômico Europeu (EEE).
Nós somos MoR ou propriedade Collect.
Se formos o MoR, ou se o propriedade Collect for usado com viajantes europeus, o caminho da reserva deve incluir a adoção das APIs do Rapid para autenticação two-factor.
Afiliado MoR - Geral.
Você deve seguir os requisitos de Autenticação Forte do Cliente (SCA) dos regulamentos PSD2 quando transações com viajantes estiverem dentro do escopo dos regulamentos. 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.
Se você estiver nos pagando com seu próprio cartão, emitido em um país dentro do EEE, deverá seguir os requisitos dos regulamentos PSD2. Para atenuar a necessidade de PSD2 2FA, você pode usar um cartão compatível com pagamentos B2B e isento de 2FA (autenticação two-factor).
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: Somos o MoR: Local de processamento de pagamento exibido nas páginas de checkout
Onde estamos 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:
