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_changedandshipment.price_changedwebhooks, 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
| Courier | Reports new measurements | Reports a new price |
|---|---|---|
SPX (SPX Express) | — | Yes |
LION (Lion Parcel) | Yes | Yes, including reroute and return charges, and a final settlement at delivery or return |
PAXEL (Paxel) | Yes | Yes |
NINJA (Ninja Xpress) | Yes | Yes |
| Other couriers | No | No. The quoted price is final, apart from return fees. |
How the difference is charged
| Situation | What Shipping Engine does |
|---|---|
| New price is higher, non-COD shipment | Charges the difference: from shipping credit if it covers the whole amount, otherwise from payout balance. |
| New price is higher, COD shipment | Records the new price but charges nothing. payment_status is not_required. |
| New price is lower | Nothing is refunded. The price you paid stands. |
| Neither pocket covers the increase | Records 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 entry | Example description |
|---|---|
DEBIT, amount = the increase | SPX 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 later | Pembayaran … 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.
{
"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 data | Meaning |
|---|---|
measurement_before | Weight and size you quoted, as text: weight=<g>g, dimension=<L>x<W>x<H>cm. - for an unknown value. |
measurement_after | Weight and size the courier measured, same format. |
status | The shipment's current status. |
shipment.price_changed
Sent when the price goes up.
{
"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 data | Meaning |
|---|---|
price_before | The shipment's total price before the adjustment, in IDR. |
price_after | The new total price, in IDR. |
delta | The increase. This is the amount charged. |
payment_status | success: 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 this | Why |
|---|---|
| Weigh the packed parcel, including box and filler, and send grams | The courier weighs what it receives. |
| Measure the outside of the box in cm, rounded up | Volumetric weight uses the outer dimensions. |
| Quote with the volumetric weight in mind | A bulky parcel costs more than its weight suggests. |
| Use the smallest box that fits | Less volume, lower chargeable weight. |
Send one packages[] entry per box | Each box is measured separately. See Packages. |
| Keep shipping credit above your expected adjustments | Avoids 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?