> ## 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>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.