Skip to main content

When wallet.low_balance is sent

Reeds Engineering
Reeds Engineering
Developer platform

The wallet.low_balance webhook now documents exactly when it is sent. Its payload is unchanged: balance, low_balance_threshold and currency.

  • It is sent once, by the debit that takes the balance to or below the threshold you set in the dashboard. A batch of bookings that crosses it sends one event, not one per booking.
  • It is not sent again until the balance has risen back to the threshold plus a margin (₦1,000 or 10% of the threshold, whichever is more) and fallen again, and at most once an hour. A small refund that lifts the balance just over the line doesn't count as recovering.
  • Changing the threshold re-arms it without sending one: the next debit at or below the new threshold sends it.
  • It is sent in test mode too, so you can test your handler. The email to the account's Owners and Admins goes in live mode only.

Nothing is removed or renamed.