proof_invalid: The identity proof does not verify

An identity link on an economic account (POST /owner/v1/accounts/:id/links) carries a proof that this deployment checked and refused:

param names the field that failed. Nothing was linked and the account's level is unchanged.

What to do

On the wire

HTTP 400, error type invalid_request_error.

{
  "error": "proof_invalid",
  "errorDetail": {
    "type": "invalid_request_error",
    "code": "proof_invalid",
    "message": "issuer signature does not verify",
    "param": "issuerSignature",
    "doc_url": "…/errors/proof_invalid.md",
    "fix": "re-issue the proof against this account's address and retry"
  }
}

The account routes always add errorDetail, with or without Dynamo-Error-Detail: 1. The doc_url shown is the one a client pinned at Dynamo-Version 1.8.0 or later receives. A client pinned before 1.8.0, or a request naming no version on a single-tenant core, receives a doc_url ending in errors/errors/proof_invalid.md, a page that forwards here. On the multi-tenant hosted tier a request naming no version is served the account's default version (1.8.0 for new accounts).

See all error codes.