Skip to Content
FastracDocs
API reference

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.

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

Body of every shipment status event. Every data field is always present; unknown values are null.

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.pickup_failed

Body of every shipment status event. Every data field is always present; unknown values are null.

Request Body
application/json
{  "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  }}
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.pickup_failed",  "x-webhook-schema-version": "string",  "x-webhook-attempt": "string"}

Was this page helpful?