Skip to Content
FastracDocs
API reference

shipment.pending_pickup

The shipment is waiting for the courier to collect it. Also sent when an instant courier assigns a driver: driver_name, driver_phone and driver_license_plate are then filled.

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

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 02:55:00",    "status": "PENDING_PICKUP",    "desc": "Driver sedang menuju lokasi penjemputan",    "note": null,    "mapping_code": "ON_GOING",    "driver_name": "Agus Prasetyo",    "driver_phone": "081355556666",    "driver_license_plate": "B 3456 TKO",    "proof_image": null,    "receiver_name": null,    "receiver_relation": null,    "tracking_link": "https://share.lalamove.example/t/abc123"  }}
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.pending_pickup",  "x-webhook-schema-version": "string",  "x-webhook-attempt": "string"}

Was this page helpful?