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

# Operation lifecycle

> Track completion and retry without duplicating operations.

## Quote before submitting

Request a quote for the selected product and amount. Include its expected total when submitting an operation.

## Submit once, track the result

`POST /api/v1/operations` requires an `Idempotency-Key`. Store the returned operation ID and use `GET /api/v1/operations/{id}` to track its status.

Operations reserve funds and are processed asynchronously. An accepted or queued response is not a completed purchase.

## Retries

When retrying the same operation after a network failure, reuse the original idempotency key and unchanged request data. Do not generate a new key merely because a response was lost. Reusing a key with different data can return a conflict.

## Uncertain outcomes

An operation in `manual_review` has an unresolved outcome and can retain its reserved funds. Do not automatically submit a replacement operation or assume a refund. Wait for reconciliation.