> ## Documentation Index
> Fetch the complete documentation index at: https://blockonomics.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Find and fix the most common Blockonomics issues.

## Start here

Use the table below to find the right article for your problem.

| Symptom                                      | Article                                                     |
| -------------------------------------------- | ----------------------------------------------------------- |
| Order not marked as Paid after customer pays | [Callbacks failing →](/troubleshooting/callbacks-failing)   |
| Error code on checkout or in logs            | [Error code guide →](/troubleshooting/error-codes)          |
| "Unable to generate new address" error       | [Address generation →](/troubleshooting/address-generation) |
| Gap limit errors (1006, 1008, 1009)          | [Gap limit FAQ →](/troubleshooting/gap-limit)               |
| Payment received but not showing in orders   | [Missing funds →](/troubleshooting/missing-funds)           |
| Test Setup fails with a red error            | [Callbacks failing →](/troubleshooting/callbacks-failing)   |

***

## Most common issues

<CardGroup cols={2}>
  <Card title="Error code guide" icon="triangle-exclamation" href="/troubleshooting/error-codes">
    Full reference for all Blockonomics error codes 1000–1014, with fixes for each.
  </Card>

  <Card title="Callbacks failing" icon="webhook" href="/troubleshooting/callbacks-failing">
    Why order status doesn't update after payment — and how to fix DDoS protection blocking our callbacks.
  </Card>

  <Card title="Gap limit FAQ" icon="list-ol" href="/troubleshooting/gap-limit">
    What the gap limit is, why you're hitting it, and how to resolve it.
  </Card>

  <Card title="Missing funds" icon="magnifying-glass-dollar" href="/troubleshooting/missing-funds">
    How to find payments that arrived but aren't showing up correctly.
  </Card>
</CardGroup>

***

## Still stuck?

If none of the articles above resolve your issue, you can:

* Search the [Community Forum](https://community.blockonomics.co) — many issues have been solved there
* [Open a support ticket](https://blockonomics.freshdesk.com/support/tickets/new) with your error details, tx IDs, and screenshots