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

# Troubleshooting

> Common integration errors across @unseen_fi/sdk and @unseen_fi/ui.

If you followed the sections in order—from [Introduction](/index) through the [Express webhook guide](/guides/webhooks-express)—this matrix is still the quickest way back to green.

| Symptom                                              | Likely cause                                | Fix                                                               |
| ---------------------------------------------------- | ------------------------------------------- | ----------------------------------------------------------------- |
| `useUnseenConfig must be used inside UnseenProvider` | Hook outside wrapper                        | Wrap in `<UnseenProvider>`.                                       |
| `UnseenProvider apiKey is required ...`              | Browser tries to create payment without key | Pass `createPaymentSession` or set `apiKey` for non-prod only.    |
| `Missing apiKey for merchant verify...`              | Public verify without `paymentToken`        | Ensure API returns `paymentToken` and pass to `verify`.           |
| Webhook verify always false                          | Using parsed JSON vs raw bytes              | Use `express.raw` / equivalent and verify before `express.json()` |
| Confirmation stuck polling                           | Blockchain delay / insufficient fee         | Extend server-side retry windows; rely on webhooks                |

Run `mint validate` locally to catch stale MDX links after refactors.

**Next:** [Changelog](/changelog)