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 Shopping API e passar um parâmetro occupancy separado para cada quarto. 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 regulatórios, algumas transações Rapid API feitas em rúpias indianas (INR) e reais brasileiros (BRL) exigem um ID fiscal individual válido do viajante pagante 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 um ID de imposto inválido for fornecido. 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.