{
  "statusCode": 400,
  "message": "Human-readable error message",
  "error_code": "ERROR_CODE",
  "timestamp": "2025-01-28T10:00:00.000Z"
}

{
  "statusCode": 401,
  "message": "API key not found or invalid",
  "error": "INVALID_API_KEY"
}

{
  "statusCode": 400,
  "message": "Insufficient balance for withdrawal",
  "error": "INSUFFICIENT_BALANCE"
}

{
  "transaction_id": "pay_1761290149387_6149e9c2",
  "status": "failed",
  "amount": 200000,
  "currency": "ARS",
  "method": "bank_transfer",
  "type": "deposit",
  "merchant_reference": "fb384323-a356-4877-b9ff-9de8d0a3c126",
  "created_at": "2025-10-24T07:15:49.387Z",
  "error_code": "MISSING_REQUISITES",
  "error_message": "No available requisites for this operation"
}

{
  "statusCode": 400,
  "message": "Payment method 'bank_transfer' is not configured for currency USD",
  "error": "INVALID_METHOD"
}

{
  "statusCode": 400,
  "message": "Invalid bank account format for ARS withdrawals",
  "error": "INVALID_WITHDRAWAL_DATA"
}

{
  "statusCode": 400,
  "message": "Currency 'EUR' is not supported for this merchant",
  "error": "UNSUPPORTED_CURRENCY"
}

{
  "transaction_id": "pay_existing_123",
  "status": "pending",
  "merchant_reference": "order-12345",
  "created_at": "2025-10-24T07:10:00.000Z",
  "_note": "Existing payment returned due to duplicate merchant_reference"
}

{
  "statusCode": 400,
  "message": "Invalid PayID: expected valid email for payid_type 'email'",
  "error": "INVALID_PAYID"
}

{
  "statusCode": 429,
  "message": "Too Many Requests",
  "error": "RATE_LIMIT_EXCEEDED"
}

{
  "statusCode": 400,
  "message": [
    "amount must be a positive number",
    "customer.email must be a valid email"
  ],
  "error": "Bad Request"
}

async function makeApiRequest(endpoint, options, attempt = 0, maxRetries = 3) {
  try {
    const response = await fetch(endpoint, options);

    if (!response.ok) {
      const error = await response.json();

      switch (response.status) {
        case 401:
          throw new AuthenticationError(error.message);
        case 429:
          if (attempt >= maxRetries) throw new ApiError('Max retries exceeded', 429);
          const retryAfter = response.headers.get('Retry-After') || 60;
          await sleep(retryAfter * 1000);
          return makeApiRequest(endpoint, options, attempt + 1, maxRetries);
        case 400:
        case 422:
          throw new ValidationError(error.message);
        default:
          throw new ApiError(error.message, response.status);
      }
    }

    return response.json();
  } catch (error) {
    if (error.name === 'NetworkError') {
      if (attempt >= maxRetries) throw error;
      await sleep(1000 * Math.pow(2, attempt));
      return makeApiRequest(endpoint, options, attempt + 1, maxRetries);
    }
    throw error;
  }
}