GuidesAPI EndpointsChangelog
Log In
Guides

Updating an Order

🚧

WIP - With Team


Adjustments are a standard part of order processing, commonly used to address:

  • Product availability
  • Discounts or promotions
  • Tax recalculations

Handling Draft Orders

For orders in a DRAFT state:

  • Respond with HTTP 200 OK and the Order object in the response body after all adjustments have been made.

What Happens After Your Response

  • Discounts, totals, and taxes will reflect the values provided in your response and are updated in the Weedmaps UI.
  • Line items with a quantity of zero will be flagged as “unavailable”, requiring the customer to remove these items before checkout.

Finalized Orders

Once an order is finalized and submitted for fulfillment, subsequent updates (e.g., status changes) should:

📘

Note on Service Fees:

When active, the Weedmaps Service Fee is included in the Draft event payload and should be reflected in your order response. This setting is managed within the retailer’s Weedmaps account.

Status Updates

Providing real-time order status updates via the Orders API is not required but is highly encouraged:

  • Customers receive text message updates through Weedmaps (learn more).
  • Regular updates enhance customer trust and reduce inbound support inquiries.
  • Retailers maintaining accurate status updates may earn the Best of Weedmaps badge, improving their visibility in Weedmaps search results.

Available Order Statuses

StatusDescription
DRAFTOrder pending adjustments before checkout.
PENDINGOrder placed, pending retailer review.
IN_PROGRESSOrder accepted and in preparation.
READY_FOR_ATTAINMENTOrder ready for pickup or delivery dispatch.
COMPLETEOrder successfully fulfilled.
CANCELED_CUSTOMEROrder canceled by the customer.
CANCELED_SELLEROrder canceled by the retailer.
FAILEDOrder failed to process.

A best of Weedmaps badge example