API Integration Cases

  1. How to create a new FareMarket booking with ancillaries
  2. How to create a new TechHub+ booking
  3. How to add Ancillary to an existing booking.
  4. How to create a new FareMarket cancellation
  5. How to create a new FareMarket rescheduling
  6. How to Create a FareMarket Bundle Booking

Here are the detail work flows for each case:

  1. How to create a new FareMarket booking with ancillaries

  2. How to create a new TechHub+ booking

  3. How to add Ancillary to an existing booking.

  1. How to create a new FareMarket cancellation

  1. How to create a new FareMarket rescheduling

  1. How to create a new FareMarket bundle Booking

  • I. FareMarket bundles are categorized into two types: Airline Bundles and Aerohub Bundles.

    • airline-branded fares: The bundle name and service rules align with the airline’s official website.
    • AeroHub branded fares: Defined by Aerohub, these bundles may include baggage, seat selection, priority boarding, and premium cabin packages. The service rules are based on Aerohub’s response.

    AerohubBundleName Definition Instructions:

Package Code Package Type Naming Rules and Examples
AHBasic Lowest-priced product package, must not be a non-standard product Package name can be empty or directly use AHBasic
AHBag Baggage product package Use package CODE + baggage weight in kilograms as the package name, e.g., AHBag15 indicates the baggage weight is 15 kg
  • II. Required Parameters and Response When Requesting Airline Bundles
    • Request the GetAvailability API, use the brandedFare parameter to specify the bundle type. Additionally, set priceMode = 1 to enable bundle product search. If these parameters are set to their default values, the system will return the lowest-priced product.
    • The brandedFare parameter options:
        1. airline-branded fares: Request airline bundle products.
        1. AeroHub branded fares: Request Aerohub bundle products.
      • return LowFareSearch by default
    • When bundle mode is enabled, the FARES section in the response will include multiple price options, each corresponding to a different bundle.
      • fareTypeCode field indicates the bundle type.
      • fareTypeDesc field provides the bundle name.
    • When fareTypeCode = AirlineBundle, the ruleid field will be empty, as the service rules follow the airline’s official bundle policies.
    • When fareTypeCode = AerohubBundle, the ruleid field will include details of the services included in each bundle.
  1. How to use FareMarket test case mock date
Scenarios No Flight Type Pax Type Baggage Seat Branded Fare Type Expected Booking Status Requirement
1 One Way Direct 1 ADT NO NO AeroHub-bundle Issued Required
2 One Way Connection 1 ADT
1 CHD		 ADD
NO		 ADD
NO		 AeroHub-bundle Issued Required
3 Round Trip Direct 2 ADT
1 CHD		 NO
NO		 ADD
ADD		 AeroHub-bundle Issued Required
4 Round Trip Connection 2 ADT
1 INF		 ADD
NO		 NO
NO		 AeroHub-bundle Issued Required
5 One Way Direct 1 ADT NO ADD AeroHub-bundle Rejected Required
6 One Way Direct 1 ADT
1 CHD
1 INF		 ADD
ADD
NO		 ADD
ADD
NO		 Airline-bundle Issued Optional
7 Round Trip Direct 1 ADT
1 CHD		 ADD
ADD		 ADD
ADD		 Airline-bundle Issued Optional
  1. How to update passenger information to TechHub booking on “Hold”
  2. How to add ancillaries for a paid TechHub booking
  3. Using Async LowFareSearch Flow increase carrier numbers
  1. How to update passenger information to TechHub booking on “Hold”
  2. How to add ancillaries for a paid TechHub booking
  3. Using Async LowFareSearch Flow increase carrier numbers
    When make a LowFareSearch request, each carrier response time might be different due to complicated reasons, you can call LowFareSearch several times in order to receive more carrier fare with async way.

    Suggestion:
    Using async searching to get the complete result if LetsFly API return part of result during timeout
    timeout is an integer value you can set in request, Letsfly will return with all the data from carriers when time is up.
    checking carries: if each carrier value in carriers is greater than or equals 0, it means all the carriers have returned value then you should stop searching. If one of the carriers is less than 0, you can start an asynchronous search to retrieve the remain carriers data.
    maximum 5 asynchronous requests can be sent for per user search
Author：fulei  Create time：2023-05-24 16:01
Last editor：AeroHub  Update time：2026-04-21 10:42