Skip to main content

Order Tracking

Scottsdale Mint customers can track their orders using the [suma_order_tracking] shortcode provided by the suma-woo-order-tracking plugin. This creates a branded, self-service tracking page that avoids the need to call customer service.

Plugin Reference​

Full implementation details: suma-woo-order-tracking Plugin

Customer Tracking Page​

The tracking page is a WordPress page with the [suma_order_tracking] shortcode — typically at /track-your-order/ or /order-tracking/.

Lookup Form​

Customers can look up their order using:

  1. Order Number + Email (registered and guest customers)
  2. Tracking Number (FedEx tracking number)

Tracking Result Displays​

After a successful lookup, customers see:

  • Order Summary: order number, date, items, total amount
  • Payment Status: paid / pending / etc.
  • Order Status: current WooCommerce order status (human-readable label)
  • Estimated Ship Date (from ACO date meta or scheduled ship date)
  • Tracking Number: linked to FedEx tracking page
  • Shipment Status: from the last tracking webhook event stored on the order
  • Timeline: visual progression of order stages

Tracking Number Storage​

Tracking numbers from ShipStation are stored on WooCommerce order meta:

Meta KeyValue
_tracking_numberFedEx tracking number (string)
_tracking_providerfedex (carrier identifier)
_date_shippedUnix timestamp of ship date

Tracking data arrives via the ShipStation webhook:

POST /wp-json/suma/v1/shipstation-webhook

FedEx Integration​

When a tracking number is stored, the tracking page can optionally fetch live FedEx tracking status. The \Suma\OrderTracking\Fedex class:

  1. Calls the FedEx Tracking API with the tracking number
  2. Returns shipment status, last scan location, and estimated delivery date
  3. Caches the result in Redis for 15 minutes to avoid excessive API calls
info

FedEx tracking data is fetch-on-demand (customer visits their tracking page) — it is not proactively fetched or stored.

Admin: Adding Tracking Numbers Manually​

Admin users can add or update tracking numbers directly from the WooCommerce order screen:

  1. Open WooCommerce → Orders → [Order]
  2. Scroll to the Order Tracking metabox
  3. Enter FedEx tracking number
  4. Click Save Tracking
  5. The customer's tracking confirmation email is re-sent (optional checkbox)

Email Notifications​

When a tracking number is added (via ShipStation webhook or admin manual entry), the \Suma\Emails\ShippingConfirmation email is automatically sent:

  • FedEx tracking number (linked)
  • Estimated delivery date
  • Items in the shipment
  • Link to the order tracking page

My Account Integration​

Logged-in customers can also find tracking information in My Account → Orders → [View Order], where:

  • Full tracking history is displayed
  • The FedEx tracking link is visible
  • Current order status is shown with the full custom status label

ShipStation Webhook​

ShipStation sends tracking updates to:

POST /wp-json/suma/v1/shipstation-webhook

Payload includes:

  • Order number
  • Tracking number
  • Carrier (FedEx)
  • Ship date

The endpoint is secured with a shared secret webhook token.