Skip to main content

2. Create your application

Create and configure your first application directly from the dashboard.

1
General information
  1. Log in to your dashboard and go to the Applications section.

  2. A "Your first application" dialog will appear. (You can also create applications later from the applications section.) In the form, provide the following general information:

    • Application name – The public name displayed to customers.
    • Notification email – The email address that receives a confirmation for every payment.
    • Activity area – Defaults to your organization's activity; you can adjust it for this specific application.
    • Application logo (optional) – Upload an image that will appear in the payment experience.
    • Environment:
      • Sandbox: No real transaction is performed on the customer's account.
      • Production: Real payment; real debit on the customer's account.

    You can switch this toggle later as needed.

  3. Save the application. A new Developer tab appears. Open it to copy your API key. Store it securely – never share it or expose it in frontend code.

You can generate additional API keys later from the application settings.

2
Configure payment methods

In your application's settings, open the Payment methods tab to enable the providers you want to offer.

Available providers:

  • MVola
  • Orange Money
  • Airtel Money
  • BRED (Visa)

For each provider, you must decide how funds are received:

  • Use your own merchant account (Dans mon compte)
    Select this if you already have a direct contract with the provider.
    Enter the credentials provided by the operator for both Sandbox and Production environments:

    ProviderRequired credentials
    MVolaMerchant Key, Merchant Phone Number
    Orange MoneyClient ID, Password, Merchant Key
    Airtel MoneyClient ID, Client Secret
    BREDMerchant ID, Merchant Key ID, Merchant Secret Key
  • Use the Papi account (Passer via Papi)
    If you do not yet have your own merchant accounts, Papi acts as a technical and financial intermediary. Payments are collected on your behalf, allowing you to go live quickly without waiting for each provider's individual approval.

Enable the providers you need and fill in the required information. Save your changes.

tip
  • Always test thoroughly in Sandbox mode before switching to Production.
  • Keep your API key and any payment provider credentials confidential. Never hard‑code them in publicly accessible code.
Own merchant account

A simple mobile money number or simple bank account is not enough. You need a real merchant account with the operators. Request one from their operations team; they will then provide you with the required credentials.