WEALTHO INFRASTRUCTURE

Build with clarity.
Move with confidence.

Financial APIs for the products you build. Start with a test key today.
Accounts, payouts and verification in the sandbox.

SIX BUILDING BLOCKS

Use one. Or connect them all.

Each product has its own page with how it works and what it answers.

THE WAY IN

From an idea to a first request.

BUILT FOR DEVELOPERS

The details, done properly.

The same rules on every endpoint, so what you learn once works everywhere.

Safe retries

Send an Idempotency-Key with every payment. A retry returns the first result, never a second payment.

Signed webhooks

Every event is signed with HMAC SHA256 and retried six times over about a day.

One error shape

A code, a message and a request id, on every endpoint, every time.

Test and live keys

Test keys are free and yours in a minute. Live keys come through our team.

WHO BUILDS ON IT

Made for Nigerian products.

Payroll and HR

Work out PAYE, verify each employee, then pay them.

Savings apps

An account per saver, with every naira traced.

Marketplaces

Collect from buyers and settle sellers safely.

Accounting software

Add Nigerian tax with the working attached.

BUILT FOR CAREFUL WORK

Know what happened with every request.

  • Safe retries. Send the same idempotency key again and you get the first result back, never a second payment.
  • Clear outcomes. Every payment ends in success or failure. Pending is shown as pending.
  • Signed events. Each webhook carries a signature and an event id, so repeats are easy to ignore.
curl "$WEALTHO_SANDBOX/api/v1/pay" \
  -H "Authorization: Bearer wk_test_..." \
  -H "Idempotency-Key: order-2048" \
  -d '{ "source_account_id": "acc_main",
        "amount_kobo": 15000000,
        "counterparty_bank_code": "058",
        "counterparty_account_number": "0123456789" }'

QUESTIONS

Clear answers.

Can I use the Tax API today?

Yes. Create an account, make a test key and call it from your server. For live use, talk to us.

Can my product move real money through these APIs?

Not yet. The money APIs run in a sandbox with simulated customers and money. Live access opens after regulatory approval and a banking partnership.

How do I get a live key?

Contact us. We agree pricing with you, then switch on live access for your account.

Where are the request and response details?

In the documentation inside your console, with a full API reference and an OpenAPI schema.

Start with a test key.
Build from there.