TABLE OF CONTENTS


Quick Fix:


Log in to Blockonomics and open the Gap Limit Utility. Select your wallet from the Account dropdown, set the Gap Limit to 200, and click Save Changes. Then set the same value in your wallet app.

  • Important: Your wallet and Blockonomics must use the same Gap Limit value. If they don’t match, some payments may not show up in your wallet.


Using Electrum Wallet ?

  1. Open your Electrum wallet and switch to the Console tab.
    If the Console tab is not visible, enable it by going to View → Show Console from the top menu.
  2. In the console, enter the following command to set a new gap limit (you can use any number between 20 and 500):
    wallet.change_gap_limit(200)
    JavaScript
  3. Restart Electrum to apply the changes.
  4. To verify the new setting, reopen the Console and enter:
    wallet.gap_limit
    JavaScript
    The console should display the gap limit value you set earlier.


Which Error Are You Seeing?

Error: "You are creating too many addresses/orders with no real payments" or "Gap Limit Exceeded"


What's happening: Too many orders were created without actual payments usually from test orders, or bots auto-triggering your checkout.


Fix it:

  1. Add a CAPTCHA or bot protection on your checkout page to prevent automated order creation.
  2. Increase your gap limit to 200 using the Gap Limit Utility.
  3. Set the same gap limit value (200) inside your wallet. If your current wallet doesn't support custom gap limits, we recommend switching to Electrum.


Error: "Unavailable gap limit funds"


What's happening: This is usually a temporary issue that occurs if Blockonomics servers experience connectivity problems or momentarily lack funds to perform a small network transaction for automatic gap limit handling.


Fix it:

  1. Maintain at least 0.0005 BTC in your Blockonomics credit balance. Top up here → Billing Dashboard.
  2. Wait a few minutes and retry. This usually resolves on its own.
  3. If the error persists after topping up, contact support.


Frequently Asked Questions:


What is Gap Limit?

  • Bitcoin wallets scan ahead through a sequence of addresses to detect incoming payments.
  • However, wallets have a limit to how many unused addresses they can “look ahead” to check for incoming payments. This limit is called the Gap Limit.
  • If too many addresses go unused in a row, your wallet stops scanning and new payments may appear on the blockchain but not in your wallet.


What are Gap Limit fill-up Transactions ?

  • When around 20 consecutive addresses go unused, Blockonomics automatically sends a tiny fill-up transaction to keep your wallet in sync.
  • The small deduction is only the Bitcoin network fee, not a charge from Blockonomics. To keep this running smoothly, maintain at least 0.0005 BTC in your credit balance.


Which wallet works best for high-volume stores?

  • Electrum, because it supports custom gap limits. Most other wallets have a fixed gap limit that can't be adjusted. Set up Electrum Wallet →