Status Updates

Keep your system in sync with the physical movement of the package at the PUDO point.

Webhook Events

Configure your webhook URL in the Partner Dashboard to receive these events.

Event	Meaning	Action Required
package.arrived_at_point	Driver dropped off package. Agent scanned it.	Notify Customer "Ready for pickup".
package.collected	Customer picked up the package.	Mark order as Delivered / Complete.
package.expired	Customer failed to pick up in 7 days.	Initiate Return process.
package.refused	Customer refused package (damaged/wrong).	Initiate Return process.

Mapping to Your Statuses

You likely have your own internal status enum. Here is a recommended mapping:

NowPost Status	Recommended Internal Status
created	Processing
in_transit	Out for Delivery
ready_for_pickup	Ready for Pickup / At Station
delivered	Delivered
returned	RTO Initiated

Polling (Fallback)

If webhooks fail, you can poll: GET /api/v1/partners/orders/{reference}