1.5%per successful payment, rounded up to the franc. Default rate.
Accept payments in Senegal with one API, follow every franc on an exact ledger, and withdraw to Wave. Your AI agents can act too — within the limits you set.
Test accounts open without a call and can never move real money.
Or hand the integration to your AI agentIllustration: a customer pays 15,000 F with Wave; 14,775 F is credited in the ledger; a signed webhook is delivered; an AI agent makes a 5,000 F payout within its daily limit.
Senegal and the CFA franc (XOF) today. What each provider supports, with no hidden asterisk.
| Wave | Orange Money | |
|---|---|---|
| Collect on the hosted page | Available | Available |
| Subscriptions and instalments | Available | Available |
| Refund (in full) | Available | Not available |
| Withdraw your balance | Available | Planned |
| Payouts by an AI agent (live) | Available | Not available |
Test account
Opened with one request or from the site. No real money can move.
Integration
Payment, signed webhook, payout: test it all with a test wallet where you choose the outcome.
Verification
We verify your business, the owner's identity and your Wave settlement wallet.
Live
Swap the key and the API address. Make a first 100 F payment and watch the webhook arrive.
From test account to production, a coding agent (Claude Code, Cursor, Codex…) can do the integration almost on its own: the docs are machine-readable, the test account opens with one request, and every outcome can be simulated.
What your agent does
Example · what your agent sees
$ POST /v1/sandbox/signups
201 · test account created
secret_key: sk_test_51Qx8f2KjR7mW4tN9pLc3vZa
What stays human
Integrate Xaalis payments (Wave and Orange Money) into this project. First read https://docs.xaalis.org/llms.txt, open a test account with POST https://sandbox-api.xaalis.org/v1/sandbox/signups, then implement payment creation with an idempotency key, the signed webhook and end-to-end tests. Use no live keys.
A thousand years of West African money, in eight steps — and what we're building next.
Scroll: a thousand years of money, and what comes next
Gold — Bambouk, the Falémé valley. Its value: the metal.
Long before the year 1000, gold panned from the rivers of eastern Senegal crossed the Sahara by caravan. It made Ghana rich, then Mali.
1324 — Mansa Musa in Cairo. Its value: scarcity.
On his way to Mecca, the emperor of Mali spent so much gold in Cairo that its price there fell for about twelve years — or so al-Umari wrote. Too much gold, and gold is worth less.
Cowries — Markets of Mali, 14th century. Its value: everyone agrees.
For everyday trade, people counted in shells from the Indian Ocean. Worthless in themselves, accepted by the whole market. Ibn Battuta noted a rate: 1,150 cowries to one gold dinar.
1945 — The CFA franc is born. Its value: an issuer.
On 26 December 1945 the CFA franc was created. Money became state coins and banknotes, its value guaranteed by the issuer.
Cash — Decades of banknotes. Its limit: the paper trail.
Money had to be counted, carried and kept. It got lost, it got stolen, and when it changed hands only a receipt proved it.
Mobile — Wave, Orange Money. Its limit: separate books.
Today people pay with their phones. But Wave on one side, Orange Money on the other: for a merchant that's two accounts, two statements, two ways to check.
Xaalis — Dakar, today. Its value: proof.
One ledger for all your payments: every franc written on both sides, every notification signed, nothing counted twice. Money without weight is worth what its books are worth.
Tomorrow — From Dakar across West Africa. Our ambition.
The CFA franc is already shared by eight West African countries. From Dakar, we're building the infrastructure for money to move between their phones with the same proof — then across the continent.
Available, in testing or planned: every product shows its status, and nothing is presented as available before it is.
Available today
In testing, limited access
Planned, not available
Vision, no timeline
1.5%
per successful payment: the default rate to get paid, with no subscription. Successful payment, Wave or Orange Money, rounded up to the franc.
Minimum payment: 100 F CFA. Withdrawals to Orange Money: coming soon. When a payment is refunded, its original Xaalis fee is still due.
Exact for payments of this amount: 1.5% rounded up to the franc, payment by payment.
What happens when the network drops, when a webhook fails, or when two withdrawals leave at once.
Security best practicesamount: 15000
Amounts are integers end to end. Fees round up to the franc, once, the same way everywhere.
available − 14 775 → pending_payouts
A withdrawal locks the amount in the ledger before the provider is called, so two withdrawals can't spend the same money.
Idempotency-Key: order-1042
Replay the same request after a network drop and you get the same payment back — never a duplicate.
Xaalis-Signature: t=…,v1=5f2b…
Every notification is signed and timestamped. Your server checks the signature over the raw body and refuses anything older than 5 minutes.
sk_test_… → test:ledger
A test key goes through a mock provider and a separate ledger. It can't reach a real wallet.
sha256(sk_live_…)
We only keep a fingerprint of your API keys. Roll or revoke them from the dashboard at any time.
Our MCP server connects your AI assistant to your account. You pick the business, test or live mode, and exactly what the assistant may do. Remove access whenever you like — it stops at once.
You : What's my test balance?
xaalis_get_balance · read only
Claude : Your test balance: 0 F CFA available, no withdrawals in progress. I didn't create or change anything.
WhatsApp assistant for merchants: in testing, opening soon.
A REST API, SDKs and a plugin. What you can plug in today:
Create a payment
curl https://sandbox-api.xaalis.org/v1/payments \
-H "Authorization: Bearer $XAALIS_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: order-1042" \
-d '{"amount":15000,"description":"Commande #1042",
"client_reference":"order_1042",
"success_url":"https://shop.example/merci"}'Wave and Orange Money (the Max It app or an Orange Money QR code), on our hosted payment page.
As soon as the provider confirms a payment, its net amount is available and can be paid out.
With a payout to your Wave wallet, on demand or automatically every day from the dashboard. Orange Money payouts are coming soon.
No. Only a verified payment.succeeded webhook, or reading the payment from your server, proves payment.
Yes, in full, for Wave payments. The customer gets the gross amount back; by default the payment's Xaalis fee is still due.
Yes. Each period, the customer approves one payment from a link you send them. An instalment plan has 2 to 24 payments.
No. The CFA franc has no cents: 15000 means 15 000 F CFA. Amounts with decimals are rejected.
Open a test account: your payments go to a test wallet where you choose the outcome. A test key can never move real money.
We verify your business, the owner's identity and your Wave settlement wallet. Meanwhile, you integrate in test mode.
Open a test account, create a payment, watch the webhook arrive. To go live, we verify your business and your settlement wallet.
Boutique Awa · Dakar
TEST MODE
Order #1042
Amount15 000 F
Xaalis fee 1.5%− 225 F
Credited14 775 F
Paid withWave (test)
Statussucceeded
Ref.pay_8f3kq2…