mandate_limit: The request exceeds a mandate limit

The request is larger than the mandate's perTransactionMax, or it would take the spend in the current perPeriod window over its max.

What to do

On the wire

HTTP 409, error type halted.

A client that does not send Dynamo-Error-Detail: 1 to a 1.3.0 route sees the legacy reason cap, so its response shape is unchanged. Opted-in clients and the 1.4.0 routes see mandate_limit.

With Dynamo-Error-Detail: 1:

{
  "error": "halted",
  "reason": "mandate_limit",
  "streamId": "stm_…",
  "detail": "…",
  "errorDetail": {
    "type": "halted",
    "code": "mandate_limit",
    "message": "…",
    "param": null,
    "doc_url": "…/errors/mandate_limit.md",
    "fix": "the request exceeds perTransactionMax or the per-period limit; send less or wait for the next period"
  }
}

See all error codes.