mandate_assurance: The payee identity level is too low

The stream's payee has no economic account, or its derived identity level is below the mandate's minPayeeAssurance. It is checked when a stream is opened or delegated, on every spend, and for the payee a payment authorization (POST /owner/v1/streams/{id}/payment-authorizations) names. Nothing is allocated, billed or authorized (fail closed).

What to do

On the wire

HTTP 409, error type halted (or mandate_error on open/delegate).

On spending, a client that does not send Dynamo-Error-Detail: 1 to a route that predates 1.4.0 sees the legacy reason cap, so its response shape is unchanged. Opted-in clients, and the routes that always answer in detail such as payment authorizations, see mandate_assurance.

On a stream open or delegation or a human payment, a client that does not send Dynamo-Error-Detail: 1 gets {"error": "mandate", "reason": "mandate_assurance", "detail": "…"}: the precise reason, without errorDetail. The child adoption preparation (POST /owner/v1/streams/{id}/children/adopt-prepare) sends errorDetail to every client. The plugin wire's child open (POST /plugin/v1/streams/{id}/children) answers HTTP 409 {"error": "child open refused (fail closed)", "reason": "mandate_assurance"}, with no detail and no errorDetail.

With Dynamo-Error-Detail: 1:

{
  "error": "halted",
  "reason": "mandate_assurance",
  "streamId": "stm_…",
  "detail": "…",
  "errorDetail": {
    "type": "halted",
    "code": "mandate_assurance",
    "message": "…",
    "param": null,
    "doc_url": "…/errors/mandate_assurance.md",
    "fix": "register the payee at or above the mandate's minPayeeAssurance, or open a budget whose mandate allows a lower level"
  }
}

See all error codes.