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
- Use a new UUID v4 key for a new funding, or repeat the exact same request.
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.