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
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
Active
Complete the draft to make the order active and assign it an
order_id.PUT /accounts/{aid}/shopping/draft_orders/{id}/completeAuthorized
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
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
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.