Account Settings
This guide covers how to manage your personal account settings in C-Tax, including your profile, password, security, and preferences.
Accessing Settings
Step 1: Open Settings
- Click on your name or profile picture in the top-right corner
- Select Settings from the dropdown menu
Or look for a Settings option in the sidebar.
Step 2: Navigate Setting Sections
Settings are organized into sections:
- Profile - Your personal information
- Password - Change your password
- Two-Factor Authentication - Security settings
- Appearance - Display preferences
Profile Settings
What You Can Change
| Field | Description |
|---|---|
| Name | Your display name |
| Your login email (may require verification) |
Updating Your Profile
- Go to Settings → Profile
- Edit your information
- Click Save or Update Profile
Important Notes
- Email changes may require verification
- Your role is shown but can only be changed by an administrator
- Branch assignment is managed by administrators
Password Settings
When to Change Your Password
Change your password if:
- It’s been a long time since you changed it
- You think someone else might know it
- You’ve used it on an insecure computer
- You’re required to by company policy
How to Change Your Password
- Go to Settings → Password
- Enter your Current Password
- Enter your New Password
- Confirm your new password
- Click Update Password or Save
Password Requirements
A good password should:
- Be at least 8 characters long
- Include uppercase and lowercase letters
- Include numbers
- Include special characters (!@#$%^&*)
- Not be a common word or phrase
- Not include your name or email
Password Tips
| Do | Don’t |
|---|---|
| Use a unique password | Reuse passwords from other sites |
| Use a password manager | Write passwords on paper |
| Change regularly | Share your password |
| Log out when done | Use obvious info (birthday, name) |
Forgot Your Password?
If you’re logged in and want to change your password:
- Use the Password settings
If you can’t log in:
- Use the “Forgot Password” link on the login page
- Check your email for the reset link
Two-Factor Authentication (2FA)
What is 2FA?
Two-Factor Authentication adds extra security by requiring:
- Something you know (your password)
- Something you have (your phone with authenticator app)
Even if someone gets your password, they can’t log in without your phone.
Setting Up 2FA
Step 1: Access 2FA Settings
- Go to Settings → Two-Factor Authentication (or Security)
- Click Enable or Set Up 2FA
Step 2: Install an Authenticator App
If you don’t have one, download:
- Google Authenticator (iOS/Android)
- Microsoft Authenticator (iOS/Android)
- Authy (iOS/Android/Desktop)
Step 3: Scan the QR Code
- Open your authenticator app
- Choose Add Account or tap the + button
- Select Scan QR Code
- Point your camera at the QR code shown in C-Tax
- The app will add C-Tax to your accounts
Step 4: Verify the Code
- Your authenticator app shows a 6-digit code
- Enter this code in C-Tax
- Click Verify or Enable
Step 5: Save Recovery Codes
C-Tax will show recovery codes. Save these safely!
- Write them down
- Store in a secure location
- These codes let you log in if you lose your phone
Using 2FA to Log In
After setup:
- Enter your email and password
- Open your authenticator app
- Find the C-Tax entry
- Enter the 6-digit code shown
- Click Verify
The code changes every 30 seconds, so enter it promptly.
If You Lose Your Phone
Use your recovery codes to log in:
- On the 2FA screen, look for “Use Recovery Code”
- Enter one of your saved recovery codes
- Log in successfully
- Set up 2FA again with your new phone
If you don’t have recovery codes:
- Contact your system administrator
- They can reset your 2FA
Disabling 2FA
If you need to turn off 2FA:
- Go to Settings → Two-Factor Authentication
- Click Disable
- Confirm with your password or current code
- 2FA is now off
Note: Your administrator may require 2FA, preventing you from disabling it.
Appearance Settings
Theme Options
C-Tax may offer different visual themes:
| Theme | Description |
|---|---|
| Light | White background, dark text |
| Dark | Dark background, light text |
| System | Matches your device settings |
Changing the Theme
- Go to Settings → Appearance
- Select your preferred theme
- The change applies immediately
Why Use Dark Mode?
- Easier on eyes in low light
- May reduce eye strain
- Saves battery on some devices
Account Security Best Practices
Protect Your Account
| Practice | Why |
|---|---|
| Use strong passwords | Prevents guessing |
| Enable 2FA | Adds extra protection |
| Log out when done | Prevents unauthorized access |
| Don’t share credentials | Only you should access your account |
Recognize Security Threats
Watch out for:
- Emails asking for your password (phishing)
- Unusual login notifications
- Changes you didn’t make
- Unfamiliar transactions
If you notice something suspicious:
- Change your password immediately
- Review recent activity
- Contact your administrator
- Enable 2FA if not already active
Deleting Your Account
If available, account deletion:
- Go to Settings → Delete Account (or similar)
- Read the warnings carefully
- This is usually permanent
- Enter password to confirm
- Your account is removed
Note: Most users cannot delete their own accounts. Contact your administrator if you need your account removed.
API Integration (For Owners and Admins)
If your business uses external systems that need to connect to C-Tax, you can manage API keys through the Integration page.
Note: This section is only available to users with Owner or Admin roles.
Accessing API Integration
- Click Integration in the sidebar menu
- You’ll see the API Integration page with your API keys
Understanding API Keys
C-Tax provides two types of API keys:
| Key Type | Purpose | KRA Submission |
|---|---|---|
| Live API Key | Production transactions | Yes - sent to KRA |
| Sandbox API Key | Testing and development | No - not sent to KRA |
Managing Your API Keys
Viewing API Keys
- Your API keys are partially hidden by default for security
- Click the shield icon next to a key to show/hide the full key
- Keys are displayed as:
ctax_live_xxxx...orctax_sandbox_xxxx...
Copying an API Key
- Click the copy icon next to the key you want to copy
- The key is copied to your clipboard
- A checkmark appears to confirm the copy was successful
Regenerating an API Key
If you need to create a new API key (for example, if the old one was compromised):
- Click the “Regenerate” button next to the key
- Read the warning carefully:
- The old key will stop working immediately
- Any applications using the old key will lose access
- This action cannot be undone
- Click “Regenerate Key” to confirm
- Your new key will be displayed
Warning: Be very careful when regenerating a Live API Key as it will immediately break any production integrations.
Quick Start Guide
The Integration page includes a Quick Start Guide showing:
| Information | Description |
|---|---|
| API Base URL | The URL your applications should use to connect |
| Example Request | A sample curl command showing how to make API calls |
| Available Endpoints | List of API endpoints (sales, purchases, items) |
| Full Documentation | Link to complete API documentation |
API Security Best Practices
| Do | Don’t |
|---|---|
| Keep API keys secure and private | Share API keys publicly |
| Use Sandbox key for testing | Use Live key for development |
| Regenerate if key is compromised | Ignore potential security breaches |
| Store keys in environment variables | Hard-code keys in your application |
Settings FAQ
Can I change my email address?
Usually yes, through Profile settings. You may need to verify the new email.
Can I change my username?
If C-Tax uses usernames, check Profile settings. Otherwise, your email is your username.
Why can’t I change certain settings?
Some settings are controlled by administrators:
- Your role
- Branch assignment
- 2FA requirements
How do I get more access?
Contact your administrator to request role changes or additional permissions.
Is my data secure?
C-Tax uses encryption and security measures. Your password is never stored in plain text.
Next: Check out Troubleshooting & FAQ for help with common issues