INTRODUCTION


GENERATION OF 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.

CREATING A FICTITIOUS CUSTOMER ACCOUNT

A fictitious account or test account allows you to simulate payments during your integration tests with our APIs. You can specify the name, email address, and balance of the dummy customer. PayDunya removes from the fictitious customer balance the amount of the test invoices when payments are made.

  Trick


Note that you have the option of creating multiple fictitious accounts and reloading them manually at any time.

  Alert


It is strongly recommended to conduct payment tests before going into production mode.

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

  • Then click on the tab Fictitious customers and follow the configuration steps.

FICTITIOUS INTERNAL DATA


This is a debugging tool that allows you to see the information transmitted to our server when you perform your payment tests. To access this data:

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

  • Click on the tab Fictitious internal data in order to have the list of internal data of the test payments.

  • Click on the link details located to the right of each internal data present at the list level for more information.

PRODUCTION TRANSITION


  • You first have to Login to your account and click on oneAPI at the menu level on the left.
  • Under the tab Applications, click on the link Details the application concerned.
  • Scroll down and click on the button Update the configuration.
  • Choose Yes, the application is ready at the option level Enable production mode the update form.

  • Remember to replace the test API keys with the production ones in your application.
  • Specify the mode live at the client API level.

IPN

This is "Instant Payment Notification (IPN)" or Instant Payment Notification. This service sends the set of expected response data on an endpoint (URL to a file on your server) that you declare in order to handle this data in the backoffice. It is very useful for confirming payments that are not made not instantly because of latency servers or the mobile network or the Internet or to because of the time the customer has to confirm payment on their phone. Anyway the IPN allows you to ensure that the status of a payment is confirmed by our servers

AppDunya

It is a set of keys that identify and authenticate your website or mobile application when connecting to PayDunya's servers. CREATE AN AppDunya for each of your websites or application at the dashboard level of your PayDunya account.

Technical Support

  • For any information, please contact us at : +221 77 190 26 41 or send us an email at paydunya@paydunya.com.

  • For any assistance request for integration of our APIs please contact us at: +221 77 807 91 49 or send us an email at dev@paydunya.com. A support team will be at your disposal to answer all your requests.