Returns work order status and details for a customer-facing order status page. Authenticated by reference code plus either a confirmation token or customer email. Does not expose admin notes or internal fields.
Request Parameters
Field
Type
Required
Description
ref
string
Required
Work order reference code
token
string
Optional*
Confirmation token from create_work_order
email
string
Optional*
Customer email on the order
* At least one of token or email must be provided.
Response Fields
Field
Type
Description
reference_code
string
Work order reference code
status
string
pending, pending_payment, payment_submitted, processing (paid, being set up — lasts seconds), completed, canceled, payment_failed, or awaiting_webhook
type
string
new_activation, renewal, trial_upgrade, or new_trial
source
string
Origin source e.g. woocommerce or api
customer_email
string
Customer email address
customer_name
string|null
Customer full name
currency
string
Currency code e.g. USD
cart
array
Cart items (removed and adjustment items excluded). Each item carries plugin_id, plugin_name, category_id and category_name — one order may span services.
selected_bouquets
array
Bouquet ids chosen on this order, empty when the customer took the defaults
snap_total
float
Sum of cart item prices before any coupon or adjustment
coupon
object|null
The coupon on this order — code and discount — or null
order_total
float
Final total after the coupon and the payment method's adjustment
prev_paid
float
Amount already paid toward this order
balance_due
float
Remaining balance due
has_partials
boolean
True if partial payments have been made and a balance remains
payment_history
array
Record of individual payments made against this order
adjustment
object|null
Price adjustment applied to the order — see Adjustment Object below
payment_method
object|null
Payment method details — see Payment Method Object below
created_at
string
Order creation datetime UTC
updated_at
string
Order last updated datetime UTC
Adjustment Object
Field
Type
Description
direction
string
fee or discount
label
string|null
Display label for the adjustment
amount
float
Adjustment amount
Payment Method Object
Field
Type
Description
id
integer
Payment method ID
name
string
Display label, falls back to internal name
processor
string|null
Processor identifier
mode
string
automated or manual
is_automated
boolean
Whether this is a fully automated gateway
instructions
string|null
Payment instructions for manual methods
config
object
Processor-specific configuration — empty object if not set
