App Settings
Configure your application settings in the Bila Console
App Settings
The Settings section in the Bila Console allows you to configure various aspects of your account and application, including business information, API keys, webhooks, security settings, and more.
Accessing Settings
To access the Settings section:
- Log in to the Bila Console
- Click on Settings in the main navigation menu on the left side
Settings Section in Bila Console
Settings Dashboard
The Settings dashboard provides access to all configuration options:
Settings Dashboard
The Settings section is organized into several categories:
- Account Settings: Manage your personal account information
- Business Settings: Configure your business profile and verification
- API Settings: Manage API keys and webhooks
- Payment Settings: Configure payment methods and checkout options
- Security Settings: Set up security features and access controls
- Notification Settings: Configure alerts and communication preferences
- Team Management: Invite and manage team members
Account Settings
Manage your personal account information and preferences:
Account Settings
Personal Information
Access Personal Information
Click on “Account Settings” in the Settings menu, then select the “Personal Information” tab.
Update Profile
Update your personal details:
- Full name
- Email address
- Phone number
- Profile picture
Personal Information
Change Password
Click the “Change Password” button to update your account password.
Change Password
Save Changes
Click “Save Changes” to update your personal information.
Account Preferences
Access Preferences
Click on the “Preferences” tab in Account Settings.
Configure Interface Settings
Customize your console experience:
- Language preference
- Time zone
- Date format
- Default currency
- Theme (light/dark mode)
Interface Preferences
Save Preferences
Click “Save Preferences” to apply your changes.
Business Settings
Configure your business profile and verification details:
Business Settings
Business Profile
Access Business Profile
Click on “Business Settings” in the Settings menu, then select the “Business Profile” tab.
Update Business Information
Configure your business details:
- Business name
- Business type/industry
- Registration number
- Tax ID
- Business address
- Website URL
- Support contact information
Business Information
Upload Business Logo
Upload your business logo, which will appear on payment pages and receipts.
Business Logo
Save Changes
Click “Save Changes” to update your business profile.
KYB Verification
Access KYB Verification
Click on the “Verification” tab in Business Settings.
Submit Verification Documents
Upload required documents for Know Your Business (KYB) verification:
- Business registration certificate
- Proof of business address
- Director identification
- Beneficial owner information
KYB Verification
Track Verification Status
Monitor the status of your verification process.
Verification Status
KYB verification is required for production accounts. Your business must be fully verified before you can process live transactions.
API Settings
Manage your API keys, webhooks, and integration settings:
API Settings
API Keys
Access API Keys
Click on “API Settings” in the Settings menu, then select the “API Keys” tab.
View Existing Keys
See a list of your existing API keys, including their type (test/live) and status.
API Keys List
Generate New API Key
Click “Generate New API Key” and select the key type:
- Test Public Key
- Test Secret Key
- Live Public Key
- Live Secret Key
Generate API Key
Set Key Permissions
Configure permissions for the API key:
- Read-only access
- Write access
- Specific endpoint restrictions
Copy and Secure Key
Copy your new API key and store it securely. For security reasons, you won’t be able to view the full key again.
Copy API Key
Keep your API keys secure. Never share your secret keys or include them in client-side code. If a key is compromised, revoke it immediately and generate a new one.
Webhooks
Access Webhooks
Click on the “Webhooks” tab in API Settings.
View Existing Webhooks
See a list of your configured webhook endpoints.
Webhooks List
Add New Webhook
Click “Add Webhook” and configure your webhook endpoint:
- Endpoint URL
- Description
- Secret key for signature verification
- Event types to subscribe to
Add Webhook
Test Webhook
Click “Test” to send a test event to your webhook endpoint.
Test Webhook
View Webhook Logs
Click “View Logs” to see the delivery history and response status for each webhook.
Webhook Logs
Redirect URLs
Access Redirect URLs
Click on the “Redirect URLs” tab in API Settings.
Configure Redirect URLs
Set up the URLs where customers will be redirected after completing a payment:
- Success URL: Where customers are sent after a successful payment
- Failure URL: Where customers are sent after a failed payment
- Cancel URL: Where customers are sent if they cancel a payment
Redirect URLs
Save URLs
Click “Save URLs” to update your redirect settings.
All redirect URLs must use HTTPS for security reasons. URLs with HTTP will be rejected.
Payment Settings
Configure payment methods, checkout experience, and transaction rules:
Payment Settings
Payment Methods
Access Payment Methods
Click on “Payment Settings” in the Settings menu, then select the “Payment Methods” tab.
Configure Available Methods
Enable or disable payment methods for your customers:
- Card payments (Visa, Mastercard, etc.)
- Mobile money providers
- Bank transfers
- Cryptocurrency options
Payment Methods Configuration
Set Processing Priority
Drag and drop payment methods to set the order in which they appear to customers.
Configure Method-Specific Settings
Click on each payment method to configure specific settings:
- Processing fees
- Minimum/maximum transaction amounts
- Geographic availability
Save Changes
Click “Save Changes” to update your payment method settings.
Checkout Experience
Access Checkout Settings
Click on the “Checkout” tab in Payment Settings.
Customize Appearance
Configure the look and feel of your checkout page:
- Brand colors
- Logo placement
- Button styles
- Custom CSS (if enabled)
Checkout Appearance
Configure Customer Fields
Select which customer information to collect during checkout:
- Required fields (name, email, etc.)
- Optional fields (phone, address, etc.)
- Custom fields
Customer Fields
Set Up Receipt Templates
Customize the email receipts sent to customers after payment:
- Email subject
- Receipt content
- Branding elements
Receipt Templates
Save Changes
Click “Save Changes” to update your checkout settings.
Security Settings
Configure security features and access controls:
Security Settings
Two-Factor Authentication
Access Security Settings
Click on “Security Settings” in the Settings menu, then select the “Two-Factor Authentication” tab.
Enable 2FA
Click “Enable Two-Factor Authentication” and follow the setup instructions:
- Scan QR code with authenticator app
- Enter verification code
- Save backup codes
Enable 2FA
Configure 2FA Requirements
Set when 2FA is required:
- Every login
- New device login only
- High-risk actions only (large transactions, settings changes)
IP Restrictions
Access IP Restrictions
Click on the “IP Restrictions” tab in Security Settings.
Enable IP Whitelisting
Toggle “Enable IP Whitelisting” to restrict API access to specific IP addresses.
IP Whitelisting
Add IP Addresses
Click “Add IP Address” and enter the IP addresses or CIDR ranges that should have access.
Save Changes
Click “Save Changes” to update your IP restrictions.
Be careful when configuring IP restrictions. If you restrict access to specific IPs and then try to access the API from an unlisted IP, your requests will be blocked.
Notification Settings
Configure alerts and communication preferences:
Notification Settings
Email Notifications
Access Notification Settings
Click on “Notification Settings” in the Settings menu, then select the “Email Notifications” tab.
Configure Email Preferences
Select which events trigger email notifications:
- Transaction notifications
- Account alerts
- Security alerts
- System updates
Email Notification Preferences
Add Recipients
Add additional email addresses to receive notifications:
- Enter email address
- Select notification types for each recipient
Notification Recipients
Save Changes
Click “Save Changes” to update your email notification settings.
SMS Notifications
Access SMS Notifications
Click on the “SMS Notifications” tab in Notification Settings.
Configure SMS Preferences
Select which events trigger SMS notifications:
- High-value transactions
- Failed transactions
- Security alerts
SMS Notification Preferences
Add Phone Numbers
Add phone numbers to receive SMS notifications.
Save Changes
Click “Save Changes” to update your SMS notification settings.
Team Management
Invite and manage team members with different access levels:
Team Management
Team Members
Access Team Management
Click on “Team Management” in the Settings menu.
View Team Members
See a list of current team members and their roles.
Team Members List
Invite New Member
Click “Invite Team Member” and provide:
- Email address
- Name
- Role/permissions
Invite Team Member
Manage Permissions
Click on a team member to edit their permissions:
- Admin: Full access to all features
- Manager: Access to most features except critical settings
- Analyst: View-only access to data and reports
- Developer: Access to API keys and technical settings
Team Member Permissions
Remove Team Member
Click the “Remove” button next to a team member to revoke their access.
Be careful when assigning admin permissions. Admins have full access to all settings, including API keys and payment configurations.