Skip to main content

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.

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

1

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
2

Active

Complete the draft to make the order active and assign it an order_id.PUT /accounts/{aid}/shopping/draft_orders/{id}/complete
3

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
4

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
5

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}/refundsPOST /accounts/{aid}/shopping/orders/{order_id}/cancel

Guides

Orders and Checkout

How to combine the Order Management and Checkout services. Create a draft order, take payment, capture, and refund in one end-to-end flow.

Update an order (reversing)

How to modify an existing order by reversing items and adding new ones, keeping captured amounts and refunds aligned.
Last modified on May 12, 2026