Direct debits
Collect from a customer's mandated account on the schedule you agree with them.
Sandbox on request
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
Collect from a customer's mandated account on the schedule you agree with them.
Pay electricity, TV, airtime and data from an account through one interface.
Every delivery is signed. Check the signature and the timestamp, and ignore anything else.
Retries follow a fixed schedule. Every event has an id, so a repeat is easy to ignore.
IN CODE
Both calls need an Idempotency-Key header, so a retry never collects or pays twice.
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"
} 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
Your customer agrees what you may collect, and how often.
Create a direct debit or a bill payment when it falls due.
A signed webhook tells your server how it ended.
WEBHOOKS
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.
direct_debit.succeededThe money was collected.direct_debit.failedThe collection did not go through.bill_payment.succeededThe bill is paid.bill_payment.failedThe bill payment did not go through.WHO BUILDS WITH IT
Collect each member's contribution on the day it is due.
Take each instalment by direct debit, on schedule.
Turn a reminder into a paid bill in one step.
QUESTIONS
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.
Tell us what you are building. We issue a test key for your organisation, and you can start calling the sandbox straight away.
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.
Every error has the same shape: a code, a message and a request id. Quote the request id when you contact us.
KEEP EXPLORING
Money APIs are available in the sandbox on request. Live access depends on regulatory approval and a banking partnership.