Skip to Content
FastracDocs

Price and weight adjustments

Why a shipment's price can go up after pickup, which couriers adjust, how the difference is charged, and how to avoid it.

Product
APIShipping Engine API
Section
Core concepts
Reading time
5 min read

In short

  • After pickup, some couriers weigh and measure the parcel again. If it is heavier or larger than you quoted, the price goes up.
  • Shipping Engine charges only the increase, from shipping credit first, then payout balance. Decreases are never refunded. COD shipments are not charged.
  • You get shipment.measurement_changed and shipment.price_changed webhooks, and the charge appears in your balance logs.

Why couriers reweigh

A rate is priced on the weight and size you send. Couriers check the real parcel at their hub. If the chargeable weight is higher than quoted, they bill the difference, and Shipping Engine passes it on.

Chargeable weight is the higher of the actual weight and the volumetric weight:

volumetric weight (kg) = length × width × height (cm) ÷ volumetricConversion
chargeable weight      = max(actual weight, volumetric weight)

volumetricConversion is set per courier service, for example 6000. Find it in listCourierServices. A light but bulky parcel is charged by its size.

Example

You quote 1.000 g with dimensions 10 × 10 × 10 cm. The courier measures 30 × 20 × 20 cm. With a divisor of 6000, the volumetric weight is 2 kg, so the parcel is charged as 2 kg, not 1 kg.

Which couriers report adjustments

CourierReports new measurementsReports a new price
SPX (SPX Express)—Yes
LION (Lion Parcel)YesYes, including reroute and return charges, and a final settlement at delivery or return
PAXEL (Paxel)YesYes
NINJA (Ninja Xpress)YesYes
Other couriersNoNo. The quoted price is final, apart from return fees.

How the difference is charged

SituationWhat Shipping Engine does
New price is higher, non-COD shipmentCharges the difference: from shipping credit if it covers the whole amount, otherwise from payout balance.
New price is higher, COD shipmentRecords the new price but charges nothing. payment_status is not_required.
New price is lowerNothing is refunded. The price you paid stands.
Neither pocket covers the increaseRecords the charge as unpaid. payment_status is failed, and Fastrac support contacts you to settle it.

The charge is never split across pockets. You also get an email about each adjustment.

Balance log entryExample description
DEBIT, amount = the increaseSPX price adjustment | Order #… | Shipment #… | +5000
Ninja price adjustment | …, Paxel price adjustment | …
Lion price adj(webhook) SHP-…, Lion return adj(track) SHP-…, Lion final delivery adj(…) SHP-…
DEBIT, an unpaid charge settled laterPembayaran … resi <awb>

Search the logs by shipment code or airway bill with listBalanceLogs (shipmentId filter). For SPX, Ninja and Paxel, filter by date and DEBIT and match the amount to the delta in the webhook.

Webhooks

shipment.measurement_changed

Sent when the courier reports a new weight or size.

Deliveredshipment.measurement_changed
{
  "booking_id": "FSO-261120-B4TQ9P",
  "awb": "NLIDAP12345678",
  "courier_code": "ninja",
  "shipment_code": "SHP-261120-K7M2QX",
  "data": {
    "status": "IN_TRANSIT",
    "desc": "Measurement adjusted by courier (Ninja)",
    "measurement_before": "weight=1000g, dimension=10x10x10cm",
    "measurement_after": "weight=2000g, dimension=30x20x20cm",
    "timestamp": "2026-11-21 02:14:09"
  }
}
Field in dataMeaning
measurement_beforeWeight and size you quoted, as text: weight=<g>g, dimension=<L>x<W>x<H>cm. - for an unknown value.
measurement_afterWeight and size the courier measured, same format.
statusThe shipment's current status.

shipment.price_changed

Sent when the price goes up.

Deliveredshipment.price_changed
{
  "booking_id": "FSO-261120-B4TQ9P",
  "awb": "SPXID0123456789",
  "courier_code": "spx",
  "shipment_code": "SHP-261120-K7M2QX",
  "data": {
    "status": "IN_TRANSIT",
    "desc": "Shipment price adjusted due to courier reweigh",
    "price_before": 12984,
    "price_after": 18050,
    "delta": 5066,
    "payment_status": "success",
    "timestamp": "2026-11-21 02:14:10"
  }
}
Field in dataMeaning
price_beforeThe shipment's total price before the adjustment, in IDR.
price_afterThe new total price, in IDR.
deltaThe increase. This is the amount charged.
payment_statussuccess: charged. failed: couldn't be charged, now owed. not_required: nothing charged, for example a COD shipment.

data.timestamp is in UTC without an offset. See the event catalog. In sandbox, simulateShipmentStatus with PRICE_CHANGED or WEIGHT_CHANGED sends these events with sample values.

How to avoid adjustments

Do thisWhy
Weigh the packed parcel, including box and filler, and send gramsThe courier weighs what it receives.
Measure the outside of the box in cm, rounded upVolumetric weight uses the outer dimensions.
Quote with the volumetric weight in mindA bulky parcel costs more than its weight suggests.
Use the smallest box that fitsLess volume, lower chargeable weight.
Send one packages[] entry per boxEach box is measured separately. See Packages.
Keep shipping credit above your expected adjustmentsAvoids failed charges and follow-ups.

Common mistakes

Sending weight in kilograms

weight is in grams. 1.2 means 1.2 grams, so the courier's reweigh will add the full price of the real weight.

Expecting a refund when the parcel is lighter

Decreases are never refunded. Accurate quotes protect you in both directions.

Treating the order price as final

Reconcile with your balance logs. Adjustments can arrive days after the order, while the parcel is in transit.

Was this page helpful?

On this page