Error Handling

import {
  SettleSettleError,        // Base — catch all SDK errors
  InsufficientCreditsError, // 402 — user has no credits
  AuthenticationError,      // 401 — bad or missing API key
  ValidationError,          // 400 — invalid request body
  RateLimitError,           // 429 — too many requests
  TimeoutError,             // 408 — request took too long
  ApiError,                 // Any other API error
} from 'settlesettle'

try {
  await settle.wallet.debit('user_123', { amount: 10 })

} catch (err) {

  if (err instanceof InsufficientCreditsError) {
    // Expected — user is out of credits
    // Trigger your paywall or ad fallback
    console.log(`Need: ${err.requestedAmount}, Have: ${err.currentBalance}`)

  } else if (err instanceof AuthenticationError) {
    // Your API key is wrong or missing
    console.error('Check your SETTLESETTLE_API_KEY.')

  } else if (err instanceof ValidationError) {
    // You sent a bad request body
    console.error('Bad request:', err.message, err.fields)

  } else if (err instanceof RateLimitError) {
    // Slow down — too many requests
    console.error(`Rate limited. Retry in ${err.retryAfterMs}ms.`)

  } else if (err instanceof TimeoutError) {
    // Request took too long
    console.error('Request timed out. Check your connection.')

  } else if (err instanceof SettleSettleError) {
    // Any other SDK error — catch-all
    console.error(`SDK error [${err.code}]: ${err.message}`)
    console.error('Status code:', err.statusCode)

  } else {
    // Completely unexpected — rethrow
    throw err
  }
}