shipment.pickup_failed
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.
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-B7C8D9", "awb": "LLM-260412345", "courier_code": "lalamove", "shipment_code": "SHP-261120-T3V6X9", "data": { "timestamp": "2026-11-21 03:30:00", "status": "PROBLEM_SHIPMENT", "desc": "Order expired, no driver available", "note": null, "mapping_code": "EXPIRED", "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.pickup_failed", "x-webhook-schema-version": "string", "x-webhook-attempt": "string"}Was this page helpful?
shipment.problem_detected Webhook
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.
shipment.rts_confirmed Webhook
The courier will return the parcel to the sender (RTS). From here the shipment only moves through return statuses. A return fee may follow as `shipment.rts_billed`.