shipment.problem_detected
The courier reported a problem, such as a lost or damaged parcel or a failed delivery attempt
that needs attention. The shipment status becomes PROBLEM_SHIPMENT. Read desc and note,
and contact support if the courier does not resolve it.
user-agent*stringAlways Fastrac-Webhook-Client/1.0.
x-webhook-id*stringUnique event ID. The same on every retry of one event; use it to drop duplicates.
uuidx-webhook-timestamp*stringUnix time in seconds when this attempt was sent. Part of the signed string; reject requests more than 300 seconds old.
^[0-9]+$x-webhook-signature*stringkeyId=<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*stringThe event name.
x-webhook-schema-version*stringVersion of the event body format.
x-webhook-attempt*stringDelivery attempt number, starting at 1.
^[0-9]+$application/json- body
Body of every shipment status event. Every data field is always present; unknown values are null.
booking_id*stringThe order code.
awb*|Airway bill, null before the courier assigns one.
courier_code*stringCourier code in lowercase, for example jne or lalamove.
shipment_code*stringdata*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.
Body of every shipment status event. Every data field is always present; unknown values are null.
{ "booking_id": "FSO-261120-A1B2C3", "awb": "CM12345678901", "courier_code": "jne", "shipment_code": "SHP-261120-K9M2Q7", "data": { "timestamp": "2026-11-21 10:02:00", "status": "PROBLEM_SHIPMENT", "desc": "Alamat penerima tidak ditemukan", "note": "Nomor rumah tidak sesuai", "mapping_code": "U02", "driver_name": null, "driver_phone": null, "driver_license_plate": null, "proof_image": null, "receiver_name": null, "receiver_relation": null, "tracking_link": null }}{ "user-agent": "string", "x-webhook-id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "x-webhook-timestamp": "string", "x-webhook-signature": "string", "x-webhook-event-type": "shipment.problem_detected", "x-webhook-schema-version": "string", "x-webhook-attempt": "string"}Was this page helpful?
shipment.cancelled Webhook
The shipment was cancelled. `CANCELLED` is final. What was paid for it is refunded; see **List balance logs**.
shipment.pickup_failed Webhook
The courier could not collect the parcel and won't retry, for example an instant order that expired or was rejected because no driver was found. The shipment status becomes `PROBLEM_SHIPMENT`. Pickup attempts the courier will retry do not send this event.