Sandbox on request

Automate,
the money that repeats.

Collect by direct debit, pay bills and airtime, and receive a signed webhook for every outcome, so your product reacts without polling.

WHAT YOU GET

Built for careful money.

Direct debits

Collect from a customer's mandated account on the schedule you agree with them.

Bills and airtime

Pay electricity, TV, airtime and data from an account through one interface.

Signed webhooks

Every delivery is signed. Check the signature and the timestamp, and ignore anything else.

Delivered at least once

Retries follow a fixed schedule. Every event has an id, so a repeat is easy to ignore.

IN CODE

One request. A clear answer.

Both calls need an Idempotency-Key header, so a retry never collects or pays twice.

Direct debit request
POST /api/v1/automate/debit
Authorization: Bearer wk_test_...
Idempotency-Key: ajo-oct-ada

{
  "destination_account_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "amount_kobo": 5000000,
  "mandate_account_number": "0123455678",
  "mandate_bank_code": "058"
}
Bill payment request
POST /api/v1/automate/bill
Authorization: Bearer wk_test_...
Idempotency-Key: power-oct-ada

{
  "source_account_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "amount_kobo": 1850000,
  "biller_code": "IKEDC",
  "customer_reference": "45012345678"
}

HOW IT WORKS

Three moves.

Agree the mandate

Your customer agrees what you may collect, and how often.

Collect or pay

Create a direct debit or a bill payment when it falls due.

React to the event

A signed webhook tells your server how it ended.

WEBHOOKS

Told when it settles.

Each event is signed with HMAC SHA256 and carries an event id, so a repeat is easy to spot. Failed deliveries are retried six times over about a day.

WHO BUILDS WITH IT

Made for real products.

Ajo and savings groups

Collect each member's contribution on the day it is due.

Loan repayments

Take each instalment by direct debit, on schedule.

Bill reminders that pay

Turn a reminder into a paid bill in one step.

QUESTIONS

Clear answers.

Can I use this with real money today?

Not yet. Developers build against the sandbox, which uses simulated customers and money. Live access opens after regulatory approval and a banking partnership are in place.

How do I get sandbox access?

Tell us what you are building. We issue a test key for your organisation, and you can start calling the sandbox straight away.

How do I check a webhook is genuine?

Each delivery carries X-Wealtho-Signature, X-Wealtho-Timestamp and X-Wealtho-Event-Id headers. Recompute the signature over the timestamp and the raw body with your secret, and compare.

What does an error look like?

Every error has the same shape: a code, a message and a request id. Quote the request id when you contact us.

KEEP EXPLORING

Let the money repeat.
Start in the sandbox.

Money APIs are available in the sandbox on request. Live access depends on regulatory approval and a banking partnership.