Skip to Content
FastracDocs
API reference

shipment.price_changed

The courier changed the shipping price after it reweighed or remeasured the parcel. Only increases on non-COD shipments are charged, from your balance; decreases are not refunded. payment_status is failed when your balance could not cover the difference (Shipping Engine support follows up). A shipment.measurement_changed event usually accompanies it.

Header Parameters

user-agent*string

Always Fastrac-Webhook-Client/1.0.

x-webhook-id*string

Unique event ID. The same on every retry of one event; use it to drop duplicates.

Formatuuid
x-webhook-timestamp*string

Unix time in seconds when this attempt was sent. Part of the signed string; reject requests more than 300 seconds old.

Match^[0-9]+$
x-webhook-signature*string

keyId=<keyId>,sig=<hex>, where sig is hex(HMAC_SHA256(secret, "<x-webhook-timestamp>.<x-webhook-id>.<hex(SHA256(raw body))>")). Compute it on the raw request bytes and compare in constant time.

x-webhook-event-type*string

The event name.

x-webhook-schema-version*string

Version of the event body format.

x-webhook-attempt*string

Delivery attempt number, starting at 1.

Match^[0-9]+$

Request Body

application/json
  1. body
booking_id*string

The order code.

awb*|

Airway bill, null before the courier assigns one.

courier_code*string

Courier code in lowercase, for example jne or lalamove.

shipment_code*string
data*

Response Body

Any 2xx within your endpoint's timeoutMs (default 10 seconds) marks the event delivered. The response body is ignored. Answer quickly and process the event asynchronously.

Example Requests
POST/shipment.price_changed
Request Body
application/json
{  "booking_id": "FSO-261120-A1B2C3",  "awb": "CM12345678901",  "courier_code": "jne",  "shipment_code": "SHP-261120-K9M2Q7",  "data": {    "timestamp": "2026-11-21 01:30:00",    "status": "IN_TRANSIT",    "desc": "Price adjusted by courier",    "price_before": 12984,    "price_after": 19476,    "delta": 6492,    "payment_status": "success"  }}
Header Parameters
{  "user-agent": "string",  "x-webhook-id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "x-webhook-timestamp": "string",  "x-webhook-signature": "string",  "x-webhook-event-type": "shipment.price_changed",  "x-webhook-schema-version": "string",  "x-webhook-attempt": "string"}

Was this page helpful?