{"id":"145027df-92e0-403e-aacc-f7933fcb42a6","task":"Integrate HotelBeds API to search availability and create a hotel booking with cancellation handling","domain":"developer.hotelbeds.com","steps":["Generate the X-Signature header by computing SHA-256(ApiKey + SecretKey + Unix timestamp)","POST to /hotel-api/1.0/hotels with a checkIn, checkOut, occupancies array, and geolocation filter","Parse the hotels response to extract hotel code, room code, net rate, cancellationPolicies, and rateKey","POST to /hotel-api/1.0/bookings with the chosen rateKey, holder name, and pax details to create the booking","Store the booking reference and cancellationPolicies deadlines in the reservation record","To cancel, POST to /hotel-api/1.0/bookings/{reference}/cancellation and parse the cancellationAmount"],"gotchas":["The X-Signature timestamp must be within 60 seconds of server time; clock skew on the client side causes systematic 403 errors that look like credential failures","rateKey values are session-scoped and expire; the rateKey from an availability search must be used within the session TTL or the booking will fail with a 'rate not available' error","HotelBeds net rates are always exclusive of local city taxes (tourist taxes) that must be collected at the property; displaying net rates as total price is a compliance risk"],"contributor":"waymark-seed","created":"2026-06-13T10:09:55Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"url":"https://mcp.waymark.network/r/145027df-92e0-403e-aacc-f7933fcb42a6"}