Reservas
Com a API de reserva, você pode reservar quartos e tarifas confirmados pela resposta de verificação do preço.
O método de itinerário principal da API de reserva cria uma reserva para a propriedade, o quarto, a tarifa e a ocupação selecionados. As informações de pagamento, incluindo informações de cobrança e contato do titular do cartão, são disponibilizadas direto na solicitação.
Cada resposta de reserva bem-sucedida contém links para recuperar o itinerário ou cancelar a reserva. Consulte nossa seção Gerenciar Reservas e a página Como lidar com solicitações de reserva para obter detalhes.
Para fazer uma reserva multi-room (do mesmo tipo de quarto), você deve primeiro fazer uma solicitação à API de Compras e passar um parâmetro separado para cada quarto.occupancy Em seguida, na solicitação de reserva, inclua instâncias separadas correspondentes de room na matriz rooms para cada quarto que você deseja reservar.
Para manter o inventário por um breve período antes de concluir uma reserva (por exemplo, criar um pacote), consulte nossa documentação Espera e retomada de reserva.
Para fazer uma reserva de teste que não vai realizar uma cobrança no seu cartão de crédito nem enviar uma cobrança para a propriedade, consulte a nossa documentação sobre solicitações de teste.
Expiração do link de reserva
O link de reserva da sua resposta de verificação de preço anterior expira após um breve período. Se você recebeu um código de erro HTTP 503 após a sua primeira tentativa, é provável que o link tenha expirado. Use um novo link e tente reservar outra vez.
Números de identificação fiscal para reservas em INR e BRL
Devido a requisitos fiscais regulamentares, algumas transações Rapid API feitas em rupias indianas (INR) e reais brasileiros (BRL) exigem um número do documento de identificação fiscal individual válido do viajante pagador no parâmetro tax_registration_number.
As solicitações da API Criar Reserva podem falhar se este parâmetro for deixado em branco ou se for fornecido um número do documento de identificação fiscal inválido. As solicitações retornam um erro HTTP 400 com uma mensagem descrevendo tax_registration_number como a origem do erro. Para corrigir o problema, atualize tax_registration_number com um número de identificação fiscal válido e reenvie a solicitação de criação de reserva.
Detalhes da API
Explore as definições dos pontos de extremidade relacionados a reservas nesta página e use o API Explorer ou outro software de teste para comparar os exemplos e as definições de esquemas com o resultado real.
Recursos adicionais
Não importa se deseja testar todos os pontos de extremidade da Rapid API, ou baixar a especificação OpenAPI ou a nossa coleção Postman Collection, você pode contar conosco.