wallet.insufficient_funds

Summary

wallet.insufficient_funds is returned when a debit operation (number claim, storage tier upgrade, call billing, etc.) would exceed the current wallet balance. The operation is not performed. This error is not retryable until the wallet balance is replenished.

Cause

The wallet balance is lower than the amount required by the requested operation.

Resolution

Top up the wallet via the top-up flow, then retry the operation. Configure a wallet.low_balance webhook subscription to get early warning before funds run out.

Example response

{
  "error": {
    "code": "wallet.insufficient_funds",
    "message": "insufficient wallet balance",
    "request_id": "req_01900000abc"
  }
}

Next steps

• See Wallet API for top-up options.
• Subscribe to wallet.low_balance via Webhooks API for proactive alerts.