Pular para o conteúdo

BookingDelete (Cancel)

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",
"amount": 116.00,
"currency": "USD"
}
],
"status": "CANCELLED",
"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:

  1. Chame o BookingGet primeiro.
  2. Leia cancellationPolicies e calcule a penalidade aplicável para a data de hoje.
  3. Depois chame o DELETE.
1. BookingGet (read cancellationPolicies)
2. Compute penalty for current date
3. Confirm with user
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.