Skip to content

How pricing works

Every price in a quote’s quotes object is worked out for one shipment, for your account and your API key, at the moment you ask. The same shipment can therefore have a different price on the website, under another account, under another key or on another day. This page explains how a price is built, what you are charged, and the usual reasons a price looks wrong.

For the request and response themselves, see How quoting works.

Transdirect prices each courier separately, in this order:

  1. Courier rate. The courier’s price for the shipment, either from the courier’s own system or from Transdirect’s rate card for that courier. It depends on the route, the package type, the charged weight (the greater of dead weight and volumetric weight), and for some couriers whether an address is residential. Some couriers add a remote-area or residential charge at this point.

  2. Fuel levy. For couriers priced from a rate card, Transdirect adds that courier’s current fuel levy. Couriers that price through their own system already include it.

  3. Transdirect margin. The price is multiplied by Transdirect’s margin for that courier. A frequent-shipper price uses its own margin.

  4. Courier surcharges. Charges some couriers make for particular items, such as oversized items.

  5. GST. 10% is added. Exceptions: a few couriers’ rates already include GST, international exports carry no GST, and international imports carry GST only on Transdirect’s margin.

  6. Your account discount. If Transdirect has given your account a discount for this courier, that percentage comes off the price including GST. Discounts are set per courier, so one courier can be discounted and another not.

  7. Tail lift. If you asked for a tail lift, the courier’s tail lift charge is added. It is not discounted.

  8. Carbon offset. For most couriers, a small carbon offset amount is added, based on the price band of the shipment and reduced by your account discount. A few couriers, such as Mainfreight, have none.

  9. Transit warranty. If the shipment has a declared value, the courier’s transit warranty fee is added.

  10. Your API key’s settings. Surcharges, fixed prices and shipping rules set on your key change total. They are a price for your own customers, not what Transdirect charges you. See Your key’s settings change total, not your charge.

Prices are rounded to the cent after GST and again after your discount. In the response, total, price_insurance_ex, fee, applied_gst and insured_amount are rounded to the cent. A percentage surcharge from your key is not, so round it yourself before you show it. A few couriers apply their residential or remote-area charge at a different point in the order, so you cannot rebuild a price exactly from a courier’s public rate card.

These figures are made up to show the order of the steps. They are not real rates or margins.

StepChangeRunning price
Courier rate$20.00
Fuel levy+15%$23.00
Transdirect margin× 1.20$27.60
GST+10%$30.36
Account discount−10%$27.32
Carbon offset+$0.09$27.41
Transit warrantyno declared value$27.41

The quote shows price_insurance_ex and total of 27.41, fee of 0 and applied_gst of 2.49, which is 27.41 ÷ 11. Without the account discount, the same shipment is $30.46: $30.36 plus a $0.10 carbon offset.

Each entry in quotes carries these price fields. All amounts are in AUD and include GST.

FieldMeaning
totalThe price shown for this courier: price_insurance_ex plus fee, then changed by your key’s settings, if any.
price_insurance_exThe price before the transit warranty fee and before your key’s surcharges and fixed prices.
feeThe transit warranty fee. 0 when there is no cover or the courier includes cover for free. It is not a courier or booking fee.
applied_gstThe GST in the price before the warranty fee and your key’s settings: that price divided by 11, rounded to the cent. It does not change with a surcharge, fixed price or rule. On an international export, where no GST is charged, it is still shown and does not mean GST was added.
insured_amountThe transit warranty cover, which can be lower than your declared_value because cover is capped per courier.
surchargePresent only when your key’s general or per-courier surcharge was added. The amount added to total.
free_shippingPresent and true when one of your key’s shipping rules set total to 0.
courierPresent only when your key renames or groups this courier. The name to show your customers. The entry’s key in quotes is still the courier id you confirm with.
tiersThe frequent-shipper price for Couriers Please and Aramex, when your account can use it. See Frequent rates.

With no surcharge, fixed price or rule on your key, total is price_insurance_ex plus fee. A surcharge or fixed price changes total only. A shipping rule sets both total and price_insurance_ex to the rule’s result.

A quote never charges anything. Each quote request creates a draft booking, and you pay only when you confirm it. There is no separate quote-only switch or method parameter: POST /api/v5/quotes is always quote-only.

When you confirm, Transdirect prices the courier you chose again from the booking’s current details and charges that amount. It usually matches that courier’s quoted price before your key’s settings, but it can differ when:

  • You changed the items or addresses with Update a booking or the booking items endpoints after quoting.
  • The courier’s own price changed between the quote and the confirm.
  • Transdirect’s rates, fuel levies or your account discounts changed in that time.
  • You confirmed with a frequent-shipper tier that your account cannot use, or the frequent price is not available at confirm. You are charged the everyday price instead.

