payer_concurrency: Too much concurrent unpaid work

A reservation would take the budget past its payer protection: it already holds as many reservations as allowed, or its held units plus this reservation would exceed the limit on reserved units. Only reservations are checked this way.

What to do

On the wire

HTTP 409, error type halted.

With Dynamo-Error-Detail: 1, and on the routes added in owner-api 1.4.0 and later (for example payment authorizations) with or without it:

{
  "error": "halted",
  "reason": "payer_concurrency",
  "streamId": "stm_…",
  "detail": "…",
  "errorDetail": {
    "type": "halted",
    "code": "payer_concurrency",
    "message": "…",
    "param": null,
    "doc_url": "…/errors/payer_concurrency.md",
    "fix": "too much concurrent unpaid work for this payer; wait for in-flight work to finish"
  }
}

On the older routes without the header, including the plugin wire's meter, the body has no errorDetail.

See all error codes.