Have you received an Error Code when using your Blockonomics Payment Button or Blockonomics Payment URL?

Below is a list containing all the Blockonomics Error Codes with solutions to resolve each issue.


Captcha failed 

Try using another browser or incognito mode


This requires you to add an XPUB to your wallet watcher

Goto Merchants and link your bitcoin wallet to your Blockonomics account


You have multiple XPUBs in your wallet watcher

To set up multiple websites follow the instructions in this article


Could not find a matching XPUB

From Merchants, check your XPUB and Callback URL are set up correctly. Click on Generate Button/Url from the Merchants' tab > Payment Buttons/URLs.


You are banned from using Blockonomics. Please contact support for clarification

Contact support for clarification.


Your merchant account is disabled due to low balance

To view your balance and add credit to your account visit the Blockonomics Payment Fee page. Your account will be automatically activated when the outstanding balance has been paid.


Gap limit exceeded

Most of the time this is a temporary error and you can ignore. Visit this article if you are still facing issues



Cannot fill gap limit for guest user. Please use a real emailid

Sign up for Blockonomics using your own email address.


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

Consult this article


Gap Limit Error: Unavailable gap limit funds

Consult this article


Invalid API parameter

One of the API parameters is invalid. See complete error message from server to identify for fix


Please pay pending fee on existing blockonomics accounts. Avoid creating duplicate accounts

Use fee tab to pay pending fee. Avoid creating multiple accounts for same website/domain

1012 - 1015

Internal Errors


Couldn't find addr in Xpub

This means destination address hasn't been registered as part of the store/account  you are testing. Do a checkout on your store to get a correct destination address

Having trouble resolving any of these issues? Feel free to contact our technical support for assistance.