Travelfusion Direct Connect XML API >

Search and Refer API

Step 1: Connection; 2: Submitting the search request; and 3: Submitting the results request

Step 4: Selecting a flight and forwarding user to the supplier's website

Step 1: Connection; 2: Submitting the search request; and 3: Submitting the results request

The first three steps in the integration process are described in the Search and Book API Specification. Once completed please follow Step 4 as shown below:

Step 4: Selecting a flight and forwarding user to the supplier's website

Once the end user has decided which flight they would like to book, a ProcessDetails XML request can be made to obtain the Handoff URL. The user can then be directed to this URL in a browser in order to complete their booking. In the following example, notice the HandoffParametersOnly element must be included and set to true, and note that the OutwardId corresponds to the id of the first British Airways outward result in the example CheckRouting response above. In the case of a return journey, a ReturnId must also be submitted after the OutwardId which will identify the chosen return flight (which must be in the same Group as the outward selection).

ProcessDetails request XML example

<RoutingId>Z1LXGWR0QX1XKAN3</RoutingId>

</ProcessDetails>

</CommandList>

The response will contain a SupplierHandoffData element. The data contained in this element should be used to build an HTML form with the specified ACTION (Url), submission method (GET/ POST), and the specified parameters and values. The submission of this form will take the user to the supplier's website to complete the booking. For more details, see the Detailed XML Specification.

ProcessDetails response XML example

GET method

<Url>https://api.travelfusion.com/redirect/</Url>

<Name>routingId</Name>

<Value>Z1LXGWR0QX1XKAN3</Value>

</Parameter>

<Name>referralId</Name>

<Value>ABDCW848K6YM4BTM</Value>

</Parameter>

</ParameterList>

</SupplierHandoffData>

</ProcessDetails>

</CommandList>

POST method

<Url>http://www.easyjet.com/en/book/step2.asp</Url>

<Name>txtorigID</Name>

</Parameter>

<Name>txtdestID</Name>

</Parameter>

<Name>txtdorig</Name>

</Parameter>

<Name>txtddest</Name>

</Parameter>

<Name>outFlightVal</Name>

<Value>segment117095170</Value>

</Parameter>

</Parameter>

</Parameter>

</Parameter>

<Name>oMonYear</Name>

</Parameter>

</ParameterList>

</SupplierHandoffData>

</ProcessDetails>

</CommandList>

The following HTML shows how the parameters in the example response above can be used to construct a form that will forward the user to the appropriate stage of supplier's website. Note that this is not a working example. It is just supplied to demonstrate how the form should be constructed for a given SupplierHandoffData.

The default referral URL always points to TravelFusion redirect services, which forward a user to the supplier's website. However it is possible to use the supplier referral URL directly. In order to change it you need to contact TravelFusion.

ProcessDetails EHTMLresponse XML example

GET method

<html>

</form>

</body>

</html>

POST method

<html>

</form>

</body>

</html>