orderlisted

# Place Order ## Authentication Include the user's Bearer token in every request: ``` Authorization: Bearer USER_ACCESS_TOKEN ``` Users obtain tokens via OAuth 2.0 at https://bobs-store.com/oauth/authorize. ## Workflow Complete the following steps in order. ### Step 1: Add Items to Cart POST /cart/items ```json { "product_id": "prod_8x7k", "quantity": 1 } ``` Response (201 Created): ```json { "cart_id": "cart_r4t9", "items": [ { "product_id": "prod_8x7k", "name": "SoundWave Pro Wireless Headphones", "quantity": 1, "unit_price": 79.99, "subtotal": 79.99 } ], "total": 79.99, "currency": "USD" } ``` Repeat this step to add multiple products. Each call adds one item. ### Step 2: Apply Coupon (optional) POST /cart/coupon ```json { "code": "SAVE20" } ``` Response (200 OK): ```json { "cart_id": "cart_r4t9", "coupon": "SAVE20", "discount": 16.00, "total": 63.99, "currency": "USD" } ``` Only one coupon per cart. To change, send a new code — it replaces the previous one. ### Step 3: Create Order POST /orders ```json { "cart_id": "cart_r4t9", "shipping_method": "standard", "shipping_address": { "name": "Jane Doe", "line1": "123 Main St", "city": "San Francisco", "state": "CA", "zip": "94105", "country": "US" }, "payment_token": "tok_visa_4242" } ``` | Field | Type | Required | Description | |------------------|--------|------