Error Reference

Errors use the response envelope. Common error.type values:

type	Typical HTTP	When
VALIDATION_ERROR / INVALID_INPUT	400	Body/query failed schema validation; sandbox-only endpoint hit in prod.
UNAUTHORIZED	401	Missing/invalid X-Partner-Key/X-Partner-Secret, or missing/expired Bearer session.
FORBIDDEN	403	Partner account suspended/revoked; account already exists on the main Qwik app.
NOT_FOUND	404	Resource missing or not owned by this user/partner.
DATABASE_ERROR / INTERNAL_SERVER_ERROR	500	Unexpected server error.
(upstream)	502	The card/bank provider rejected the call (e.g. a deposit create).

Always check success first; read error.message for the human-readable reason and error.details for field-level context.