TABLE OF CONTENTS

Quick Fix:


If using Electrum wallet ? (recommended)

       Step 1 — Update the gap limit in Electrum

  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
    JavaScriptStep 2 — Update the gap limit in Blockonomics
    The console should display the gap limit value you set earlier.

    Step 2 — Update the gap limit in Blockonomics
  5. 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.

  • 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.


If using any other wallet ?


Most wallets (Blockchain.com, Exodus, etc.) do not support changing the gap limit. 
The fix here is to reset your address sequence by switching to a fresh wallet:

  1. Open your wallet app and create a new wallet or account, this generates a new xpub with a clean address sequence.
  2. Log in to Blockonomics and go to the Wallets section.
  3. Click Add a Wallet and add the new xpub.
  4. Reconfigure your store to use the new wallet.
  5. Delete the old wallet from Blockonomics.

Note: Your funds in the old wallet are safe, removing it from Blockonomics only disconnects it from your store. 
You can still access your old wallet and funds from within your wallet app.

For high-volume stores: We recommend switching to Electrum with a gap limit of 200 as a long-term fix, since this issue is likely to recur otherwise.


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. Follow the Quick Fix steps above to increase your gap limit to 200.
  2. Add a CAPTCHA or bot protection on your checkout page to prevent automated order creation.
  3. If the error persists after increasing the gap limit, remove your existing wallet and re-add a new wallet in the Wallets section, then reconfigure it for your store.


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 →