Fawry for WHMCS documentation

Fawry for WHMCS is a full-featured gateway with the ability to accept payment by credit cards or at any Fawry POS using digital wallet or cash. Fawry’s solutions meet the highest global security standards, and are in full compliance with ISO 27001 and PCI DSS standards. Fawry is considered to be the best payment gateway in Egypt, it provides the best ewallet in Egypt myFawry.

Fawry for WHMCS will integrate seamlessly with WHMCS. The integration will allow WHMCS to communicate with Fawry payment gateway using API. Fawry for WHMCS redirects customers to a white label Fawry portal giving your customers the option to pay using Credit Card or at any Fawry POS by cash or mobile wallet. Once payment is made, Fawry will send notification using SMS, Email, and Callback. Once Fawry has received the payments, it will send a callback notification to WHMCS and activate the service automatically.

This knowledge base article will describe how to download and activate Fawry for WHMCS to start accepting payments through Fawry payment gateway.

1. You need to have an active Fawry for WHMCS license, you can get a license by buying the module from Greens247 website.
2. Access to the WHMCS admin dashboard as full administrator.
3. You need to obtain a Fawry API merchant code and secret key. If you do not have a merchant code and a secret key, contact customer support and an agent will be happy to assist you in activating your Fawry account and your Fawry account dasboard. You may need to send legal documents about your company, and sign a legal agreement.

1. Login to your account at Greens247.
2. Click on Services.
3. Click on Fawry, copy your license key. It begings with "FCO".
4. Click on Downloads and download the latest version of Fawry.
5. Copy the downloaded compressed file and upload it to your WHMCS root directory (the directory where WHMCS is installed).
6. Login to your WHMCS admin dashboard.
7. On the tabbed menu, Click Setup -> addon modules.
8. Find the Fawry module and click "Activate".
9. Once the module is activated, click on configure in order to input your license key. If you had copied it like instructed earlier, then just paste the license key.
10. Tick the box full administrator, or any other user group that you want to allow to view the license information.
11. View the license information, by going to the "addon" menu and click Fawry.
12. Once the page loads, click the "Force License Update".
13. If everything is ok, you will see the License Status as "Active". If you are having difficulty activating Fawry for WHMCS payment gateway module, please contact customer support and an agent will be happy to assist with troubleshooting and fixing the problem.
14. Assuming you have an "Active" License Status, on the tabbed menu click "Setup->Payments->Payment Gateways".
15. Click "All Payment Gateways" then find "Fawry", this will activate the Payment Gateway. It will now look for the license and activate it.
16. Choose a name to display to your customers, the default is "Fawry". You can change it to "Credit Card / Pay at Fawry" for example.
17. Type in your API merchant code, and secret key. If you do not have a merchant code and a secret key, contact customer support and an agent will be happy to assist you in activating your Fawry account and your Fawry account dashboard. You may need to send legal documents about your company, and sign a legal agreement.
18. If you have a test API account, you can input the test merchant code and secret key and tick the "Test Mode". This will send payments to the Fawry test account and dashboard. It is a simulated environment for you to test the implementation to make sure everything is perfect before going live.
19. Critical API communication between Fawry for WHMCS and the Fawry payment gateway are logged. You can view the log by clicking the following at the top tabbed menu "Billing->Gateway Log". Only critical information is logged. If you want detailed information for debugging and troubleshooting purpose you can enable debug mode by clicking on the tabbed menu click "Setup->Payments->Payment Gateways". Click "Manage Existing Gateways" find Fawry and ticking the "Debug Mode" checkbox.You have successfully enabled the Fawry addon module, and Fawry Payment Gateway for WHMCS.

Congratulations, you have successfully activated the Fawry module license and activated the Fawry payment gateway module for WHMCS.