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. When the account's ship-to policy is `saved_only` (it may ship only to addresses the merchant approved), adding an address is refused with 422 `ship_to_not_allowed`.
List Shipping Methods
List the shipping methods available at checkout, each priced for the current cart and ship-to.
Validate Address
Checks a typed address without saving it — use it before placing an order to an address that is not in the address book, such as a dropship order's consumer address.