XML Start Booking Request Specification
In the unlikely event that the TRAVELfusion system takes too long to respond to a StartBooking request and the client system therefore has to 'timeout' the request, this should not be treated as a failed booking. The booking may in fact have been successfully initiated and may subsequently complete successfully. In such cases, the customer is advised to treat the booking as 'unconfirmed' (uncertain status) and inform the end user accordingly and apply the appropriate operational procedures.Unrecognised or unexpected responses from the TRAVELfusion server should also be treated similarly, including schema validation failures. In fact, the customer system should assume that a booking may have been made regardless of the contents of the StartBooking response (or lack thereof).
| XML Field | Dependencies | Description |
| CommandList | The surrounding tag | |
| -StartBooking | The command name | |
| --XmlLoginId | The xml customer login id. See the Login guide. | |
| --LoginId | The end user login id. See the Login guide. | |
| --TFBookingReference | The TRAVELfusion booking reference supplied in the terms response |
|
| --FakeBooking | Optional | Describes the settings for making 'fake' bookings. A real booking will be attempted if this element is omitted. |
| ---EnableFakeBooking | Must have value 'true' or 'false'. If 'true', the booking will be simulated using a pre-cached confirmation page for a successful booking already made. In this case, the final price will be different from the one quoted in the terms response. If 'false', a real booking will be made. |
|
| ---FakeBookingSimulatedDelaySeconds | Specifies the simulated delay for this booking. For example, if this is submitted with value '30', subsequent 'CheckBooking' requests will return a booking status of 'BookingInProgress' for the first 30 seconds, and the first CheckBooking request to be made after 30 seconds have elapsed will return a complete booking status (as specified in the FakeBookingStatus element). This element will be ignored if 'EnableFakeBooking' is 'false'. |
|
| ---FakeBookingStatus | Optional | Requests a specific booking status to be returned. Default is 'Succeeded'. Can take any of the values that the 'Status' element can have in the CheckBooking response, except 'BookingInProgress'. This element will be ignored if 'EnableFakeBooking' is 'false'. |
| ---EnableFakeCardVerification | Optional | Requests the card verification process to be simulated. For full details see the Card Verification Handling Guide. |
| --SupplierVisualAuthorisationText | Optional | The special authorisation entered by the user. See Terms Response for more details. |
About TRAVELfusion | Contact Our API Support Team | Latest API Change - 2nd January