> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dintero.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Order Management

> Create, track, and manage the full lifecycle of orders. From draft through payment, capture, and refund.

## What is Order Management?

The Dintero Order Management API lets you create and manage orders independently of payment. Payment is handled by your payment system — the Order Management API records what has happened (authorized, captured, refunded) but does not execute payment operations itself.

## Order lifecycle

<Steps>
  <Step title="Draft">
    Create a draft order with line items. The order is not yet active and can be freely modified.

    [POST /accounts/\{aid}/shopping/draft\_orders](/api-reference/draft/aid_draft_orders_post)
  </Step>

  <Step title="Active">
    Complete the draft to make the order active and assign it an `order_id`.

    [PUT /accounts/\{aid}/shopping/draft\_orders/\{id}/complete](/api-reference/draft/aid_draft_orders_id_complete_put)
  </Step>

  <Step title="Authorized">
    Authorize the payment in your payment system. Then record the authorization on the order to mark funds as reserved.

    [POST /accounts/\{aid}/shopping/orders/\{order\_id}/authorizations](/api-reference/orderauthorizations/aid_orders_id_authorization_post)
  </Step>

  <Step title="Captured">
    Capture the payment in your payment system. Then record the capture on the order to keep the order state in sync.

    [POST /accounts/\{aid}/shopping/orders/\{order\_id}/captures](/api-reference/ordercaptures/aid_orders_id_capture_post)
  </Step>

  <Step title="Refunded or Cancelled">
    Refund the payment in your payment system and record the refund on the order, or cancel an uncaptured order.

    [POST /accounts/\{aid}/shopping/orders/\{order\_id}/refunds](/api-reference/orderrefunds/aid_orders_id_refunds_post)

    [POST /accounts/\{aid}/shopping/orders/\{order\_id}/cancel](/api-reference/orderstatus/aid_orders_id_cancel_post)
  </Step>
</Steps>

## Guides

<CardGroup cols={2}>
  <Card title="Orders and Checkout" icon="https://mintcdn.com/dintero-c3a7bfec/kqE6jEgPSu_iF1M_/mintlify-docs/assets/icons/shopping-cart.svg?fit=max&auto=format&n=kqE6jEgPSu_iF1M_&q=85&s=a106def896b6ea5ac07af8ac575e3c86" href="/docs/order-management/checkout-orders" width="20" height="20" data-path="mintlify-docs/assets/icons/shopping-cart.svg">
    How to combine the Order Management and Checkout services. Create a draft order, take payment, capture, and refund in one end-to-end flow.
  </Card>

  <Card title="Update an order (reversing)" icon="https://mintcdn.com/dintero-c3a7bfec/WW-UMjl-QNnroAqd/mintlify-docs/assets/icons/refresh.svg?fit=max&auto=format&n=WW-UMjl-QNnroAqd&q=85&s=07d03a638ea1c6d1c2aebc1bf1eaa464" href="/docs/order-management/order-update-refund" width="20" height="20" data-path="mintlify-docs/assets/icons/refresh.svg">
    How to modify an existing order by reversing items and adding new ones, keeping captured amounts and refunds aligned.
  </Card>
</CardGroup>
