Checkout & Orders
Submit Checkout
Submit the active cart. The cart is re-priced and re-validated; the account's minimum order value is enforced (422 below it). If the account's approval policy requires it, an approval request is created (status `pending_approval`, no order yet); otherwise a draft order is created and the cart is emptied. `ship_to_address_id` (or an inline `ship_to`), `customer_po_number`, `requested_delivery_date`, `shipping_method_id`, `note`, and `payment_method` are accepted. Lines that cannot be supplied are rejected with 422 `unpurchasable_lines`, listing each offending line and a `reason` of `insufficient_stock` (fewer units in stock than requested, and no backorder), `out_of_stock`, or `unpriced`.
Estimate Checkout
Preview subtotal plus estimated tax and shipping for the current cart before submitting. `is_estimate` is always true — final totals are confirmed by the merchant on the order. The `subtotal` here is net of any order-value discount the cart has earned, so it is what the buyer will be billed for goods.
List Orders
List the active account's orders.
Get Order
Return one order with its buyer-friendly status timeline (Submitted → Confirmed → In progress → Shipped → Complete), line items, and per-shipment tracking. Returns 404 if the order is not on the active account.
Download Order Document
Download an order document (packing slip or invoice) as a PDF. Returns 404 if the order is not on the active account.
List Addresses
List the active account's saved ship-to / bill-to addresses.
Add Address
Add a saved address to the active account.
List Shipping Methods
List the shipping methods available at checkout.