Skip to main content

Order Tracking

After placing an order, BookWish provides detailed tracking and status updates throughout the fulfillment process.

Order Information​

Each order includes comprehensive details:

Order Identifiers​

Order Number:

  • Human-readable unique identifier
  • Format: orderNumber field
  • Used for customer service
  • Displayed prominently in order details

Order ID:

  • System-generated unique ID
  • Used in URLs and internal references
  • Format: UUID or similar

Order Details​

Customer Information:

  • User ID (if logged in)
  • Billing information
  • Shipping address (for shipped orders)

Fulfillment:

  • Fulfillment Type - pickup, ship, or gift
  • Store ID - Your home store (if applicable)
  • Is BookWish Direct - Boolean flag

Financial:

  • Subtotal (in cents)
  • Tax amount (in cents)
  • Shipping cost (in cents)
  • Discount amount (in cents)
  • Trade credit applied (in cents)
  • Total - Grand total in cents

Payment:

  • Stripe Payment Intent ID
  • Payment status
  • Payment method (handled by Stripe)

Items:

  • Array of OrderItem objects
  • Each with book, quantity, price, condition

Timestamps:

  • Created at
  • Updated at

Order Statuses​

Orders progress through several statuses from placement to completion.

Status Flow​

Standard Flow:

  1. pending - Order placed, payment processing
  2. confirmed - Payment confirmed, order acknowledged
  3. processing - Order being prepared/packed
  4. ready_for_pickup - Available at store (pickup orders)
  5. shipped - Package shipped (ship orders)
  6. delivered - Order completed
  7. cancelled - Order cancelled

Status Descriptions​

pending​

  • Meaning: Order just placed
  • Next Step: Payment confirmation
  • Duration: Minutes to hours
  • Action Required: None, wait for confirmation

confirmed​

  • Meaning: Payment successful, order acknowledged
  • Next Step: Order processing begins
  • Duration: Hours to 1 day
  • Action Required: None

processing​

  • Meaning: Order being prepared
  • Next Step: Ready for pickup or shipping
  • Duration: 1-5 business days
  • Action Required: None

For Store Orders:

  • Store gathering/ordering books
  • May involve special orders from Ingram
  • Store contacts you with updates

For BookWish Direct:

  • Warehouse processing order
  • Books being packed for shipment

ready_for_pickup​

  • Meaning: Order available at store (pickup only)
  • Next Step: Customer pickup
  • Duration: Waits for pickup
  • Action Required: Visit store to collect order

Notification:

  • Store may email or call
  • In-app notification sent
  • Order marked for pickup

shipped​

  • Meaning: Package shipped (ship orders only)
  • Next Step: In transit to delivery
  • Duration: 3-7 business days
  • Action Required: Await delivery

Tracking Available:

  • Tracking number provided
  • Carrier information included
  • EasyPost shipment ID tracked

delivered​

  • Meaning: Order completed successfully
  • Next Step: None, enjoy your books!
  • Duration: Final status
  • Action Required: None

Confirmation:

  • Carrier confirms delivery
  • Order marked complete
  • Can leave review

cancelled​

  • Meaning: Order cancelled
  • Next Step: Refund processed
  • Duration: Final status
  • Action Required: Contact support if questions

Reasons for Cancellation:

  • Customer requested
  • Payment failed
  • Item unavailable
  • Store unable to fulfill

Viewing Order Details​

Access Order​

From Confirmation:

  • Automatically navigate after checkout
  • URL: /orders/[orderId]

From Order History:

  • Navigate to your orders list
  • Tap on specific order
  • View full details

Order Details Page​

Shows comprehensive order information:

Header:

  • Order number
  • Order date
  • Current status

Items Section:

  • Each book ordered
  • Cover image (if available)
  • Title and author
  • Quantity
  • Unit price
  • Condition (new/used)

Fulfillment Information:

  • Fulfillment type
  • Store name (if applicable)
  • Pickup or shipping details

Cost Breakdown:

  • Subtotal
  • Tax
  • Shipping (if applicable)
  • Discounts (if any)
  • Trade credits (if applied)
  • Total

Tracking (if shipped):

  • Shipping carrier
  • Tracking number
  • EasyPost shipment ID
  • Link to carrier tracking

Addresses:

  • Shipping address (if shipped)
  • Billing address (if different)

Shipment Tracking​

For shipped orders, tracking details help you monitor delivery.

