Order Management
Manage orders and order lines. Create orders from checkout, track status lifecycle (pending → paid → processing → shipped → delivered), lookup by payment ID for webhook dedup. Prices in cents.
Try it with your AI assistant
Once WebsitePublisher is connected to your AI assistant, paste one of these into the chat. Replace the parts in [brackets] with your own details.
@WebsitePublisher show my paid orders that have not been shipped yet@WebsitePublisher mark order [order number] as shipped and add the tracking code [code]@WebsitePublisher make my order numbers look like [SHOP-2026-001]With WebsitePublisher, show my paid orders that have not been shipped yetWith WebsitePublisher, mark order [order number] as shipped and add the tracking code [code]With WebsitePublisher, make my order numbers look like [SHOP-2026-001]With WebsitePublisher, show my paid orders that have not been shipped yetWith WebsitePublisher, mark order [order number] as shipped and add the tracking code [code]With WebsitePublisher, make my order numbers look like [SHOP-2026-001]Endpoints (8)
Create an order with line items. Order number auto-generated in the project's format (default ORD-2026-0001; see get-settings / configure). Prices in cents. Subtotal calculated from items if not provided.
No input parameters required.
Get a single order with all its line items. Lookup by order_id or order_number. Verified visitors may only read their own order.
No input parameters required.
Read stored per-line record-meta for an order. Returns each line with its meta keyed by def_key (e.g. "lens" => {od_*, os_*}). Pass def_key to filter to one definition; omit for all. Admin/owner-scoped.
No input parameters required.
List orders with optional filters. Paginated, sorted by created_at desc by default. Verified visitors see only their own orders (scoped server-side to the session email).
No input parameters required.
Update order status with lifecycle validation. Enforces allowed transitions (e.g. pending→paid, paid→processing). Set tracking info when shipping.
No input parameters required.
Find an order by payment provider and payment ID. Used for webhook deduplication — check if order already exists for this payment.
No input parameters required.
Owner only. The project's order number format and a preview of the next order number.
No input parameters required.
Owner only. Set the order number format, e.g. "ORDER #{YYYY}-{SEQ:3}" gives ORDER #2026-001. Tokens: {YYYY}, {YY}, {SEQ} or {SEQ:n} (n = 1-10 digits). Exactly one {SEQ}; other text only letters, digits, space and # - _ / . (max 40). With a year token numbering restarts every year. null or "" restores the default ORD-{YYYY}-{SEQ:4}. next_sequence continues numbering at that value (e.g. to follow your own bookkeeping); existing numbers are always skipped, never duplicated. Existing orders keep their number.
No input parameters required.
MCP Tool Names
When using this integration through an AI assistant (Claude, ChatGPT, Cursor, etc.), the endpoints are available as MCP tools:
| Endpoint | MCP Tool Name |
|---|---|
| create-order | order-management_create_order |
| get-order | order-management_get_order |
| get-line-meta | order-management_get_line_meta |
| list-orders | order-management_list_orders |
| update-status | order-management_update_status |
| get-order-by-payment | order-management_get_order_by_payment |
| get-settings | order-management_get_settings |
| configure | order-management_configure |
Website