Online Payments (Connecting Mobile Money)

> Read this first — in plain words.

> This page lets parents pay school fees from their phone using Mobile Money (Orange Money, Airtel Money, M-Pesa). To make this work, your school signs up with a payment company (we support PawaPay, CinetPay, or Flutterwave), copies a few secret codes from them, and pastes those codes into Digitex. Once done, every time a parent pays, the invoice is marked Paid by itself — no manual work for your accountant. You only set this up once.

How it works (the big picture)

Think of the payment company as a cashier standing between the parent and your school:

• The parent clicks the pay link and chooses Mobile Money.
• The payment company asks the parent to confirm on their phone.
• The parent enters their PIN and the money is collected.
• The payment company tells Digitex "this is paid", and the invoice turns green automatically.

You don't need to understand the technical details — you just need to connect the two by copying codes. Follow the steps below for whichever company you choose.

Which company should I pick?

You only need one. Pick based on what suits your school:

> Tip: If unsure, start with PawaPay. It is the simplest for parents.

What you need before you start

• A registered account with one payment company (free to sign up — links below).
• The secret codes they give you (called "API keys" — think of them as your shop's password).
• Around 15 minutes, once.

Always test first ("Sandbox" vs "Production")

Every company gives you two modes:

• Sandbox / Test = a practice mode using fake money. Use this first to make sure everything works.
• Production / Live = real mode that collects real money. Switch to this only after your test succeeds.

You will see this choice as Environment on the Payment Methods page. Start on Sandbox, test with a small invoice, then change to Production.

Step 1 — Set up in Digitex (same for all companies)

• Go to Configuration → Payment Methods.
• Scroll to the section Payment Gateway (DRC).
• Choose your Provider (PawaPay, CinetPay, or Flutterwave).
• Set Environment to Sandbox for now.
• Paste the secret codes from your chosen company (see Step 2 for where to find them).
• Turn Online payments ON and tick the Mobile Money options you want (Orange, Airtel, etc.).
• Click Save.

There is also a box on this page showing Webhook URLs. A "webhook" is simply the return message the payment company sends back to tell Digitex a payment succeeded. You will copy these URLs into the payment company's website in Step 2 — that's what makes invoices update automatically.

Your webhook URLs (replace YOUR-DOMAIN.com with your real website address, e.g. e-digitex.com):

https://YOUR-DOMAIN.com/webhooks/payments/pawapay
https://YOUR-DOMAIN.com/webhooks/payments/cinetpay
https://YOUR-DOMAIN.com/webhooks/payments/flutterwave

> In short: Digitex needs the company's secret codes, and the company needs Digitex's webhook URL. You are just introducing them to each other.

Step 2 — Get your codes from the payment company

Pick the section for the company you chose.

Option A — PawaPay (recommended)

• Create a free account at https://dashboard.pawapay.io (for live) or https://dashboard.sandbox.pawapay.io (for testing).
• Fill in your school details (name, contact, bank info) so they can approve you.
• In their menu, open Settings → API and copy the API Token (a long secret code). Keep it private — never share it.
• Back in Digitex (Payment Methods), paste it into PawaPay API Token and Save.
• In PawaPay, open Webhooks, click Add, and paste your PawaPay webhook URL from Digitex. Choose the events Deposit completed and Deposit failed.

That's it. PawaPay automatically knows which network to use (Orange, Airtel, or M-Pesa) based on the parent's phone number.

Their help docs: https://docs.pawapay.io

Option B — CinetPay

• Create an account at https://cinetpay.com and verify it.
• Find the integration settings and copy two codes: the Site ID and the API Key.
• In Digitex, paste them into CinetPay Site ID and CinetPay API Key, then Save.
• In CinetPay, go to Notifications / Webhook and paste your CinetPay webhook URL from Digitex.

Their help docs: https://docs.cinetpay.com

Option C — Flutterwave

• Create an account at https://dashboard.flutterwave.com and verify your business.
• Copy the Public Key and the Secret Key (and Encryption Key if shown).
• In Digitex, paste the Secret Key and Public Key, then Save.
• In Flutterwave, go to Settings → Webhooks, add your Flutterwave webhook URL from Digitex, and turn on the payment success event (often called charge.completed).

Their help docs: https://developer.flutterwave.com/docs

Step 3 — Test it, then go live

• Create a small test invoice (e.g. 100 CDF).
• Open its pay link and choose Pay instantly.
• Complete the payment using the company's test instructions (Sandbox mode).
• Check that the invoice turns to Paid by itself within a few seconds.
• When the test works: return to Payment Methods, change Environment to Production, paste your live secret codes, and update the webhook URL on the company's live dashboard.
• Do one final test with a small real payment.

You're done — parents can now pay from their phones.

If something goes wrong

Need more help?

Simple, picture-by-picture guides (no login needed) are online at: https://e-digitex.com/help