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. Confira as nossas seções Gerenciamento de reserva e Tratamento de solicitações de reserva para mais informações.
Para fazer uma reserva de vários quartos do mesmo tipo, é necessário antes fazer uma solicitação de compra e aprovar um parâmetro separado de occupancy para cada quarto. Depois, na solicitação de reserva, inclua as instâncias separadas correspondentes de room no conjunto de rooms para cada quarto que 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, as transações da Rapid feitas em rúpia indiana (INR) e real brasileiro (BRL) exigem um número de identificação fiscal válido do viajante que realiza o pagamento no parâmetro tax_registration_number.
A criação de solicitações de reserva pode falhar se o parâmetro for deixado em branco ou se o número de identificação fiscal fornecido não for vá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.