Quote shortly before you confirm. If you change the shipment, quote again to see the price you will be charged. After confirming, read the amount charged from cost on Get a booking.

Your key’s settings change total, not your charge

Section titled “Your key’s settings change total, not your charge”

Your key’s module settings can add a general or per-courier surcharge, replace a courier’s price with a fixed price, and apply shipping rules that add, subtract, fix or zero the price. These exist so that a store can show its own shoppers a shipping price. Transdirect applies them to total in the quote response, and charges you the courier price at confirm without them.

The courier weighs and measures the shipment. If it is heavier or larger than you declared, Transdirect can bill the difference after the booking as an additional charge, shown in additional_charges on Get a booking. Other additional charges include a failed (futile) pickup and a residential delivery for an address booked as a business. Accurate weights, dimensions, package types and address types avoid them.

The quote’s total is the everyday price, which anyone can book. Couriers Please and Aramex can also return a cheaper frequent-shipper price in tiers, for accounts that send at least 3 consignments per collection. It uses its own margin and can have its own account discount.

  • Confirm with the tier’s identifier as tier to book at the frequent price. If your account cannot use frequent rates at confirm, you are charged the everyday price.
  • Your key’s Multipickup options setting can make the frequent price the quote’s total instead of the everyday price.
  • The website can show the frequent price next to the everyday price, so compare like with like.

See Frequent rates for eligibility and the confirm request.

Why API prices can differ from the website

Section titled “Why API prices can differ from the website”

Who asks for the quote decides which couriers are quoted, whether your discounts apply and whether your key’s settings apply:

Quoted fromCouriersYour account discountsYour key’s settings
Transdirect’s public website, or the API without a keyPublicly listed couriers onlyNoNo
The members area, signed inCouriers available to your accountYesNo
The API with your keyCouriers available to your account and keyYesYes

The same shipment can also price differently because of:

  • Courier access. Couriers switched off for your account are not quoted. Team Global Express quotes only accounts Transdirect has approved for it. Its application asks for your freight profile, the kind of freight you send (pallets, cartons or satchels). Followmont drops out of every quote, on the website and through the API, while it is at its capacity limits.
  • Your key’s courier list. A plugin key quotes the couriers selected for that store. A Custom API key quotes Transdirect’s standard list.
  • Quote display. With Display cheapest or Display cheapest and fastest set on your key, the response holds only one or two quotes.
  • Your key’s defaults. Missing weights and dimensions are filled from your key’s default package size, a declared value of 0 can be replaced by your key’s default warranty value, tail lift can be added for items over 25 kg, and order boxing can repack the items. See API key configuration.
  • Promo and referral codes. Codes used on the website apply only there, and replace your account discount while they apply. The API never applies them.
  • Time. Prices are live. A quote from yesterday, or from before a fuel levy change, can differ from one made now.

These are the most common causes of “incorrect pricing” reports, roughly in order:

  1. Comparing with the website, or a quote made without your key. Different couriers, discounts and settings apply. See the table above.
  2. Your key’s surcharge, fixed price or rule. Check for surcharge or free_shipping on the quote, and read the rules with api_details/full. Remember these are not charged.
  3. Residential or business. type on each address changes the couriers that quote and what they charge. Send what the address really is.
  4. Missing or rounded measurements. Missing weights and dimensions use your key’s defaults. Weights over 1 kg are rounded up to whole kilograms and dimensions to whole centimetres. See rounding.
  5. Volumetric weight. A large, light carton is charged on its volume, at a conversion factor that differs between couriers. See volumetric weight.
  6. Package type. description is the packaging, such as Carton or Pallet, and couriers price and accept each type differently. See package types.
  7. Transit warranty. A non-zero declared_value, or your key’s default warranty, adds fee to total. Send "include_warranty": false to quote without it.
  8. Tail lift. Asking for a tail lift, or your key adding one, adds a charge for items over 25 kg.
  9. GST. Quote prices include GST. A courier’s published rate usually does not.
  10. A courier missing from the list. Check quote_errors before you treat the cheapest price you see as the cheapest price available.
  11. Everyday versus frequent price. total is the everyday price unless your key says otherwise. The frequent price is in tiers.
  12. An old quote. Prices are live and confirm prices the courier again. Quote again before you compare.

If a price still looks wrong, contact Transdirect support with the draft booking id, the request body you sent and the response you received. The id lets support see exactly how that quote was priced.