Error Codes

{
  "type": "about:blank",
  "title": "Validation Error",
  "status": 400,
  "detail": "amount must be greater than 0",
  "instance": "/api/v1/checkout"
}

1
async function createCheckout(data) {
2
  try {
3
    const response = await fetch('https://cashier.flowpayment.net/api/v1/checkout', {
4
      method: 'POST',
5
      headers: {
6
        'X-API-Key': process.env.CASHIER_API_KEY,
7
        'Content-Type': 'application/json',
8
      },
9
      body: JSON.stringify(data),
10
    });
11
12
    if (!response.ok) {
13
      const error = await response.json();
14
15
      switch (error.status) {
16
        case 400:
17
          // Validation error - show user-friendly message
18
          console.error('Validation error:', error.detail);
19
          throw new Error('Please check your input and try again');
20
        case 401:
21
          // Auth error - check API key
22
          console.error('Authentication failed');
23
          throw new Error('Service temporarily unavailable');
24
        case 429:
25
          // Rate limited - implement backoff
26
          const retryAfter = response.headers.get('Retry-After') || 60;
27
          console.log(`Rate limited. Retry after ${retryAfter}s`);
28
          throw new Error('Too many requests. Please wait.');
29
        default:
30
          console.error('API error:', error);
31
          throw new Error('An error occurred. Please try again.');
32
      }
33
    }
34
35
    return await response.json();
36
  } catch (err) {
37
    // Network or parsing errors
38
    console.error('Request failed:', err);
39
    throw err;
40
  }
41
}

1
import requests
2
import time
3
4
class CashierError(Exception):
5
    def __init__(self, status, code, detail):
6
        self.status = status
7
        self.code = code
8
        self.detail = detail
9
        super().__init__(f"{code}: {detail}")
10
11
def create_checkout(data: dict, max_retries: int = 3):
12
    """Create a checkout session with retry logic."""
13
14
    for attempt in range(max_retries):
15
        try:
16
            response = requests.post(
17
                'https://cashier.flowpayment.net/api/v1/checkout',
18
                headers={
19
                    'X-API-Key': os.environ['CASHIER_API_KEY'],
20
                    'Content-Type': 'application/json',
21
                },
22
                json=data,
23
                timeout=30
24
            )
25
26
            if response.ok:
27
                return response.json()
28
29
            error = response.json()
30
            status = error.get('status', response.status_code)
31
32
            # Handle specific errors
33
            if status == 429:
34
                # Rate limited - exponential backoff
35
                retry_after = int(response.headers.get('Retry-After', 60))
36
                time.sleep(retry_after)
37
                continue
38
39
            if status >= 500:
40
                # Server error - retry with backoff
41
                time.sleep(2 ** attempt)
42
                continue
43
44
            # Client error - don't retry
45
            raise CashierError(
46
                status=status,
47
                code=error.get('title', 'Unknown Error'),
48
                detail=error.get('detail', 'An error occurred')
49
            )
50
51
        except requests.exceptions.Timeout:
52
            if attempt < max_retries - 1:
53
                time.sleep(2 ** attempt)
54
                continue
55
            raise CashierError(504, 'TIMEOUT', 'Request timed out')
56
57
        except requests.exceptions.RequestException as e:
58
            raise CashierError(0, 'NETWORK_ERROR', str(e))
59
60
    raise CashierError(500, 'MAX_RETRIES', 'Max retries exceeded')

{
  "type": "about:blank",
  "title": "Validation Error",
  "status": 400,
  "detail": "amount must be greater than 0",
  "instance": "/api/v1/checkout"
}

{
  "type": "about:blank",
  "title": "Unauthorized",
  "status": 401,
  "detail": "Invalid or missing API key",
  "instance": "/api/v1/checkout"
}

{
  "type": "about:blank",
  "title": "Gone",
  "status": 410,
  "detail": "Checkout session cs_abc123 has expired",
  "instance": "/api/v1/checkout/cs_abc123"
}

{
  "type": "about:blank",
  "title": "Too Many Requests",
  "status": 429,
  "detail": "Rate limit exceeded. Please retry after 60 seconds.",
  "instance": "/api/v1/checkout"
}