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 inmanual_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.