Frequently Asked Questions
What is this page?
The following are support queries that are frequently asked by developers to the Travelfusion Support team. This is not an exhaustive list, and you can find more detailed help in our guidelines and specifications. If you're not sure how the API can be used in your business, then please contact the Travelfusion sales team. If you need technical help and cannot find it here or elsewhere in the documentation, then please contact the Travelfusion support team.
Using the API
Login & Connecting
What should I do if I have a security breach and my account details are compromised?
Please contact Travelfusion immediately, and we will help you reset your account.
Getting support from Travelfusion team
What do I do if I need help with my integration?
Please contact Travelfusion on firstname.lastname@example.org.
What do I do if I find price differences between Travelfusion’s API and the supplier’s website?
Please contact Travelfusion on email@example.com. Make sure you send us full logs of which XML requests and responses you have received (of the entire process) from the very first XML request that you’ve submitted until the very last XML response we’ve returned. Please also send us a screenshot of the supplier’s website page with the price that you’ve seen, showing us exactly which flight you are referring to. We may not be able to help you if you do not attach a complete set of XML logs and a screenshot.
Route Lists, Routing, Airports and Cities
How should I use the ListSupplierRoutes request?
The ListSupplierRoutes request provides a complete list of routes provided by the airlines that Travelfusion integrates with. This data has minor edits made to it every day, so it is recommended that you synchronise this data with your local copy overnight each day at off peak hours (00:00 to 07:00 UK time). If you do not use this data then you may be attempting to search for an airline on a route that the airline does not fly or may not in fact be searching a route that they do fly to. It is strongly recommended that you make use of the ListSupplierRoutes functionality (as recommended in our spec)
What sort of different configurations can be set up on different sub-branches?
Customers are recommend to set up different sub-branches for different markets that you operate in. This is for easier reporting, especially relating to currencies, and what language the airline provides text descriptions in (although it’s also possible to manage this in the XML request). If you think you need to use a sub-branch structure, then please contact Travelfusion and we will advise the steps you should follow. Please read the guidelines for more information on the Travelfusion Admin system.
How do I control which suppliers are in my results?
In the Travelfusion Admin system, there is a "Suppliers" section in the branch profile. In this page, you can switch on or off any booking suppliers as you intend to use.
If you have a supplier switched on, but do not want to use them for a particular route, then you can remove them from your search request, which ensures they will not be included in the results. This is achieved within your initial StartRouting request by including the filter <SupplierList><Supplier>Name</Supplier><SupplierList>
Searching and Cached Data
What are 'Incremental Results'?
By setting this to true, the results are returned to you asynchronously (i.e. as we receive them). With each new polling request that you make for more results, you will receive the new results, with all previous results filtered out. You should add these new results to the ones that you have already stored.
Does every supplier always provide same currency?
No, it does not. This depends on the supplier, as some suppliers provide different currencies depending on the departure country, and others provide their prices in a single currency, or even in multiple currencies.
Should I convert the displayed price into my local currency?
You should tell the end-user the price that they will be billed in using the currency that the airline will charge (e.g. Norwegian Kroner) and also provide an estimate in your local currency (e.g. Euro). This can only ever be an estimate as the correct exchange rate will be the one that is used by the end-users credit card company.
What about suppliers who allow users to select a language on their website?
We offer this function within the branch profile of the Administration system. It is also possible for some suppliers to select this on a per-search request through the use of CustomSupplierParameters.
Why did I encounter different currencies on my outward and return legs?
Different legs could have different currencies as we make the best use of cached data, so the data that you are receiving may have not originated from the currency corresponding to the point of departure. If you continue with the selection, then a fresh search will be made to the supplier as a result of the ProcessDetails request, and the currency will be updated.
Making a Booking
I'm submitting passenger details. What non-English characters does Travelfusion support?
Travelfusion is UTF8 compatable, so supports all UTF8 characters including the non-English characters.
What is a B2B supplier?
A B2B supplier is a supplier that offers a trade login to their website. You need to create an account with the supplier on their website before you start using them, as you must include your account number within your initial search request. B2B suppliers will typically have some extra fields that must be included in the booking request as 'Custom Supplier Parameters'
If you always intend to use the same B2B login for the same branch for every request from that supplier, then contact Travelfusion to set this up.
Why should I use a B2B supplier?
All of your bookings will be identified to the supplier, and you may be able to manage these bookings through their B2B trade website. Some suppliers offer promotional fares to their agency partners, and allow an agent to manage payments through the website. You will have to check what functionality the supplier supports within their B2B trade website to evaluate whether or not to use it.
Why is the Booking function switched off in the Reports system?
The booking function is switched on by Travelfusion after you have signed the commercial agreement, and your application development is at the stage where you need to make test bookings. Please contact Travelfusion when you are at this stage.
What is a fake booking?
Travelfusion provides the ability to make a fake booking, which simulates a real booking without actually billing a card. This is provided to help you with the development of your application, and should not be used when your application goes live. It is strongly recommended NOT to use a real card number for fake bookings. Your fake booking will be deleted from our system overnight. Please remember to set FakeBooking as "True" in your booking request, as otherwise your booking request may result in a real nonrefundable booking.
When I’m making a fake booking, why is the price 33.33 GBP?
In order for us to provide the fake booking functionality, it’s necessary for us to give you a pre-cached response that contains a fixed price, rather than proceed with a real booking with the supplier. This will obviously not happen when you are making real bookings.
I've tried to make a booking but haven't had a response straightaway. What has happened?
Your application needs to continue to poll our system for results, as there may be a delay waiting for the airline to respond. If you decide that your application will timeout when waiting for a response from a ProcessDetails request after a certain time, the airline will not know this and will make the booking that you have originally requested. This causes problems with the end user, who may make multiple bookings through your application. We recommend that you continue to poll our system until you get a confirmation of a change in booking status.
I’ve received an unconfirmed status. What message should I display to my user?
An unconfirmed booking should NOT be treated as a failed status, as the booking may have been completed with the supplier. The end user should be informed that the booking may have gone through, and they should contact your customer service representatives in order to check the status. Travelfusion guarantees to follow up on every booking going through the system with special automated follow in case of any booking errors, so the unconfirmed status will change when the follow-up is completed.
Forms of Payment
What is Travelfusion Prepay / TF.Pay?
Please find more details under TF.Pay solution.
What does “Agency Payment” involve?
Agency Payment is where an Online Travel Agent has set up their own credit account in the airlines' backend system. The Online Travel Agent will need to manage this account to ensure there are sufficient funds in the account as with every booking that is made, the amount will be deducted from the credit account.
When we want to make a booking, how do we pass details of our credit account to the airline?
Different airlines may require different parameters, so you have to be able to submit those parameters in your XML request to Travelfusion within the element CustomSupplierParameters. The information you need to provide in CustomSupplierParameters will vary depending on which airline you are submitting the booking to.
What if the credit account doesn’t have enough funds at the time of booking?
An error will be returned to you that says: "Agency account credit insufficient for payment". Any further booking attempts will get the same error until the credit account is topped up.
How to integrate UATP via Travelfusion?
Travelfusion fully supports and facilitates payments for Airplus account holders who would not otherwise be able to book LCC/hotel content. By submitting the AIDA account number, Travelfusion will be able to spawn a virtual MasterCard number within the AIDA system and thus complete the transaction.
In order to proceed with this, the steps to follow are:
- Let us know, so that we can configure your account for this facility.
- Make sure that within the ProcessTerms XML request, under the BookingProfile.BillingDetails.Address.CountryCode element, you are able to tell us the issuing country of the UATP account.
- Similarly, under the BookingProfile.BillingDetails.CreditCard block:
-- 'Number' node would represent the UATP account number.
-- 'CardType' node would be always 'UATP'.
-- 'ExpiryDate' node would be the expiration date of the UATP account.
Please note that whenever we spawn an A.I.D.A virtual card, we can supply additional MI data to AirPlus. Examples of this would include 'Cost Centre', 'Employee number', any other information you may find useful later on in the reports that AirPlus would be giving you (please see here more details).
If you are interested to move on with this, please let us know.