Tracking Information​

Shipping Carrier:

  • USPS, UPS, FedEx, etc.
  • Determined by fulfillment method
  • Managed through EasyPost

Tracking Number:

  • Unique package identifier
  • Clickable link to carrier site
  • Format varies by carrier

EasyPost Shipment ID:

  • Internal shipment reference
  • Used for BookWish tracking
  • Not needed by customer

Tracking Your Shipment​

In BookWish:

  1. Open order details
  2. Find tracking section
  3. View tracking number
  4. Tap link to carrier website

On Carrier Site:

  • See detailed package journey
  • Estimated delivery date
  • Current package location
  • Delivery updates

Tracking Updates​

Automatic Updates:

  • Status synced from carrier
  • In-app notifications for milestones
  • Email updates (if enabled)

Key Milestones:

  • Shipment created
  • Package picked up
  • In transit
  • Out for delivery
  • Delivered

Notifications​

Stay informed about order progress with notifications.

Notification Types​

Order Confirmation:

  • Sent when order placed
  • Includes order number
  • Summary of purchase

Shipment Notification:

  • Sent when order ships
  • Includes tracking number
  • Estimated delivery

Delivery Notification:

  • Sent when delivered
  • Confirmation of completion
  • Invitation to review

Pickup Ready:

  • Sent when ready for pickup
  • Store location and hours
  • Instructions for pickup

Status Changes:

  • Major status updates
  • Issues or delays
  • Action items if needed

Notification Preferences​

Manage in Settings:

  • Push notifications toggle
  • Email notifications toggle
  • Choose notification types

See Notification Settings for details.

Order History​

Viewing Past Orders​

Access all your orders:

  1. Navigate to account/profile section
  2. Find "Orders" or "Order History"
  3. Browse chronological list

Order List Shows:

  • Order number
  • Order date
  • Total amount
  • Current status
  • Quick actions

Sorting/Filtering:

  • Most recent first
  • Filter by status
  • Search by order number or book

Order Actions​

From order history:

  • View Details - Open full order page
  • Track Shipment - If shipped, view tracking
  • Reorder - Add same items to cart (future feature)
  • Contact Support - Get help with order

Payment Status​

Track payment processing separately from order status.

Payment Statuses​

pending:

  • Payment initiated
  • Processing by Stripe
  • Waiting for confirmation

succeeded:

  • Payment completed
  • Funds captured
  • Order confirmed

failed:

  • Payment declined
  • Order may be cancelled
  • Update payment method

refunded:

  • Order cancelled
  • Refund processed
  • Funds returning

Stripe Payment Intent​

Each order has a Stripe Payment Intent ID:

  • Unique payment identifier
  • Used for payment tracking
  • Reference for disputes
  • Needed for customer service

Issues and Support​

Common Order Issues​

Delayed Orders:

  • Check order status
  • Review tracking info
  • Contact store or support after expected time

Missing Items:

  • Verify order details
  • Check package thoroughly
  • Contact support immediately

Wrong Items:

  • Don't use/open books
  • Take photos of items
  • Contact support for exchange

Damaged Items:

  • Document damage with photos
  • Keep all packaging
  • File claim through support

Contacting Support​

For Store Orders:

  • Contact your home store directly
  • They manage fulfillment
  • BookWish can help facilitate

For BookWish Direct:

  • Use in-app support
  • Email customer service
  • Reference order number

Information to Provide:

  • Order number
  • Order date
  • Description of issue
  • Photos if applicable

Order Data​

What's Stored​

Per Order:

  • All order details listed above
  • Order items with book references
  • Payment information
  • Fulfillment details
  • Tracking information
  • Status history

Order Items:

  • Book ID and reference
  • Inventory ID (if from store inventory)
  • Quantity
  • Unit price
  • Condition (new/used)
  • Created timestamp

Data Privacy​

Your Orders:

  • Private to your account
  • Not visible to other users
  • Shared only with fulfilling store
  • Used for support and analytics

Store Access:

  • Stores see only their orders
  • Your contact info for fulfillment
  • No access to other orders

Tips for Order Management​

  1. Save order number - Keep confirmation for reference
  2. Track shipments - Check tracking regularly
  3. Enable notifications - Stay updated automatically
  4. Contact store for delays - They can provide specific updates
  5. Keep packaging - Until you verify order is correct
  6. Leave reviews - Help others after you receive books