Reference

Error catalog

Every error NITY0X can return, generated from the same typed error registry the API uses internally. The type field in an error response is stable across releases — match on it, not on message.

Payment lifecycle

	404	`payment_not_found` Payment '{id}' not found
	410	`payment_expired` Payment has expired
	422	`invalid_fsm_transition` Illegal FSM transition {from} → {to}
	409	`occ_conflict` Concurrent modification detected — please retry

Chain / adapter

	400	`chain_not_enabled` Chain '{chain}' is not enabled
	503	`chain_adapter_unavailable` Chain adapter for '{chain}' is temporarily unavailable
	503	`address_pool_exhausted` Deposit address pool exhausted for chain '{chain}' — contact support

Balance / payout

	422	`insufficient_balance` Insufficient {chain} balance (needed {needed}, available {available})
	503	`executor_suspended` Payout executor is temporarily suspended due to RPC errors — retry in 60 seconds

Auth / rate limit

	429	`rate_limit_exceeded` Rate limit exceeded. Retry after 60 seconds.
	401	`unauthorized` Authentication required
	403	`forbidden` You do not have permission to perform this action

Feature flags

403

feature_disabled

Feature '{key}' is not enabled

Generic

500

internal_error

An unexpected error occurred — please retry