card_agent_idempotency_conflict: The idempotency key is already used

One idempotency key funds one request. This key funded a different request, or an earlier attempt under it has not finished. The exact same request under the same key answers the same funding (duplicate: true) and never authorizes twice. Nothing new was authorized.

What to do

On the wire

HTTP 409, error type state_error. Every client gets errorDetail, with or without Dynamo-Error-Detail: 1. On the multi-tenant hosted tier the card agent funding route (POST /owner/v1/card-agent-programs/fundings) needs Dynamo-Version 1.8.0 or later: the front door answers a request served at an earlier version with HTTP 404 version_unavailable before the core sees it, and serves a request that names no version at the account's default (1.8.0 for new accounts). A single-tenant core answers whatever version the request names.

{
  "error": "state",
  "reason": "card_agent_idempotency_conflict",
  "detail": "…",
  "errorDetail": {
    "type": "state_error",
    "code": "card_agent_idempotency_conflict",
    "message": "…",
    "param": "idempotencyKey",
    "doc_url": "…/errors/card_agent_idempotency_conflict.md",
    "fix": "one idempotency key funds one request; use a new UUID v4 key, or repeat the exact same request"
  }
}

See card agent programs and all error codes.