Requisitos de lançamento da API de hospedagem
Comece já com a API Rapid Lodging.
Os requisitos de lançamento da API Rapid Lodging incluem aqueles que se aplicam a qualquer implementação, independentemente do público-alvo, e requisitos específicos para uso com business-to-business (B2B) ou business-to-consumer (B2C). Leia com atenção os requisitos, pois podem diferir de todos os outros tipos de tarifas ou fluxos de reserva que você integrou antes.
Nota: Cada requisito listado abaixo inclui um código de referência para ajudar nossa equipe de atendimento ao cliente a auxiliá-lo.
Requisitos
Os seguintes requisitos aplicam-se a qualquer implementação da API de Alojamento.
GR1: Uso de nossos nomes e logotipos
O uso de nossos nomes e logotipos só poderá ser feito nos sites traveler-facing ou agent-facing com nossa autorização expressa e por escrito, a título excepcional.
Exemplo de interface de usuário
GR2: Links para os nossos termos e condições. URL a ser exibida.
Inclua um link para nossos termos e condições no texto de termos e condições do seu site ou adicione um link direto para os termos na sua página de reservas. Esses termos detalham as políticas que regem a reserva. Insira o seguinte link em um local easy-to-find, usando a seguinte frase no link: "Termos e Condições do Fornecedor".
As versões dos termos e condições em todos os idiomas que oferecemos suporte estão disponíveis nesta página de termos e condições do Rapid API .
Exemplo de interface de usuário - B2B
Exemplo de interface de usuário - B2C
GR4: Uso e exibição adequados das normas de cartão de crédito quando Expedia Group é o Merchant de Registro (MOR)
Ao obter, usar, transmitir, armazenar ou processar dados de titulares de cartões de viajantes, você deve cumprir o Padrão de Segurança de Dados da Indústria de Cartões de Pagamento (PCI DSS), conforme emitido pelo Conselho de Padrões de Segurança PCI DSS. Uma referência completa a esses regulamentos está disponível no site oficial do PCI Security Standards Council .
GR5: Forneça evidências de conformidade com o PCI ao usar propriedade collect ou quando Expedia Group for o MOR (somente para parceiros aplicáveis).
Independentemente de Expedia Group ser o MOR ou propriedade ser o MOR, uma Declaração de Conformidade (AOC) deve ser fornecida como prova de conformidade com o PCI.
Você pode encontrar conselhos sobre conformidade com PCI no site oficial do PCI Security Standards Council .
SP1: Mensagens adequadas e inclusão da idade das crianças nos locais onde a empresa afiliada permite a inclusão de crianças nas reservas.
Se a sua integração permitir viajantes menores de idade, você deve oferecer a possibilidade de especificar a idade de cada criança no momento do check-in. Esta informação é fornecida através do objeto occupancy (veja o exemplo abaixo).
Quando os viajantes especificam crianças viajando juntas, a resposta da API pode conter restrições de idade e/ou cobranças extras por ocupação adicional ou berço, o que pode afetar o custo ou a elegibilidade da reserva.
Cada hotel define a faixa etária que classifica como criança. Pessoas com até 17 anos costumam ser consideradas crianças. Algumas propriedades não permitem hóspedes com menos de 18 anos.
Exemplo de solicitação de API
https://api.ean.com/2.4/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 3 crianças com idades de 17, 2 e menos de 1 ano.
AP1: Descrição dos tipos de cama presente em cada quarto.
As respostas de compras podem retornar a matriz bed_groupscom um único valor ou várias opções. Exiba os valores contidos na matriz de configuração para descrever as escolhas de cama dos viajantes.
Quando a matriz bed_groupsretornar várias opções, exiba os links price_checkfornecidos 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 do Shopping 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 de usuário - B2B
Exemplo de interface de usuário - B2C
AP2: Non-refundable flag claramente visível
As disponibilidades de Non-refundable são indicadas por refundable=falsena resposta de disponibilidade da API de Compras . Quando refundable=falsefor 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 sã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 de usuário - B2B
Exemplo de interface de usuário - B2C
AP3: Check-in e instruções especiais exibidas
O conteúdo dos objetos checkin, checkout, feese policiesdeve ser exibido para cada sala conforme retornado na definição da API de Conteúdo propriedade. Essas informações devem ser exibidas na sua página de disponibilidade para garantir que o viajante esteja ciente de quaisquer taxas adicionais no momento do check-in ou instruções especiais de acesso.
O campo especial check-in pode incluir informações críticas para check-in que não estão incluídas nocheckin campo de instruções do objeto, como um requisito para notificar o propriedade do horário de chegada previsto, check-in em um local diferente do prédio de hóspedes, 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.
<br />Extra-person charges may apply and vary depending on property policy.
<br />Government-issued photo identification and a credit card may be required at
check- in for incidental charges.
<br />Special requests are subject to availability upon check-in and
may incur additional charges. Special requests cannot be guaranteed. <ul>. ",
"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": "<p>You'll be asked to pay the following charges at the property:</p>
<ul><li>Deposit: USD 50 per day</li>
<li>Resort fee: USD 28.25 per accommodation,
per night</li></ul> The resort fee includes:<ul
><li>Pool access</li><li>Fitness center access</li><li>Fitness/yoga classes</li>
<li>Airport shuttle</li><li>Phone calls</li><li>In-room safe</li><li>Self parking</li>
<li>Valet parking</li><li>Parking</li></ul> <p>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. </p>",
"optional": "<p>The following fees and deposits are charged by the property at time of service,
check-in, or check-out. </p> <ul> <li>Breakfast fee: between USD 6 and USD 25 per person
(approximately)</li> <li>Late check-out is available for a fee (subject to availability)</li>
<li>Rollaway bed fee: USD 20.0 per night</li>
</ul> <p>The above list may not be comprehensive. Fees and deposits may not include tax
and are subject to change. </p>"
"policies": {
"know_before_you_go": "<ul> <li>Up to 2 children 12 years old and younger stay free when
occupying the parent or guardian's room, using existing bedding. </li>
<li>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. </li> </ul>"Exemplo de interface de usuário
BP1: Criptografia SSL 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: Check-in e instruções especiais exibidas
O conteúdo docheckin,checkout,fees, epolicies Os objetos devem ser exibidos para cada sala conforme retornado no Contente Definição de propriedade. Essas informações devem ser exibidas para garantir que o viajante esteja ciente de quaisquer taxas potenciais no check-in ou instruções especiais de acesso antes de finalizar sua reserva.
O campo especial check-in pode incluir informações críticas para check-in que não estão incluídas nocheckin campo de instruções do objeto, como um requisito para notificar o propriedade do horário de chegada previsto, check-in em um local diferente do prédio de hóspedes, 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: Política de cancelamento e tag non-refundable claramente exibidas
Antes de permitir que os viajantes confirmem a compra na página de reservas final, 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 dentro do próprio documento.cancel_penalties objeto na API Rapid Shopping Availability.
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 | • Essa taxa é reembolsável durante o período de cancelamento. • Os primeiros cancel_penalties.[].start é o prazo limite para cancelamento gratuito, caso se trate de uma data futura.• A taxa é de 100% non-refundable após a última cancel_penalties.[].end |
refundable=false | • Essa taxa é non-refundable. • Nenhuma janela de multa de cancelamento é retornada. |
refundable=false + cancel_penalties | • A taxa pode ser parcialmente reembolsável. • cancel_penaltiesdeve ser mostrado em conjunto comnonrefundable_date_ranges que mostrará as datas de estadia deste intervalo como non-refundable assim que a reserva for criada. |
Leia 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 em
nonrefundable_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. - Os primeiros
cancel_penalties.[].starté o prazo limite para cancelamento gratuito, caso se trate de uma data futura. - A taxa é de 100% non-refundable após a última
cancel_penalties.[].end.
Exemplo de resposta da API: Política de cancelamento e flag non-refundable
"property_id": "11775754",
"rooms": [
{
"id": "230434524",
"room_name": "Traditional Room (Partner:Connect Test)",
"rates":
"id": "276321199",
"status": "available",
"available_rooms": 4999,
"refundable": true,
"cancel_penalties": [
{
"start": "2020-09-10T18:00:00.000-07:00",
"end": "2020-09-11T18:00:00.000-07:00",
"amount": "76.00",
"currency": "USD"Exemplo de interface de usuário
BP4: Cobranças a pagar separadamente no código propriedade exibido no detalhamento de preços.
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. Apresente ao viajante a moeda local e solicite a troca de moeda estrangeira. Essas taxas são cobradas diretamente pela propriedade (não por nós ou pelo governo local) e não fazem parte das taxas de recuperação de impostos, impostos ou tarifas padrão incluídas na linha de impostos e tarifas.
Exemplo de resposta da API: Array de taxas
"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 de usuário
BP5: A exibição do preço deve incluir o preço total e a discriminação 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 deve incluir as tarifas dos quartos (total ou por noite), quaisquer taxas noturnas adicionais (exceto aquelas no campo property_feedescrito abaixo), todos os valores da estadia e impostos, um total a pagar e especificar o que é pago agora e o que será pago posteriormente no propriedade.
Nota: Requisitos adicionais de exibição de preços se aplicam a pacotes de preços B2B ou B2C e implementações de pacotes de preços expostos.
B) Detalhamento de impostos
A exibição do preço deve incluir a soma de tax_and_service_feee property_feeem uma única linha intitulada "Impostos e taxas". O texto exato abaixo deve ser exibido por lei ao se referir a quaisquer totais de impostos e taxas na discriminação de preços. Isso pode ser exibido como um pop-up, texto simples, modal ou outra implementação. A taxa propriedade não deve ser exibida separadamente na página de finalização da compra.
"Os impostos são taxas de recuperação de impostos pagas aos fornecedores (e.g. hotéis); para obter detalhes, consulte nossos Termos de Uso." As taxas de serviço são retidas como compensação pela gestão da sua reserva e podem incluir taxas cobradas pelos fornecedores. As traduções podem ser encontradas em Expedia Partner Solutions.
O valor retornado para tax_and_service_feeinclui apenas impostos e taxas exigidos por uma jurisdição fiscal.
C) Cobranças pelos serviços e pelas reservas de parceiros
Na medida em que Expedia Group conceda uma isenção para permitir cobranças adicionais de serviço ou reserva, estas devem ser claramente separadas. Se a sua organização impuser uma taxa de serviço que é adicionada à reserva, deve ficar claro para o viajante que a taxa é cobrada por vocês e não pela Expedia Group por um serviço separado (ou seja, não se trata de uma cobrança adicional pela prestação do serviço de alojamento). Os encargos podem não estar incluídos nas rubricas de impostos e taxas já existentes. Não utilize a palavra "taxa" para descrever qualquer cobrança imposta pelo seu propriedade. Em vez disso, você pode usar "taxa de reserva de afiliado" ou "taxa de serviço de afiliado".
Nota: Requisitos adicionais se aplicam para implementações de taxas de pacotes de coleta e exposição B2B ou B2C propriedade.
BP7: As idades das crianças são reiteradas (se aplicável)
Se a sua integração permitir viajantes menores de idade e o viajante tiver especificado crianças como viajantes na seleção do quarto, você deve confirmar claramente o número de crianças viajantes e suas idades nas páginas de reserva. Esta informação é fornecida através do objetochild_ages.
Exemplo de interface de usuário
BP8: Declaração de quando o pagamento será cobrado do viajante final (para o serviço propriedade a cobrar ou quando Expedia Group for o MOR)
Caso o Expeda Group seja o operador turístico, informe que o cartão de crédito fornecido será debitado 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 serviço propriedade estiver oferecendo uma tarifa non-refundable post-pay, indique que o viajante poderá ser cobrado pelo serviço propriedade logo após concluir a reserva.
BP9: Em conformidade com o regulamento SCA
Órgãos reguladores e redes de cartões estão introduzindo novos requisitos para reforçar a segurança dos pagamentos online e proteger os consumidores contra fraudes. Muitas dessas regulamentações incluíram a exigência de usar autenticação forte do cliente (SCA, na sigla em inglês) para pagamentos online.
Saiba mais sobre autenticação forte do cliente (SCA)
BP10: Local de processamento de pagamento exibido nas páginas check-out quando Expedia Group é MOR
Onde Expedia Group é o MOR, o país onde o pagamento será processado deve ser exibido em um local de destaque na página check-out. 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 de API para opções de pagamento
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 de usuário
Detalhes da implementação B2B
Você pode encontrar uma lista de verificação para ajudar no seu desenvolvimento ou para fornecer feedback sobre os requisitos. Se você fornecer capturas de tela para a análise do seu site, também deverá adicioná-las, juntamente com os registros correspondentes, à lista de verificação para nos ajudar a concluir a análise.
GR3: Os agentes downstream devem concordar com nossos Termos e Condições do Agente para acessar nosso estoque.
Os agentes que efetuarem uma reserva em nome de um viajante devem concordar com o nosso contrato de agenciamento reverso. Um link para o contrato do agente subsequente deve ser fornecido para que os agentes revisem e aceitem antes de fazer uma reserva. Outras versões estão disponíveis. na Expedia Partner Solutions.
Exemplo de interface de usuário
Requisitos adicionais de tarifas de pacotes
Além dos requisitos comuns listados acima, se você estiver incluindo um elemento de tarifas por pacote em sua implementação, também deverá atender a estes requisitos.
AP4: Exibir preços de pacotes com um rótulo ou identificador exclusivo.
Você deve identificar claramente que a tarifa do pacote Expedia Group é uma tarifa de pacote (e não de itens separados) no nível do quarto.
Exemplo de interface de usuário
BP5: A exibição do preço deve incluir o preço total e a discriminação dos impostos e taxas.
O requisito de preço total para pacotes é diferente dos requisitos comuns listados acima.
A) Preço total
O preço do pacote deve ser combinado com o preço do componente de transporte para exibir um preço total do pacote. Normalmente, isso é conseguido exibindo um custo per-person para o transporte propriedade plus.
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.
Exemplo de interface de usuário
BP11: Exigir que os agentes aceitem as regras de tarifas por pacote.
Inclua uma caixa de seleção na sua página de check-out onde o agente confirma que está vendendo essa tarifa juntamente com um componente transporte aprovado.
Exemplo de interface de usuário
Requisitos adicionais de coleta propriedade
Além dos requisitos comuns listados acima, se você estiver incluindo o comando propriedade collect em sua implementação, também deverá atender a estes requisitos.
Detalhes da implementação B2C
Criamos uma lista de verificação para ajudar no seu desenvolvimento ou para fornecer feedback sobre os requisitos. Se você fornecer capturas de tela para a análise do seu site, também deverá adicioná-las, juntamente com os registros correspondentes, à lista de verificação para nos ajudar a concluir a análise.
GR10: Garantir acesso adequado às ofertas member-only
As ofertas Member-only devem ser vendidas exclusivamente em um ambiente closed-user (por exemplo, por meio de login em um site, aplicativo móvel ou ferramenta de agente).
Exemplo de interface de usuário
Requisitos adicionais de tarifa de pacote
Além dos requisitos comuns listados acima, se você estiver incluindo um elemento de taxa fixa em sua implementação, também deverá atender a estes requisitos.
BP5: A exibição do preço do pacote deve incluir o preço total e a discriminação dos impostos e taxas.
O requisito de preço total para pacotes é diferente dos requisitos comuns listados acima.
A) Preço total
O preço do pacote deve ser combinado com o preço do componente de transporte para exibir um preço total do pacote. Normalmente, isso é obtido exibindo um custo per-person para o transporte propriedade plus.
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.
Exemplo de interface de usuário
Requisitos adicionais de taxas de pacotes expostos
Além dos requisitos comuns listados acima, se você estiver incluindo um elemento de taxa de pacote exposto em sua implementação, também deverá atender a estes requisitos.
Requisitos adicionais de coleta propriedade
Além dos requisitos comuns listados acima, se você estiver incluindo um elemento de taxa de pacote exposto em sua implementação, também deverá atender a estes requisitos.