Please follow the instructions below to setup the PesaPal gateway module.


  1. The PesaPal gateway module requires the use of modified templates that are provided with this distribution.
  2. The templates provided are based on WHMCS 7.1.X and the default theme.


  1. Upload pesapal.php and the pesapal folder to your whmcs's modules/gateways folder.
  2. Upload the callback/pesapal.php file to your whmcs's modules/gateways/callback folder.
  3. Upload templates/pesapal_callback.tpl and templates/pesapal_iframe.tpl to your template directory. This usually under : templates/six/
  4. Enable the PesaPal module in the WHMCS admin area by going to Apps & Integrations->Payments Apps->View All->Under Additional Apps click on pesapal to activate then manage. Paste in your administrator username, Consumer Key and Consumer Secret.
  5. Enter your base domain url (include the trailing slash) e.g . If this setting is ignored, the module will automatically use your systemURL.
  6. To get your consumer Key and Consumer Secret, Open a Pesapal business account on or Pesapal test credentials.
    • If you opened an account on account), the key and secret have been sent to the email address you registered with.
    • Find Pesapal test credentials here,
    • Ensure when you are done testing the plugin using the demo/sandbox account you switch to the live API.
  7. Save configurations.

NB:// Do not change display name in the configuration


The IPN (instant payment Notification) mechanism enables payments to update in your platform in real-time once a customer's payment has been confirmed. The process was automated in this release.You need not to do anything

    If you have any questions, recommendations or need installation assistance, please post in our forum here

    Is this article helpful?