Digitex Digitex Documentation

PawaPay Setup — API Keys & Webhooks (DRC)

PawaPay is the recommended gateway for direct Mobile Money in the DRC (Orange, Airtel, Vodacom M-Pesa).

Step 1 — Create a PawaPay merchant account

  • Go to https://dashboard.pawapay.io (production) or https://dashboard.sandbox.pawapay.io (testing).
  • Click Sign up / Register as merchant.
  • Complete business verification (school name, contact, bank details).
  • Wait for account approval from PawaPay.

Step 2 — Get your API token

  • Log in to the PawaPay dashboard.
  • Open Settings → API or Developers.
  • Copy your Bearer API Token (long secret string).
  • Never share this token publicly — treat it like a password.

Step 3 — Configure in Digitex SMS

  • Log in to https://e-digitex.com
  • Switch to your school (building icon, top-right).
  • Go to Finance → Fees & Collection → Payment Methods.
  • Scroll to Payment Gateway (DRC).
  • Set:

- Provider: PawaPay

- Environment: Sandbox (for testing)

- PawaPay API Token: paste your token

  • Enable Online payment links.
  • Enable payment methods: Orange Money, Airtel Money, M-Pesa/Vodacom.
  • Click Save settings.

Step 4 — Register webhook URL

  • On the Payment Methods page, copy:

`

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

`

  • In PawaPay dashboard → Webhooks / Callbacks.
  • Add URL above, events: Deposit completed, Deposit failed.
  • Save.

Step 5 — Test a payment

  • Create a test invoice for a student.
  • Open invoice → copy Online Payment Link.
  • Open link in phone browser (use Sandbox test numbers from PawaPay docs).
  • Choose Pay instantly → Orange Money → enter test phone.
  • Confirm PIN on phone (sandbox).
  • Invoice should show Paid within seconds.

DRC provider codes (automatic)

Digitex maps your payment methods to PawaPay:

Method in Digitex PawaPay provider
Orange Money ORANGE_COD
Airtel Money AIRTEL_COD
M-Pesa / Vodacom VODACOM_MPESA_COD

Go live (Production)

  • Complete PawaPay production KYC.
  • Get production API token.
  • In Digitex Payment Methods → Environment: Production.
  • Paste production token.
  • Update webhook URL on production PawaPay dashboard.
  • Test with a small real payment (e.g. 100 CDF).

Troubleshooting

Problem Solution
Payment stays pending Check webhook URL is reachable (HTTPS required)
Invalid token error Regenerate token in PawaPay; re-save in Digitex
Wrong operator Parent phone must match operator (243...)
Amount rejected CDF amounts for Vodacom must be whole numbers

Support: PawaPay docs — https://docs.pawapay.io

Back to Help
Web Manual Ask the community