Errors

Canonical error envelope. REST error code maps 1:1 to JSON-RPC numeric code so SDKs can branch identically across surfaces.

Generated from docs/api/error-codes.md. Re-run npm run docs:generate after registry edits.

Code	RPC	HTTP	Type	Meaning
`bad_request`	`-32602`	400	validation_error	Malformed request
`validation_failed`	`-32602`	422	validation_error	Field-level validation failed
`unauthorized`	`-32010`	401	authentication_error	Missing / invalid credentials
`forbidden`	`-32011`	403	authorization_error	Authenticated but not allowed
`scope_required`	`-32012`	403	authorization_error	Missing required scope
`not_found`	`-32004`	404	not_found_error	Resource not found
`conflict`	`-32005`	409	conflict_error	State conflict
`idempotency_conflict`	`-32006`	409	idempotency_error	Same key, different body
`rate_limited`	`-32020`	429	rate_limit_error	Slow down
`payment_method_declined`	`-32001`	402	payment_error	Issuer declined
`payment_method_invalid`	`-32002`	422	payment_error	Bad PM data
`insufficient_funds`	`-32003`	402	payment_error	Issuer NSF
`risk_review_required`	`-32030`	202	risk_error	Held for manual review
`risk_declined`	`-32031`	402	risk_error	Risk policy declined
`provider_unavailable`	`-32040`	502	provider_error	Upstream provider down
`provider_timeout`	`-32041`	504	provider_error	Upstream timeout
`provider_error`	`-32049`	502	provider_error	Other provider failure
`compatibility_unsupported`	`-32050`	422	compatibility_error	Legacy field has no v1 equivalent
`not_implemented`	`-32099`	501	api_error	Stubbed surface
`internal_error`	`-32603`	500	internal_error	Unhandled