Errors & money
HTTP errors, suspension, and commission balance rules.
Commission balance
Platform fees are taken from your internal balance — not from the on-chain payment. Top up via treasury deposits. If balance cannot cover a fee, invoice creation is suspended until you credit the account.
Fee tiers
Monthly USD volume sets your rate: under $10k → 1%, $10k+ → 0.75%, $50k+ → 0.5%. UTC calendar months reset volume and tier together. Each invoice uses the rate immediately before its settled volume is added; the new tier applies to subsequent invoices. Credits restoring a nonnegative balance restore ACTIVE status.
Error shape
POST/GET /v1/invoices use {error: {code, message}}. Codes include INVALID_AMOUNT, UNSUPPORTED_ASSET, UNSUPPORTED_NETWORK, WALLET_NOT_CONFIGURED, PROJECT_NOT_READY, INVALID_API_KEY, INVOICE_NOT_FOUND, IDEMPOTENCY_CONFLICT, RATE_LIMITED, INVALID_REQUEST and TEMPORARILY_UNAVAILABLE. Retry transient errors with the original Idempotency-Key. A permanent order ID conflict requires retrieving the original invoice; amount-space exhaustion requires another wallet. Legacy dashboard routes retain statusCode/message errors.