Skip to main content

Errors and Troubleshooting

Common HTTP Categories​

  • 400: validation or request content errors
  • 401: auth/signature/session failures
  • 404: entity not found
  • 500: infrastructure or upstream failures

Frequent Client Flow Errors​

  • 401 Authorization header is required
  • 401 Bearer token is required
  • 401 Session is invalid or expired
  • 400 walletAddress is invalid
  • 400 chainId is invalid
  • 400 CHAIN_NOT_SUPPORTED
  • 404 Invoice not found

Frequent Integration Flow Errors​

  • 401 Signature is required
  • 401 Invalid signature
  • 401 Request timestamp is expired
  • 401 Timestamp already used
  • 400 Invalid nonce
  • 400 Signature deadline is expired
  • 401 Invalid setPayout signature
  • 500 RPC_UNAVAILABLE
  1. For 401: clear auth state and re-authenticate.
  2. For 400: show validation feedback from server response.
  3. For 404: present not-found or empty state UX.
  4. For 500: retry with backoff and show fallback error.

Debug Checklist​

  1. Confirm chain is supported.
  2. Validate timestamp freshness and uniqueness.
  3. Ensure signed payload exactly matches sent payload.
  4. Re-check nonce source before signing EIP-712 data.