DELETE {base_url}/1.0/bookings/{bookingId}
Cancela uma reserva confirmada anteriormente.
Header
Valor
Authorization
Bearer <access_token>
Accept
application/json
Parâmetro
Tipo
Descrição
bookingId
int
ID da reserva a cancelar
"cancellationPolicies" : [
"startDate" : " 2027-05-12T00:00:00Z " ,
"endDate" : " 2027-05-15T23:59:59Z " ,
"eventId" : " 81f900f8-5e24-43bb-b6d6-946ef8beac1f "
Uma resposta bem-sucedida do BookingDelete pode omitir a propriedade error; não a exija.
Status
Significado
CANCELLED
O cancelamento teve sucesso
CONFIRMED
O cancelamento falhou; a reserva continua ativa
Código
HTTP
Mensagem
Causa
O que fazer
1203
400
Your reservation is currently being created. Please wait a moment before accessing it.
Observado ao cancelar segundos após criar a reserva, quando ainda estava em status CREATED
Aguarde pelo menos 90 segundos após criar a reserva e tente o DELETE novamente
3003
500
Cannot get a valid response from the cancellation service
Falha do fornecedor/interna
Contate a PriceTravel com a requisição, a resposta e o eventId
3005
500
Cancellation in progress but couldn’t be confirmed (timeout)
O cancelamento excedeu o tempo limite e não pôde ser confirmado
Tente novamente em alguns minutos; verifique com o BookingGet
A resposta do DELETE retorna as cancellationPolicies da reserva, mas nenhum campo com o valor realmente cobrado. Para saber o que será cobrado:
Chame o BookingGet primeiro.
Leia cancellationPolicies e calcule a penalidade aplicável para a data de hoje.
Depois chame o DELETE.
1. BookingGet (read cancellationPolicies)
2. Compute penalty for current date
4. Wait until ≥90 seconds since booking creation (if recent)
5. DELETE /bookings/{bookingId}
6. Verify status === "CANCELLED" in response
7. If response is timeout/3005, retry BookingGet after 1-2 min
Cancelar uma reserva que já está CANCELLED retorna sucesso sem cobranças adicionais.
Cancelar uma reserva dentro da janela não reembolsável significa que a tarifa completa é cobrada, mas o status da reserva mesmo assim passa a CANCELLED.
Alguns fornecedores não suportam cancelamento de forma alguma — o erro 1202 pode indicar isso.