Introduction

Wajub is a payment orchestration platform designed for Africa. Instead of integrating each Mobile Money operator, bank or aggregator separately, you integrate a single API — Wajub routes each transaction to the best available provider, handles failures and exposes standardized webhooks.

What you can build

• Collect payments via Mobile Money (MTN MoMo, Orange Money, Wave, Airtel), card and transfer.
• Pay out funds to Mobile Money wallets via API (Transfers) or in bulk (Push).
• Operate a marketplace with subaccounts and split payments (Sync).
• Orchestrate your providers intelligently with routing and fallback (Orchestration).

How the API works

The Wajub API is organized around REST. It uses predictable URLs, accepts JSON-encoded request bodies, returns JSON responses and relies on standard HTTP codes.

All requests go through a single base URL:

https://api.wajub.com

First call

Authenticate yourself with your public key (pk_test.… in sandbox) then initialize a transaction. Wajub returns a reference and a hosted payment URL.

curl https://api.wajub.com/payments \
-H "Authorization: pk_test.8f2b91c4d7e6a0f3" \
-H "Content-Type: application/json" \
-d '{
  "amount": 25000,
  "currency": "XAF",
  "customer": { "email": "amina@example.com" },
  "description": "Order #4172"
}'

{
"status": "Created",
"message": "Payment initialized",
"code": 201,
"transaction": {
  "id": "trx_01JXXXXXXXXXXXXX",
  "status": "pending",
  "amount": 25000,
  "currency": "XAF",
  "sandbox": true
},
"authorization_url": "https://pay.wajub.com/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}

Key objects

Next steps

• Quickstart — process a first payment end to end.
• Environments & keys — test vs production.
• Response structure — JSON envelope and errors.