card_agent_token_unusable: The card agent token cannot fund this budget

The card agent program reports no such token or instruction, or the token is suspended, deleted or past its validity window, or it is bound to another agent, another person, or a person who is not this budget's root funder. Nothing was authorized and nothing was stored.

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_token_unusable",
  "detail": "…",
  "errorDetail": {
    "type": "state_error",
    "code": "card_agent_token_unusable",
    "message": "…",
    "param": "tokenRef",
    "doc_url": "…/errors/card_agent_token_unusable.md",
    "fix": "the program reports the token unknown, inactive or expired, or bound to another agent or person; ask the person to provision a token for this agent and this root funder"
  }
}

See card agent programs and all error codes.