WalleoPay WalleoPay
EN
My account
Sign in Open an account Forgotten password Documentation

Opening an account is free. Your test keys are available straight away.

Features

Everything you need to collect, track and withdraw your money.

WalleoPay brings MTN MoMo and Orange Money together behind a single integration. You connect your shop once; we handle the operator calls, the transaction states and the accounting that goes with them.

Collection

The two wallets your customers already use

Your customer enters their number, nothing else. We read the prefix, we know whether it is an MTN MoMo or an Orange Money account, and we send the request to the right operator. No drop-down list to fill in, no wrong choice to put right.

Operator detection

The number prefix is enough. The ranges are configured on the server side and are updated without you touching your code.

Direct payment request

The customer receives the PIN prompt on their phone and approves it with their secret Mobile Money PIN. Nothing to install.

Payment by merchant code

When the direct request does not go through, the customer can pay to the merchant code from their USSD menu, then submit their reference: the payment moves into the confirmation queue.

Real-time tracking

We poll the operator every few seconds for as long as the payment is in progress, instead of waiting for a callback that can get lost.

Explicit transaction states

Pending, processing, awaiting confirmation, succeeded, failed, cancelled, expired. Every failure carries a code and a readable message.

Amounts in whole francs

The CFA franc has no cents and we do not pretend otherwise: amounts travel as integers, with no floating-point rounding.

Checkout page

A ready-made page, designed for the phone

You create a payment, you get back a URL, you send your customer to it. The page shows the amount, your shop name and the order reference. It fits on an entry-level phone screen and stays usable on a slow connection: no heavy fonts, no external scripts.

  • One URL per payment, valid for 30 minutes.
  • A waiting screen that follows the payment state without the customer refreshing.
  • Automatic return to your site once the operation is finished.
  • A new attempt is possible after a failure, without recreating the order.
WalleoPay WalleoPay
Secure

Amount to pay

7,500 FCFA

My Shop · Order B-2291

Your Mobile Money number

MTN 6 70 00 00 01 Detected
Pay 7,500 FCFA
A PIN prompt will appear on your phone. Approve it with your secret code to complete the payment.

For developers

A REST API, and webhooks that keep trying

The mode of a call comes from the key used, never from a parameter: you cannot send a real payment while believing you are running a test.

Test and live keys

Every account gets a pair of test keys and a pair of live keys as soon as it is created. The secret is shown only once: we keep nothing but a hash of it. A compromised key can be rolled from the dashboard, without opening a ticket.

  • Named keys: one pair per site or per application.
  • Immediate revocation and renewal.
  • Last-used date visible, so you can spot a forgotten key.

Signed webhooks, retried

At every state change, we call your server with the full payment. The X-WalleoPay-Signature header carries an HMAC signature computed over the timestamp and the body, which lets you reject a forged or replayed call.

  • Up to 8 attempts, spaced further and further apart, if your server does not answer.
  • A delivery log: body, HTTP code, response received.
  • Manual resend of a notification from the dashboard.

Stable JSON responses

An immutable payment identifier, fields that do not change name from one version to the next, typed errors.

Idempotency key

Replay a creation call after a network drop: you get back the original payment, not a duplicate.

On-demand verification

A call on the payment returns its real state at the operator. That response is the one that counts before you deliver.

Today

Live

Collected

184,000 FCFA

Successful payments

23

Success rate

88 %

MTN

B-2291

MTN MoMo

7,500 FCFA
OM

B-2290

Orange Money

25,000 FCFA
MTN

B-2289

MTN MoMo

3,000 FCFA
OM

B-2288

Orange Money

12,000 FCFA

Layout preview. The figures shown are for illustration.

Dashboard

Your takings, readable without a spreadsheet

The dashboard shows what you have collected, what is still in progress and what failed, with the reason. Every payment has its own record: amount, fee, net amount, operator, your order reference and the full timeline of events, from creation to the notification sent to your server.

Statistics

Volumes collected, number of transactions and success rate, in test mode as well as live.

Accounting ledger

Every movement is written to a ledger: collection, fee, payout. Your balance is never a figure that came out of nowhere.

Timeline per transaction

The sequence of a payment's states, timestamped, with the operator's response — enough to answer a customer without writing to us.

Accounting export

The operations ledger exports to CSV from the dashboard, accents included, ready to open in a spreadsheet. The API also lets you pull your transactions by date range.

Your money, your team

What happens after the money comes in

The money you collect builds up a balance at WalleoPay. You decide when the payout goes out, and to which number.

Mobile Money payout

Request a payout to your MTN MoMo or Orange Money number from the dashboard. Minimum 1,000 FCFA, fees shown before you confirm.

Available and pending balance

The available balance can be paid out right away. The pending balance covers payments that are still settling.

Several users

Add your colleagues to the shop account. Each one has their own credentials: nobody shares a password, and an employee leaving does not force you to change everything.

Several sites, one account

One key pair per shop or per application, with its own name and its own callback URL. You can see where each payment comes from without mixing them up.

A complete test mode

Dedicated numbers trigger, at will, a success, an insufficient balance, a refusal from the customer or no answer at all. You test your error cases before opening the shop.

Controls on the platform side

Amounts bounded between 100 FCFA and 1,000,000 FCFA, API secrets stored hashed, access logging.

Test mode

Integrate before you are approved

Your test keys work from the moment the account is created. Payments follow exactly the same path as in live — creation, checkout page, waiting, webhook, timeline — but not a single franc moves. The number used decides the outcome, which lets you check your error handling as seriously as your happy path.

Run a test payment

A few test numbers

699 000 001 Payment successful
699 000 002 Insufficient balance
699 000 003 Customer declines the request
699 000 004 PIN not entered in time

The full list, including MTN numbers, is in the documentation.

Try it before you commit

Creating the account and the test keys cost nothing. You only pay on payments that actually go through, at 3 % per successful transaction.