Annulation

Deux étapes : simuler pour connaître les frais exacts, puis annuler. Les frais viennent de la politique d'annulation du tarif réservé.

POST/v1/{code}/bookings/{ref}/cancel

Requête

Paramètres d'URL

Name
ref
Type
string
Description
Référence passerelle de la réservation (ex. BPG-2026-000123).

Paramètres de requête

Name
simulate
Type
boolean
Description
true = simulation : renvoie les frais sans annuler. Absent ou false = annulation réelle.

Comportement

L'annulation est idempotente : rejouer l'appel renvoie l'état courant.
Une réservation déjà annulée renvoie 409 invalid_state en annulation réelle, et les frais en simulation.

POST

/v1/1000/bookings/BPG-2026-000123/cancel

curl -s -X POST "https://partners.bravebooking.net/v1/1000/bookings/BPG-2026-000123/cancel?simulate=true" \
  -H "X-Api-Key: $API_KEY" \
  -H "X-Timestamp: $TIMESTAMP" \
  -H "X-Signature: $SIGNATURE" \
  -H "Accept: application/json"

Réponse

{
  "reference": "BPG-2026-000123",
  "status": "confirmed",
  "simulated": true,
  "cancellationFees": { "amount": 0.0, "currency": "TND" },
  "refundableAmount": { "amount": 2500.0, "currency": "TND" },
  "applicablePolicy": {
    "from": "2026-12-15",
    "to": "2027-01-14",
    "type": "PERCENT",
    "value": 0
  }
}

Erreurs

Code	Signification
`404 not_found`	Référence inconnue
`409 invalid_state`	Réservation déjà annulée, ou en cours d'annulation
`422 too_late`	Période d'annulation dépassée selon la politique du tarif