Idempotency

Send Idempotency-Key on every write so retries never double-charge or duplicate transfers.

Updated Jul 15, 2026API 2026-07-01 Edit on GitHub Report an issue

How it works

The API stores the response for any request with an Idempotency-Key for 24 hours. Retrying with the same key and body replays the original response — the underlying operation runs only once.

Usage

API v1

curl -X POST https://api.korvenone.com/v1/withdrawals \
  -H "Authorization: Bearer sk_live_..." \
  -H "Idempotency-Key: withdraw-invoice-1042-attempt-1" \
  -H "Content-Type: application/json" \
  -d '{ "amount": 500000, "currency": "HTG", "beneficiary": "ben_9x" }'

Conflicts

Reusing a key with a different body returns 409 idempotency_conflict.
Keys should be unique per logical operation (e.g. include order ID + retry counter).
Keys expire after 24 hours; after that the operation is considered fresh.

Rate Limits

Versioning