# Update an order

Update an authorized order's amount, order number, PO number, line items, or metadata. At least one field must be provided.

Endpoint: PUT /orders/{order_id}
Version: V5
Security: bearerAuth, basicAuth

## Path parameters:

  - `order_id` (string, required)
    ID of the order to update.

## Request fields (application/json):

  - `amount` (number)
    Updated authorization amount in USD.
    Example: 1200

  - `order_number` (string)
    Updated internal order number.
    Example: "5055"

  - `po_number` (string)
    Updated purchase order number.
    Example: "PO-555"

  - `line_items` (array)
    Updated line items for the order.

  - `line_items.name` (string)
    Name or description of the line item.
    Example: "Widget A"

  - `line_items.quantity` (number)
    Quantity of units.
    Example: 2

  - `line_items.unit_price` (number)
    Price per unit in USD.
    Example: 50

  - `line_items.sku` (string)
    SKU or product identifier.
    Example: "ABC-123"

  - `line_items.total_price` (number)
    Total price for this line item in USD. Defaults to unit_price × quantity if omitted.
    Example: 100

  - `line_items.type` (string)
    Line item type. Common values: product, shipping, subtotal.
    Example: "product"

  - `line_items.tax_amount` (number)
    Tax amount for this line item in USD.
    Example: 8.5

## Response 200 fields (application/json):

  - `id` (string)
    Unique identifier for the order.
    Example: "ORDlaE5wbg0"

  - `checkout_id` (string)
    ID of the checkout session associated with this order.
    Example: "CHKabc123"

  - `number` (string)
    Order number identifier.
    Example: "ord_100001"

  - `po_number` (string)
    Purchase order number associated with the order.
    Example: "PO-555"

  - `advance_requested` (boolean)
    Whether an advance was requested for this order.

  - `source` (string)
    Source channel that created the order.
    Example: "checkout"

  - `status` (string)
    Current status of the order.
    Example: "authorized"

  - `amount_authorized` (number)
    Total authorized amount for the order in USD.
    Example: 1000

  - `amount_captured` (number)
    Total captured amount for the order in USD.
    Example: 500

  - `amount_canceled` (number)
    Total canceled amount for the order in USD.

  - `amount_remaining` (number)
    Remaining authorized amount available for capture in USD.
    Example: 500

  - `first_captured_at` (string,null)
    Timestamp of the first capture event.
    Example: "2024-01-15T10:00:00.000Z"

  - `line_items` (array)
    Line items associated with the order.

  - `authorization_expires_at` (string)
    Timestamp when the authorization expires.
    Example: "2024-02-15T10:00:00.000Z"

  - `authorization_expiry_source` (string)
    Source that determined the authorization expiry.
    Example: "system"

  - `capture_events` (array)
    List of capture events for this order.

  - `capture_events.amount` (number)
    Amount captured in this capture event in USD.
    Example: 500

  - `capture_events.idempotency_key` (string)
    Idempotency key used for this capture.
    Example: "capture-2024-001"

  - `capture_events.processed_at` (string)
    Timestamp when this capture was processed.
    Example: "2024-01-15T10:00:00.000Z"

  - `capture_events.invoice_id` (string)
    ID of the merchant invoice associated with this capture.
    Example: "INabc123"

  - `authorized_at` (string)
    Timestamp when the order was authorized.
    Example: "2024-01-01T00:00:00.000Z"

  - `updated_at` (string)
    Timestamp when the order was last updated.
    Example: "2024-01-15T10:00:00.000Z"

  - `customer` (object)

  - `customer.id` (string)
    Unique identifier of the customer.
    Example: "X50sgfRd"

  - `customer.name` (string)
    Business name of the customer.
    Example: "Acme Corp"

  - `customer.remaining_credit` (number)
    Remaining available credit for the customer in USD.
    Example: 5000

## Response 400 fields (application/json):

  - `body` (Validation error (object) or Invalid request error (object)) — one of:
    - Validation error:
      - `error` (object)
      - `error.message` (string)
        A short string, describing error details
        Example: "Validation error"
      - `error.type` (string)
        A short string, describing error type
        Enum: "validation_error"
      - `error.details` (array)
      - `error.details.path` (string)
        Path to the field failed validation
        Example: "path.to.field"
      - `error.details.message` (string)
        Detailed description of the error
        Example: "`[field]` is required"
    - Invalid request error:
      - `error` (object)
      - `error.message` (string)
        A short string, describing error details
        Example: "[Invalid request message]"
      - `error.type` (string)
        A short string, describing error type
        Enum: "invalid_request"

## Response 401 fields (application/json):

  - `error` (object)

  - `error.message` (string)
    A short string, describing error details
    Example: "Invalid merchant credentials"

  - `error.type` (string)
    A short string, describing error type
    Enum: "authentication_error"

## Response 404 fields (application/json):

  - `error` (object)

  - `error.message` (string)
    A short string, describing error details
    Example: "[entity] not found"

  - `error.type` (string)
    A short string, describing error type
    Enum: "not_found_error"

## Response 429 fields (application/json):

  - `error` (object)

  - `error.message` (string)
    A short string, describing error details
    Example: "Too many requests"

  - `error.type` (string)
    A short string, describing error type
    Enum: "rate_limit_error"