If you followed the sections in order—from Introduction through the Express webhook guide—this matrix is still the quickest way back to green.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.
| 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 |
mint validate locally to catch stale MDX links after refactors.
Next: Changelog