WHMCS

Read all the blue sections to better understand the documentation and the orange sections signifying the alert so avoid mistakes to be made during integrations and detailed integration procedures.

GENERATE YOUR API KEYS

API keys are your digital references towards PayDunya systems. We use them to identify your account and the applications you will create. These keys are necessary for any integration of the APIs of PayDunya's payments APIs. Here are the steps to follow:

  • First you need have a PayDunya Business account activated. Create one if it is not yet the case.

  • Login to your account and click on oneAPI at the menu level on the left.

  • Click on the button Set up a new application and fill out the form.

  • Choose Test mode, I want to make payment tests and Enable production mode.

THE PAYMENT GATEWAY PAYDUNYA ON WHMCS

Manual installation

Mandatory


  • download our PayDunya WHMCS modulehere

  • Extract the contents of the downloaded file.

  • Copy the file paydunyagatewaymodule.php in the file /modules/gateways/ your WHMCS platform, then copy the files in the callback folder to the folder level
    /modules/gateways/callback/ of your WHMCS platform.

1 - Configuration of BCEAO XOF currency (FCFA)

To configure the BCEAO XOF currency (FCFA), in the WHMCS administration interface, click Setup > Payments > Currencies. Then create the currency XOF(FCFA) and set his exchange rate.

2 - Currency Setup Options:

  • Currency Code: Enter the ISO code of the currency (XOF).
  • Prefix: Enter the symbol that will precede the amount (FCFA).
  • Suffix: Enter the symbol that will appear to the right of the amount (XOF).
  • Format: Choose a format for the currency.
  • Base Conv. Rate: Enter the current exchange rate of the currency against the main currency.
  • Update Pricing: Used to update prices based on the exchange rate.
  • Click on Save Changes ayour changes are taken into account.

PLUGIN CONFIGURATION

  • Activate the PayDunya payment module atSetup > Payments > Payment Gateways. Click on All Payment Gateways, look for PayDunya and click on it.

  • Login on PayDunya and retrieve the API keys by clicking at the level of Intégration API then on Details of your application.

  • Return to the WHMCS administration interface and fill in the required PayDunya plugin configuration fields.

The Configuration Options are as follows:

  • Show on Order form: Check / uncheck this box to enable/disable the PayDunya payment module.

  • Master Key: Enter the Primary Key provided by PayDunya when creating your application.

  • Live Private Key: Enter the Private Production Key provided by PayDunya when creating your application.

  • Live Token:Enter the production Token provided by PayDunya when creating your application.

  • Test Private Key: Enter the Private Test Key provided by PayDunya when creating your application.

  • Test Token: Enter the test Token provided by PayDunya when creating your application.

  • Sandbox Mode: Check this box if you are still in the test payment stage. Remember to uncheck it once you are ready to accept real payments.

  • Convert To for Processing: Select the XOF currency.

  • Click on Save Changes so that your changes are taken into account.