Partner walk-through · Step 3 of 7
Book the trip
Sample data. Nothing is sent to Transferz.
Why this step exists
A booking turns the chosen quote into a reservation. You add who booked it, who travels and any extras, such as meet and greet.
The response holds the booking and one journey per quote. Store both IDs: you pay for the booking, and you follow, change or cancel the journey.
The request
The previous step has not been run yet, so this uses the sample quote and meet and greet extra. Run step 2 to use your own.
Book the chosen quote
curl --request POST \ --url 'https://warpdrive.staging.transferz.com/partners/bookings' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --header 'X-Request-ID: req-ams-0001' \ --header 'X-API-Key: YOUR_STAGING_API_KEY' \ --data '{ "booker": { "firstName": "Alex", "lastName": "Traveller", "email": "alex.traveller@example.com", "phone": "+447700900123", "companyName": null, "reference": "ORDER-10023", "languageIsoCode": "en" }, "quotes": [ { "quoteId": 7731201, "traveller": { "firstName": "Alex", "lastName": "Traveller", "email": "alex.traveller@example.com", "phone": "+447700900123", "meetAndGreetSignText": "Alex Traveller", "driverComments": "Two suitcases and a stroller.", "flightNumber": "TZ1234", "trainNumber": null, "shipName": null, "languageIsoCode": "en", "residenceCountryCode": "GB" }, "travelAddons": [ { "quoteTravelAddonId": 77312011, "amount": 1 } ] } ], "partnerReference": "ORDER-10023", "travelIntent": "LEISURE"}'⌘↵ Sample data · nothing is sent
Common pitfall
A new booking is NOT_PAID and nothing is arranged yet. Pay for it (next step) or it will not go ahead. Use partnerReference for your own order number so you can find the booking later.