Como funciona
A Rapid foi projetado para tornar o processo de reserva fácil e intuitivo.
Nossa API modular vai oferecer os dados de que você e os seus viajantes precisam para concluir a reserva de uma propriedade. Você vai ter acesso a mapeamentos das regiões, propriedades, tarifas e muito mais, dependendo da experiência do usuário que deseja criar. Nesta página, você vai aprender como realizar uma reserva.
Como criar o seu fluxo de solicitação de reserva
Este guia vai orientar você na criação da reserva. Para iniciar a integração, visite as nossas páginas de documentação da API e acesse as informações sobre cada módulo da API.
1. Acessar conteúdo estático
O catálogo de propriedades contém todas as informações necessárias para a identificação das propriedades, como ID da propriedade, nome e endereço, informações de contato e classificação por estrelas. O conteúdo da propriedade precisa ser atualizado todos os dias.
2. Acessar informações geográficas
A API de geografia oferece regiões geográficas definidas, hierarquia de regiões e propriedades disponíveis em regiões específicas.
3. Buscar propriedades
Abra a API de compras com as datas da estadia, os detalhes sobre ocupação e os IDs das propriedades desejadas.
A resposta exibe todos os quartos disponíveis em cada propriedade, junto com as tarifas, as taxas e as políticas de cancelamento específicas de cada quarto. Cada objeto de quarto exibido tem links com token prontos para serem usados nos próximos passos do processo de reserva.
Acessar opções de pagamento
Use o link de opções de pagamento para escolher as opções de pagamento da propriedade. O link de opções de pagamento pode ser usado durante todo o processo de reserva, dependendo do momento que você escolhe mostrar as opções de pagamento para o viajante.
Para se preparar para a reserva, use o price_checklink
do objeto room
na resposta de compra para confirmar a tarifa selecionada.
4. Verificar o preço e acessar o link da reserva
Se a tarifa não sofreu ajuste, você vai receber uma confirmação de CORRESPONDÊNCIA e o link para realizar a sua solicitação de reserva. Se a tarifa sofreu ajuste, você vai receber a nova tarifa e o link para realizar a reserva com a tarifa atualizada.
Envie a sua solicitação de reserva com o link da reserva, as informações sobre o hóspede e os dados de pagamento.
5. Resposta da reserva
Você vai receber um ID de itinerário e links para recuperar detalhes da reserva, cancelar a reserva ou concluir a reserva, se uma reserva em espera for criada.
Armazenar links
Recomendamos que você guarde o link de recuperação nos detalhes do viajante para conseguir localizar a reserva com agilidade no futuro.
Insira todas as informações necessárias na sua página de confirmação de reserva e pronto! Você concluiu a sua reserva.
Use o link de recuperação informado na sua confirmação de reserva para recuperar o registro completo do itinerário.
6. Recuperar o registro do itinerário
A resposta de recuperação confirma as datas, as tarifas, o tipo de quarto reservado, os números de confirmação e o status atual da reserva.
Use a recuperação para acessar o link da central de mensagens da propriedade, uma ferramenta de mensagens bidirecional para comunicação direta com a propriedade. A resposta de recuperação também permite alterar detalhes do quarto, como o nome, a opção fumantes ou não fumantes e solicitações especiais.