Every business on AgroYield Network now has its own wallet. You top it up by transferring money into a dedicated bank account at Monnify (our payments partner), the credit lands in your wallet within seconds, and any payouts you approve from /business/payouts (payroll runs, supplier payments, refunds) debit the wallet directly. This replaces the older model where every payout came out of the platform's central wallet.
Why your business has its own wallet
Three reasons. First, you can see exactly what's in your wallet at any time — no guessing whether a payout will go through. Second, payouts come out of your money, not ours, so they're not subject to platform-wide caps. Third, the ledger is auditable end-to-end (every credit + debit shows the source, reference, and balance after) so you can reconcile against your bank statement without spreadsheets.
How to top up
Open /business/payouts. The wallet card at the top shows your dedicated Monnify account number + the bank name. Copy the account number. From your business bank app (Zenith, OPay, Moniepoint, Access, or any other Nigerian bank), transfer any amount to that account. The credit will appear in your wallet within seconds — Monnify webhooks notify us the moment the transfer arrives.
The minimum useful top-up depends on what you're paying out. For a single ₦20,000 payroll item, top up ₦20,010 (₦10 covers the Monnify gateway fee). For a payroll batch of ten staff at ₦50,000 each, top up ₦500,100. We recommend keeping a small buffer (~₦500) so single-payout fees don't leave you short of the next disburse.
When can I disburse what I just topped up?
The wallet card shows two figures: Available to disburse (the big number — funds you can send out right now) and Pending settlement (a smaller amber line — funds we've received but that Monnify hasn't released into the disbursable pool yet).
Top-ups land in "Pending settlement" first, then clear to "Available" once Monnify settles the inflow into our central account. Settlement timing follows Monnify's schedule, not ours:
- Top up before 4pm WAT — clears by 4–5pm WAT the same day
- Top up after 4pm WAT — clears the next business morning, typically by 11am WAT
- Worst case — T+1 next business day
In practice that means a morning top-up is disbursable by close of business; an evening top-up is disbursable by mid-morning the next day. The wallet card shows an estimate ("clears by 4–5pm WAT today" / "clears tomorrow morning") next to the pending number so you know when to come back.
Why does this matter? Before we shipped this honest split, the wallet card showed your full top-up as "available" the moment we received the transfer, even though Monnify hadn't released the funds for disbursement yet. If you ran payroll against funds that were still settling, every transfer in the batch came back FAILED with no useful explanation. Now the wallet card tells you the truth: what's available right now vs what's still settling. The Approve button also runs a live check against the payment processor's central balance before firing any disbursement, so you'll never accidentally fire a payout against pending funds.
Reading your ledger
The collapsible ledger view below the wallet card shows the last 50 transactions. Each row is one of:
- Top-up credit — money you transferred in from your bank (marked "pending settlement" until Monnify clears it)
- Settlement — pending funds moving into the disbursable pool (shown with an ⇄ glyph and amber colour; happens automatically when Monnify releases the inflow)
- Payout debit — a disbursement that successfully left your wallet
- Refund credit — automatic compensation when a payout failed at the bank's side (we credit you back the moment Monnify confirms the rail rejected the transfer; refunds skip the pending step and land straight in available)
Every row shows the date, direction (credit or debit), amount in naira, balance after the transaction, the source (e.g. "payroll", "monnify_topup"), and a reference you can match to your bank statement.
What happens when a payout fails
Sometimes a payout fails at the bank's end (wrong account number, account closed, bank-side outage). When that happens, Monnify sends us a "failed disbursement" webhook within seconds. Our handler automatically credits the failed amount back to your wallet — you never have to chase it. The original debit and the refund credit both stay on the ledger so the audit trail is complete.
If the gateway fee was charged, Monnify usually auto-reverses it too (check the ACCOUNT_ACTIVITY events on your Monnify dashboard for the _RVSL confirmation). On the rare occasions where the fee isn't reversed, our reconciliation tile flags the discrepancy so we can chase it.
What about the platform commission
Your wallet handles your business's payouts — the money YOU send to staff, suppliers, refunds. It doesn't touch the platform commission AgroYield charges on marketplace sales (that's still handled separately in your seller payouts). The two are completely independent.
If you own more than one business
Each business gets its own wallet — separate NUBAN, separate balance, separate ledger. When you switch the active business at the top of the app, the wallet card on /business/payouts switches with it, so you're always topping up and disbursing from the right wallet.
Behind the scenes, each business has its own Monnify customer slot keyed off the business itself (not your personal email), so there's no cap on how many businesses one operator can run. Top one up, leave the other empty — they don't share funds, and a payout from one business never accidentally pulls from another.
Troubleshooting
- Wallet card says "Provision wallet" — click it once. Provisioning takes ~5 seconds (we call Monnify's reserved-account API). After that, the account number is permanent.
- Top-up doesn't appear — give it 30 seconds, then refresh. If still missing, check your bank app to confirm the transfer landed on the right account number (a typo on the receiving account is the most common cause).
- "Insufficient funds" error on payout — check the wallet balance. Each disburse costs ₦10 in Monnify gateway fee; a payout of ₦20,000 needs ₦20,010 in the wallet. The error message tells you the exact shortfall.
- "Insufficient settled balance" error — you have enough money in the wallet, but some or all of it is still in "Pending settlement". Wait until the pending pill clears (the wallet card shows the estimated time), then try Approve again.
- "Payment processor's central wallet not yet settled" error on Approve — same root cause as above, but the live check at the payment processor side caught it. Funds typically clear by 4–5pm WAT same day. The batch stays in draft so you can re-approve once settlement lands.
For anything not in this list, open a ticket via the Yield AI widget on the bottom-right of any page.