API Error Codes and Troubleshooting Guide

import { flarehq } from '@/lib/flarehq';

try {
  const session = await flarehq.checkout.createSession({
    amount: '10.00',
    currency: 'USDC',
    recipient: '0xRecipientAddress',
  });
  return session.url;
} catch (error: any) {
  if (error.status === 401) {
    // Invalid or missing API key
    console.error('Auth error — check FLAREHQ_SECRET_KEY:', error.message);
  } else if (error.status === 429) {
    // Rate limited — respect Retry-After
    const retryAfter = error.headers?.['retry-after'] ?? 5;
    console.warn(`Rate limited. Retry after ${retryAfter}s`);
  } else if (error.status >= 500) {
    // Transient server error — retry with backoff
    console.error('Server error, retrying shortly:', error.message);
  } else {
    throw error;
  }
}

from flarehq import FlareHQ, FlareHQError
import os, time

client = FlareHQ(api_key=os.environ['FLAREHQ_SECRET_KEY'], environment='testnet')

try:
    session = client.checkout.create_session(
        amount='10.00',
        currency='USDC',
        recipient='0xRecipientAddress',
    )
    print(session.url)
except FlareHQError as e:
    if e.status_code == 401:
        print('Auth error — check FLAREHQ_SECRET_KEY:', e.message)
    elif e.status_code == 429:
        retry_after = e.headers.get('retry-after', 5)
        print(f'Rate limited. Retry after {retry_after}s')
        time.sleep(int(retry_after))
    elif e.status_code >= 500:
        print('Server error, retrying shortly:', e.message)
    else:
        raise