Quick Setup

Installation Guide

Get up and running in less than 5 minutes with our simple step-by-step guide

Estimated time: 3-5 minutes

Before You Begin

Active WHMCS installation (Latest version)
bKash merchant account with API credentials
FTP or file manager access to your server
Admin access to your WHMCS panel
01
File Upload

Upload the Module File

Upload the following files and folders to your WHMCS installation directory:

File Location
/modules/gateways/
├── bkash.php
├── bkash/
│   ├── logo
│   ├── whmcs.json
└── callback/
    └── bkash.php
Use FTP, cPanel File Manager, or your preferred file transfer method.
02
Activation

Activate the Gateway

Navigate to your WHMCS admin panel and activate the bKash module:

1 Go to Setup → System Settings → Payment Gateways
2 Find bKash in the list of available gateways
3 Click to configure gateways
03
Configuration

API Credential Setup

Enter your bKash merchant credentials in the module settings:

Username
Your bKash merchant account username
Password
Your bKash merchant account password
App Key
Your bKash App Key
App Secret
Your bKash App Secret
Gateway Fee
Enter the fee percentage or fixed amount (e.g, 1.85)
Sandbox Mode
Enable for testing, disable for live production
Keep your credentials secure. Never share them publicly.
04
Testing

Test the Integration

Verify everything is working correctly:

Make a test payment through your WHMCS client area
Verify payment status updates automatically
Check invoice gets marked as paid
Review transaction logs for any errors
All Set!

Your bKash payment gateway is now live and ready to accept payments.

Need Help?

If you encounter any issues during installation, our support team is here to help you get everything up and running smoothly.