Xgenious/ docs

Status Updates

Shipment status stays in sync automatically once the webhook URL is configured. No manual action is required.

Webhook Status Flow

Once the webhook URL is configured in your courier's dashboard, status updates are received automatically:

  1. Courier picks up the parcel — status updates to Shipped.
  2. Parcel is in transit — status updates to In Transit.
  3. Delivery attempted — status updates as appropriate.
  4. Customer receives parcel — status updates to Delivered.

Statuses update in real time as the courier scans the parcel.

If statuses are not updating automatically, verify the webhook URL is correctly configured in your courier's dashboard and that the webhook secret matches. See Admin Setup for the webhook URL pattern.

All Shipment Statuses

StatusMeaning
PendingShipment created, awaiting courier pickup
ShippedParcel picked up from your location
In TransitParcel moving through the courier network
DeliveredSuccessfully delivered to the recipient
FailedDelivery attempt failed (for example recipient not home)
ReturnedParcel returned to sender
CancelledShipment cancelled

Previous: Cancel Shipment · Next: Credential Reference

Still stuck?
Our support team is ready to help you get set up.
Get support