Notifications Reference¶

This page lists all notifications sent across the Shiphustle platform. Use this reference to understand what action is expected when you receive a notification.

Notifications are grouped by recipient role so you can quickly find the notifications relevant to your responsibilities.

Customer Notifications¶

These notifications are sent to customers about their orders.

Notification Type	Trigger Event	Email	SMS	Message
`order_status`	Order status changes (completed, reopened)	✅	✅	Status update for the order
`cancellation_approved`	Admin approves a cancellation request	✅	✅	"Your cancellation request has been approved"
`cancellation_rejected`	Admin rejects a cancellation request	✅	✅	"Your cancellation request has been declined"
`document_required`	Admin sends a passport reminder	✅	—	"Passport required for your order"
`refund_initiated`	Admin processes a procurement refund or VAT refund	✅	✅	Refund amount and removed items
`refund_processed`	Paystack confirms the refund has been paid out	✅	✅	"Refund completed — sent to your bank"
`collection_reminder`	Order uncollected at depot/pickup point	✅	✅	Reminder to collect the parcel
`application_update`	Courier application approved or rejected	✅	—	Application decision and next steps

Admin Notifications¶

These notifications alert admins when action is needed.

Notification Type	Trigger Event	Email	Message
`new_order`	Customer pays for an order (status → `order_placed`)	✅	Customer name, country, items, total — action needed: begin procurement
`cancellation_request`	Customer submits a cancellation request	—	Order ref, customer name, reason
`order_stuck`	Order hasn't progressed in configured threshold	—	Order ref and time stuck
`collection_escalation`	Parcel uncollected beyond escalation threshold	—	Order ref and days uncollected
`vat_claim_overdue`	VAT claim past its expected processing date	—	Claim reference and overdue period
`new_application`	Courier submits an application	—	Applicant name and company

Courier Team Notifications¶

Transporter¶

Notification Type	Trigger Event	Email	Message	Expected Action	Guide
`shipment_handover`	Source Depot Officer assigns a shipment	✅	"Shipment assigned to you"	Review and accept or decline	Accepting Shipment
`shipment_reassignment`	Another transporter initiates PIN-based reassignment	—	"Shipment reassigned to you"	Enter PIN to accept	Reassigning Shipment

Dispatcher¶

Notification Type	Trigger Event	Email	Message	Expected Action	Guide
`dispatch_handover`	Destination Depot Officer assigns a batch	✅	"Batch assigned for dispatch"	Review and accept or decline	Accepting Dispatch

Pickup Point Officer¶

Notification Type	Trigger Event	Email	Message	Expected Action	Guide
`pickup_handover`	Dispatcher confirms arrival and initiates handover	✅	"Batch arrival at pickup point"	Verify goods, accept or decline	Accepting Batch

Driver¶

Notification Type	Trigger Event	Email	Message	Expected Action	Guide
`delivery_assignment`	Destination Depot Officer assigns door delivery orders	✅	"Orders assigned for door delivery"	Review and accept or decline	Accepting Assignment

Destination Depot Officer¶

Notification Type	Trigger Event	Message	Expected Action	Guide
`driver_declined`	Driver declines a door delivery assignment	"Driver declined delivery assignment"	Reassign a different driver	Driver Response
`dispatcher_declined`	Dispatcher declines a batch dispatch assignment	"Dispatcher declined batch dispatch"	Cancel assignment, reassign	Dispatcher Response
`shipment_arrived`	Transporter initiates depot handover	"Shipment handover requested"	Review and accept or decline	Accepting Shipments

Source Depot Officer¶

Notification Type	Trigger Event	Message	Expected Action	Guide
`transporter_declined`	Transporter declines a shipment assignment	"Transporter declined shipment"	Reassign the transporter	Accept & Decline Workflow

Notification Channels¶

Shiphustle delivers notifications via three channels:

Channel	Delivery Method	Preference Control
Push	In-app notification (always sent)	Cannot be disabled
Email	Via Resend API to user's registered email	Per-category toggle in account settings
SMS	Via Twilio/Ekukhuleni to verified phone	Shares email preference toggle

Preference Categories

Notifications are grouped into preference categories that users can enable or disable:

Order Updates — order status, refunds, cancellations, new orders
Messages — new chat messages
Documents — document upload/required reminders
Team — application updates, team invitations