WHMCS Pesapal Plugin
Please follow the instructions below to setup the PesaPal gateway module.
Note
- The PesaPal gateway module requires the use of modified templates that are provided with this distribution.
- The templates provided are based on WHMCS 7.1.X and the default theme.
STEP 1: INSTALL THE WHMCS PLUGIN
- Upload pesapal.php and the pesapal folder to your whmcs's modules/gateways folder.
- Upload the callback/pesapal.php file to your whmcs's modules/gateways/callback folder.
- Upload templates/pesapal_callback.tpl and templates/pesapal_iframe.tpl to your template directory. This usually under : templates/six/
- Enable the PesaPal module in the WHMCS admin area by going to Setup->Payments->Payment Gateways and paste in your administrator username, Consumer Key and Consumer Secret.
- Enter your base domain url (include the trailing slash) e.g https://mywebsite.com/ . If this setting is ignored, the module will automatically use your systemURL.
- Get your consumer Key and Consumer Secret, by opening a business account on www.pesapal.com or demo.pesapal.com(Sandbox Application).
- If you opened an account on www.pesapal.com(live account), the key and secret have been sent to the email address you registered with.
- If you opened an account on demo.pesapal.com, login and check on your dashboard(check at the bottom of the page)
- Ensure when you are done testing the plugin using the demo/sandbox account you switch to the live API.
- Save configurations.
NB:// Do not change display name in the configuration
STEP 2: PESAPAL IPN SETUP
The IPN (instant payment Notification) mechanism enables payments to update in your platform in real-time once a customer's payment has been confirmed. to set it up, kindly follow the following procedure.
- Login to your PesaPal Merchant/business account
- Click Account settings
- Select IPN settings
- On add IPN URL form add the following details
- Website Domain: eg. www.mysite.com
- Website IPN Listener Url: http://[website domain]/modules/gateways/pesapal/ipn.php eg http://www.mysite.com/modules/gateways/pesapal/ipn.php
If you have any questions, recommendations or need installation assistance, please post in our forum here